Twitterapi MCP server
online · 100% uptimeio.twitterapi/mcp-server·v1.0.0·1 starsOfficial twitterapi.io hosted MCP: Twitter/X tweets, users, followers, trends. OAuth or API key.
1 stars
Reviews
Write oneNobody has reviewed Twitterapi yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Twitterapi tools (12)
write = sends, deletes, buys or postsget_trendsFreeFetch current trending topics/hashtags for a location. Pass a Yahoo Where-On-Earth ID (woeid). Common: 1=Worldwide, 23424977=USA, 23424975=UK, 23424856=Japan, 23424848=India, 23424881=South Korea. Use woeid=1 for global trends if you don't know a specific location.
get_tweet_quotesFreeFetch quote-tweets (tweets that quote the given tweetId). Useful for finding commentary on a tweet, measuring reach beyond direct replies. Supports time bounds (sinceTime/untilTime, Unix seconds). Paginates via cursor (~20 per page).
get_tweet_repliesFreeFetch replies to a specific tweet. Pass the numeric tweetId of the root tweet; returns top-level replies (about 20 per page) with full tweet objects. Use this for thread analysis, sentiment on a viral post, or building reply trees.
get_tweet_retweetersFreeFetch users who retweeted a specific tweet (the simple 'retweet' action, not quote-tweets — for those use get_tweet_quotes). Returns user profiles with metadata. Paginates via cursor (~100 per page).
get_tweets_by_idsFreeBatch-fetch full tweet objects by their numeric tweet IDs. Pass a comma-separated string of up to 100 IDs. Use this when you already have specific tweet IDs (e.g., from a search result, a URL, or a webhook event) and need the full tweet data — author, text, engagement counts, media, etc.
get_user_aboutFreeFetch the extended 'about' / profile page data for a Twitter/X user by screen name. Returns extra profile metadata beyond what get_user_info gives (when available). Use get_user_info first; only call this if you need additional about-page fields.
get_user_followersFreeFetch followers of a Twitter/X user in reverse chronological order (newest first), each with full profile metadata (name, bio, follower count, verified status, etc.). Paginates via cursor. Use this to analyze who follows an account, build follower audiences, or sample for competitive analysis. For large accounts use pagination; you will not get all followers in one call.
get_user_followingsFreeFetch the accounts a Twitter/X user follows, with full profile metadata. Paginates via cursor. Use this to map a user's interest graph (who they follow signals what they care about).
get_user_infoFreeFetch basic profile info for a Twitter/X user by their screen name (handle). Returns user ID, display name, bio, follower/following counts, verified status, profile picture, banner, location, website, and account creation date. Use this as the starting point for any user analysis.
get_user_last_tweetsFree⚠️ ONLY for 'latest / recent / what's new' queries about a user. DO NOT use for date-range queries (e.g. 'tweets from January 2026', 'tweets last week', 'tweets between X and Y', 'tweets in 2025'). For specific dates / older tweets, use **search_tweets** with query like 'from:elonmusk since:2026-01-01 until:2026-02-01'. Fetch the MOST RECENT tweets posted by a Twitter/X user, sorted by created_at descending (newest first). Provide EITHER userName (screen name, no @) OR userId (numeric). Use userId when known — handles can change. Set includeReplies=true to include the user's reply tweets in addition to top-level tweets. Paginates via cursor (~20 per page).
get_user_mentionsFreeFetch tweets that mention a specific Twitter/X user (i.e. tweets containing @userName). Useful for brand monitoring, sentiment tracking on a public figure, or finding conversations involving an account. Supports time-bound queries via sinceTime/untilTime (Unix seconds). Paginates via cursor.
search_tweetsFree🎯 PRIMARY CHOICE for date-range / historical / keyword-based tweet queries. Use this (NOT get_user_last_tweets) whenever user asks about a SPECIFIC TIME RANGE or historical tweets: • 'tweets from January 2026' → query='from:elonmusk since:2026-01-01 until:2026-02-01' • 'tweets between X and Y' → 'from:USER since:X until:Y' • 'tweets last week / last month' → translate to since:/until: dates • 'tweets containing keyword X by user Y' → 'from:Y X' • 'older tweets' / 'archive' / 'in 2025' → use date range, not pagination Date format: YYYY-MM-DD (UTC midnight). 'until:' is exclusive (until:2026-02-01 = up to Jan 31). General: Search Twitter/X for tweets matching a query. Supports the full Twitter advanced search syntax (from:, to:, since:, until:, lang:, filter:, has:, -, OR, etc). Returns ~20 tweets per page in reverse chronological order ('Latest') or by engagement ('Top'). Use this for keyword research, monitoring mentions of a brand/topic, finding tweets in a date range, or any open-ended tweet discovery.
Public scan report
scanner v0.1.10 · 2026-10-14 · same rubric, same numbers if you re-run it
- –Code scanremote-only server, no package to scann/a
- Live reliabilityremote reachable in 307ms20/20
- Tool poisoning12 tool descriptions checked15/15
- Auth qualityopen endpoint, read-only tools10/15
- Maintenancelast push 6 days ago15/15
- Maintainer identityendpoint served from the registry-verified namespace domain8/10
How Twitterapi compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 91/100
- higher than 85% of 48,273 servers
- Tools
- 12
- the typical server has 7
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- Uptime
- 100%
- of our recent checks; the typical remote server answers 100%
- Response time
- 20 ms
- faster than 97% of 30,037 servers
- GitHub stars
- 1
- more than 65% of 28,534 servers
What its tools let an agent do: 12 read
Install Twitterapi in Claude Code, Cursor or VS Code
claude mcp add --transport http mcp-server https://mcp.twitterapi.io/v1/mcp
What the publisher says
From the Twitterapi repository's README, as published. We do not edit it. Read it on GitHub
twitterapi.io MCP Server
Official Model Context Protocol server for twitterapi.io — Twitter / X data API for AI agents and applications.
Connect Claude Desktop, Cursor, VS Code Copilot, or any MCP client to twitterapi.io and search tweets, fetch user profiles, get followers, replies, trends, and more — all from natural language.
Features
12 read-only tools mapped 1:1 to twitterapi.io's verified production endpoints:
Quick Start
1. Get an API key
Sign up at twitterapi.io — free tier available.
2. Configure your MCP client
Claude Desktop
Edit ~/Library/Application Support/Claude/claudedesktopconfig.json (macOS) or %APPDATA%\Claude\claudedesktopconfig.json (Windows):
{
"mcpServers": {
"twitterapi-io": {
"command": "npx",
"args": ["-y", "@twitterapi_io/mcp-server"],
"env": {
"TWITTERAPI_IO_API_KEY": "your_key_here"
}
}
}
}Restart Claude Desktop. The 12 tools will be available in any chat — Claude will pick the right one based on your prompt.
Cursor
Open Settings → MCP → Add new MCP Server:
{
"mcpServers": {
"twitterapi-io": {
"command": "npx",
"args": ["-y", "@twitterapi_io/mcp-server"],
"env": {
"TWITTERAPI_IO_API_KEY": "your_key_here"
}
}
}
}VS Code (Copilot Chat with MCP)
Add to your MCP servers config — same shape as Claude Desktop / Cursor.
Claude Code
claude mcp add twitterapi-io npx -- -y @twitterapi_io/mcp-server -e TWITTERAPI_IO_API_KEY=your_key_here3. Use it
In any MCP-enabled chat:
"Find recent tweets from @elonmusk about AI in the last week"
"Get the follower list of @sama and show me the top 20 by follower count"
"What are the current trending topics in Japan?"
Claude (or your client) will automatically pick searchtweets / getuserfollowers / gettrends and call them with the right parameters.
Authentication
Authentication is via the TWITTERAPIIOAPIKEY environment variable, injected by your MCP client. The server never** stores or logs the key. Each tool call sends the key in the X-API-Key header to https://api.twitterapi.io.
Pagination
Tools that return lists (followers, replies, search results, etc.) return a next_cursor field. Pass it back as the cursor argument on the next call to page through. Each page is typically ~20 items.
Error handling
- 429 / 5xx responses are automatically retried with exponential backoff (3 attempts, 1s/2s/4s)
- Network timeouts: 30s per request
- 4xx errors (other than 429) surface immediately to the LLM with the original message
Tools — full spec
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Twitterapi: common questions
- Is Twitterapi MCP server safe?
- Yes, by our scan: it is graded A (91/100). Read the Twitterapi safety report
- How do I install Twitterapi?
- It runs remotely at mcp.twitterapi.io. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
- Does Twitterapi need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Twitterapi maintained?
- The last commit was 26 days ago (2026-10-07). The latest release is v1.0.0.
- Is Twitterapi up?
- 100% of our last 28 checks got an answer. We check remote servers about four times a day.
- How does Twitterapi compare with other MCP servers?
- safety score 91/100 (higher than 85% of 48,273 servers); tools 12 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.