Twitterapi Io Mcp Server

What is Twitterapi Io Mcp Server?

Official Model Context Protocol server for twitterapi.io, a Twitter/X data API. It connects Claude Desktop, Cursor, VS Code Copilot, or any MCP client to 12 read-only tools for searching tweets, fetching user profiles, followers, replies, trends, and more using natural language.

How to use Twitterapi Io Mcp Server?

Get a free API key from twitterapi.io, then configure your MCP client (Claude Desktop, Cursor, VS Code, Claude Code) by adding a JSON block with npx -y @twitterapi_io/mcp-server and the TWITTERAPI_IO_API_KEY environment variable. Once configured, use natural language prompts in any MCP-enabled chat — the client automatically selects the right tool.

Key features of Twitterapi Io Mcp Server

• 12 read-only tools mapped to twitterapi.io’s verified endpoints.
• Advanced search with Twitter operators (from:, since:, lang:, etc.).
• Paginated results via next_cursor field.
• Automatic retry with exponential backoff on 429/5xx errors.
• 30-second network timeout per request.

Use cases of Twitterapi Io Mcp Server

• Search recent tweets with complex operators.
• Get detailed user profiles and about pages.
• Fetch followers and followings with full metadata.
• Retrieve replies, quotes, retweeters, and mentions.
• Discover trending topics by location (WOEID).

FAQ from Twitterapi Io Mcp Server

What tools does Twitterapi Io Mcp Server provide?

Twelve tools: search_tweets, get_user_info, get_user_about, get_user_followers, get_user_followings, get_user_last_tweets, get_user_mentions, get_tweets_by_ids, get_tweet_replies, get_tweet_quotes, get_tweet_retweeters, and get_trends.

How is authentication handled?

Authentication uses the TWITTERAPI_IO_API_KEY environment variable. The server never stores or logs the key; each tool call sends it in the X-API-Key header to https://api.twitterapi.io.

Does Twitterapi Io Mcp Server support pagination?

Yes. Tools that return lists include a next_cursor field. Pass it as the cursor argument on the next call to page through results (typically ~20 items per page).

What transport does Twitterapi Io Mcp Server use?

Currently uses stdio transport. Streamable HTTP is planned for v0.2+ for remote/hosted use.

Does Twitterapi Io Mcp Server allow writing (posting tweets, etc.)?

No. The server is intentionally read-only to keep it safe for autonomous agent use. Write endpoints (posting tweets, likes, follows, DMs, etc.) are excluded.