TwittrAPI

Solutions · MCP server

Twitter (X) MCP server

Let Claude, ChatGPT, Cursor or VS Code read X: tweets, profiles, replies, search, followers, lists, communities and trends. Connect by URL, nothing to install, no X developer account. Every tool call is one API call, $0.065 to $0.10 per 1,000.

Get an API keySetup guide →
$0.50 free credit after sign-up.

Connect

Add it to your AI app in a minute

Paste the URL, sign in with your TwittrAPI account and click Allow access. Apps that let you set headers can send your API key instead.

MCP server URL, with /mcp at the end
https://mcp.twittrapi.com/mcp

Tools

23 read-only tools

The same tools on the hosted server and in the open-source package. Each page of results is one call.

  • Profiles

    get_user_by_username · get_user_by_id · users_by_ids · username_to_id

    Bio, counts, verification and creation date; up to 500 profiles per call

    4 tools

  • Tweets

    get_user_tweets · get_user_tweets_and_replies · get_user_media · get_tweet

    Timelines, one tweet with its replies

    4 tools

  • Search

    search_tweets

    Every X search operator: from:, lang:, since:, min_faves: and more

    1 tool

  • Engagement

    get_tweet_quotes · get_tweet_retweets · get_tweet_favorites

    Who quoted, retweeted or liked a post

    3 tools

  • Followers

    get_followers · get_following · get_verified_followers

    One page per call

    3 tools

  • Lists

    get_list_details · get_list_members · get_list_tweets

    A list's members and its timeline

    3 tools

  • Communities

    search_communities · get_community · get_community_tweets

    Find a community and read its posts

    3 tools

  • Trends

    get_trend_locations · get_trends

    Trending topics worldwide or by country and city

    2 tools

Public data only: protected accounts and deleted tweets are never returned. Arguments and output of every tool: twittrapi-mcp.

In practice

What you can ask

Plain questions in the chat. The assistant picks the tools.

  • What has @XDevelopers announced this month? Cite the tweets.

    get_user_tweets

    1–2 calls

  • Find complaints about our checkout from the last 3 days and group them by problem.

    search_tweets

    1 call per page

  • Summarize the replies under this tweet.

    get_tweet

    1 call per page of replies

  • Which of these 80 accounts are verified and have over 10k followers?

    users_by_ids

    1 call

  • What is trending in Japan right now?

    get_trend_locations → get_trends

    2 calls

  • Compare how our last 20 posts did against a competitor's.

    get_user_tweets × 2

    2 calls

Cost

One tool call is one API call

No monthly fee for the server. Calls are billed to your balance at your normal price; calls that fail with 400, 407, 408, 409 or a 5xx error are refunded, and 429 is not charged.

  • A 402 (balance used up) or 429 (slow down) comes back as a readable tool error, so the assistant can tell you.
  • Every tool caps its output, and the cursor for the next page always survives the cut.
  • Disconnect an app in the dashboard under Connected apps; access ends within a minute.

Standard

$0.10per 1,000 calls

1,000 tool calls
$0.10
100,000 tool calls
$10.00

Volume

$0.09per 1,000 calls

1,000 tool calls
$0.09
100,000 tool calls
$9.00

Scale

$0.08per 1,000 calls

1,000 tool calls
$0.08
100,000 tool calls
$8.00

Bulk

$0.065per 1,000 calls

1,000 tool calls
$0.07
100,000 tool calls
$6.50

New accounts get $0.50 free credit, about 5,000 calls at Standard. Pricing

FAQ

MCP server questions

What is an MCP server?

MCP (Model Context Protocol) is the standard way for AI apps to call outside tools. An MCP server for X gives Claude, ChatGPT or Cursor tools like search_tweets or get_user_tweets, so the assistant can read X itself instead of you pasting tweets into the chat.

Do I need an X developer account or an X login?

No. You sign in with your TwittrAPI account, or send your TwittrAPI API key in a header. No X developer app, no X login.

Can the assistant post, like or send DMs?

Not with the hosted server: all 23 tools are read-only. The local server adds account tools when you give it the X session of the account it should act for, and your MCP client asks before each write. See AI agents that post (/use-cases/agents-that-post).

Which apps work?

Claude.ai, Claude Desktop and ChatGPT as a custom connector, Claude Code, Cursor and VS Code in their MCP settings, and any client that speaks MCP over Streamable HTTP. Clients that only start local servers use the open-source package.

What does it cost?

Every tool call is one API call on your balance, $0.065 to $0.10 per 1,000 depending on your tier. There is no monthly fee for the server. New accounts get $0.50 free credit.

Why are the answers so small?

The tools return the simple format: flat JSON with the same fields every time, about 61 % fewer input tokens than X's raw JSON. That leaves more of the context window for the conversation. Raw JSON is one argument away when you need cards, polls or community notes.

Can my whole team use it?

Yes. Each person connects with their own TwittrAPI account and pays from their own balance. To run your own instance inside a company network, the open-source server has an HTTP mode that uses the caller's key on every request.

Related

Read next

Ask your assistant about X today

Get a key, add the URL to your AI app and ask your first question. New accounts start with $0.50 free credit.

Get an API keySetup guide →