Skip to Content
MCPToolsX Profile Posts

X Profile Posts

Give it an X profile, get back what that account has been posting.

Tool
x_profile_posts
Cost
0.4 credits
Category
X (Twitter)
Required input
profile_urlusername
Returns
Recent posts with content, engagement and timestamps

What it does

  • Returns recent posts authored by an X profile — post content, engagement and timestamps.
  • Takes either profile_url or username. Pass at least one. The handle goes in without the @.
  • max_posts sets how many posts come back — 1 to 100, default 10.
  • Cost is flat per call. Pulling 100 posts costs the same 0.4 credits as pulling 10.

It returns what the account published. It does not return the accounts that engaged with those posts — that is x_post_commenters.


Parameters

ParameterTypeRequiredNotes
profile_urlstringOne of the twoFull X profile URL
usernamestringOne of the twoHandle without @
max_postsnumberNo1–100, default 10

How to use it

Connect the MCP server

Follow the setup guide for your client. Browser sign-in, no API key.

Pull one profile

Get the last 20 posts from the X profile @stripe.

Read the account before you write

Pull the last 30 posts from @janedoe and summarise the three themes she posts about most. Quote the exact wording of her two most-engaged posts.

Do the same across a list

For each of these 15 X handles, pull the last 10 posts and flag anyone who mentioned hiring, funding, or a product launch.

Example prompts

Ask your clientWhat you get back
”Last 20 posts from @janedoe”20 posts with content and engagement
”What has @stripe posted about this month?”Recent posts, summarised by theme
”Pull posts from these 15 handles and flag launch announcements”One post set per handle, filtered
”Who commented on this X post?”Not this tool — use x_post_commenters

Best prompting practices

  • Give the handle without the @ if you are passing username. Pass the full URL instead when you have it.
  • Set max_posts deliberately. The default is 10. Cost does not change with volume, so ask for more when you actually want the history.
  • Ask for a summary, not a dump. “Summarise the themes and quote the top two posts” gives you something usable in outreach; a raw list of 100 posts does not.
  • Name the tool when your client hesitates. “Use x_profile_posts” stops it reaching for a web search.
  • Cap the batch. “Stop after 25 profiles and report credits used” keeps a long list predictable.

Output

{ "username": "janedoe", "posts": [ { "text": "We just shipped self-serve onboarding.", "posted_at": "2026-07-28T09:12:00Z", "likes": 214, "reposts": 31 } ] }

Credits and limits

0.4 credits per call, whatever max_posts you set. Run check_credits (free) before a large batch.

Private and protected accounts return nothing. An empty result also happens on accounts that only repost and never author. Check the handle is spelled correctly before spending a second call on it.


ToolUse it instead when
x_profile_reactionsYou want per-post reaction totals with date and sort filters — 0.2 credits
x_post_commentersYou want the accounts that commented, not the posts
linkedin_profile_postsThe prospect is more active on LinkedIn
instagram_profile_postsYou need Instagram content instead

Next steps


Keep learning

Two courses take these tools past the reference page — clustered by GTM job, then chained into workflows.