mcp-server
Server Details
Official twitterapi.io hosted MCP: Twitter/X tweets, users, followers, trends. OAuth or API key.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-06-18
- URL
- Server Listing
- twitterapi-io-mcp-server
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 12 tools
Tools mostly target distinct resource+action pairs, and the descriptions aggressively route the agent (e.g. get_user_last_tweets vs search_tweets, get_user_info vs get_user_about, quotes vs retweeters) so overlaps are resolved rather than hidden. The one soft boundary is get_user_mentions vs search_tweets with an @handle query, and get_user_about is a faint shadow of get_user_info, but neither is likely to cause misselection.
Almost everything is snake_case with a get_/search_ verb prefix and a clear object (get_tweet_replies, get_user_followers, search_tweets). Minor deviations: get_trends lacks an object noun (no 'topics'/'hashtags'), and singular get_tweet_* coexists with plural get_tweets_by_ids, but the pattern is still predictable.
Twelve tools is well within the sweet spot and each maps to a real Twitter/X read endpoint (trends, tweet lookups, replies/quotes/retweeters, user profile/followers/followings/mentions/timeline, search). Nothing looks padded or redundant.
As a read-only X analytics surface it covers user profiles, graph edges, timelines, mentions, trends, and rich tweet search with advanced syntax, so core discovery workflows are closed. Gaps remain for engagement-side data (likers, thread/conversation reconstruction, user lookup by ID, user search), though most are workaroundable via search_tweets filters.
Available Tools
12 toolsget_trendsGet Trending TopicsARead-onlyInspect
Fetch 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.
Inputs: woeid (required), count.
get_tweet_quotesGet Tweet QuotesARead-onlyInspect
Fetch 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).
Inputs: tweetId (required), cursor, sinceTime, untilTime, +1 more.
get_tweet_repliesGet Tweet RepliesARead-onlyInspect
Fetch 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.
Inputs: tweetId (required), cursor, queryType.
get_tweet_retweetersGet Tweet RetweetersARead-onlyInspect
Fetch 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 (~20 per page).
Inputs: tweetId (required), cursor.
get_tweets_by_idsBatch Get Tweets by IDsARead-onlyInspect
Batch-fetch full tweet objects by their numeric tweet IDs. Pass a comma-separated string of up to 50 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.
Inputs: tweet_ids (required).
get_user_aboutGet User About PageARead-onlyInspect
Fetch 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.
Inputs: userName (required).
get_user_followersGet User FollowersARead-onlyInspect
Fetch 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.
Inputs: userName (required), cursor, pageSize.
get_user_followingsGet User FollowingsARead-onlyInspect
Fetch 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).
Inputs: userName (required), cursor, pageSize.
get_user_infoGet User ProfileARead-onlyInspect
Fetch 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.
Inputs: userName (required).
get_user_last_tweetsGet User's Recent TweetsARead-onlyInspect
⚠️ 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).
Inputs: cursor, userId, userName, includeReplies.
get_user_mentionsGet Mentions of a UserARead-onlyInspect
Fetch 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.
Inputs: userName (required), cursor, sinceTime, untilTime.
search_tweetsSearch TweetsARead-onlyInspect
🎯 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.
Inputs: query (required), queryType (required), cursor.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Hosted MCP server from TwitterAPI.io that gives AI agents read-only access to Twitter/X data. 12 tools: tweet search with X operators, user profiles, a user's latest tweets, followers and followings, replies, quotes, retweeters, mentions and trends. Connect at https://mcp.twitterapi.io/mcp with a TwitterAPI.io API key or account sign-in; usage is paid per result returned.
Official MCP server for twitterapis.com. Twitter/X search, users, DMs, Grok, monitoring and writes.
Twitter: Access real-time Twitter/X data as soon as it's posted! With the Twitter/X AIO API, you.
Hosted X (Twitter) MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Related MCP Servers
- AlicenseAqualityBmaintenanceMCP server for the Twitter/X API, enabling search, user profiles, tweets, followers, and more via natural language.941,114 npm6MIT
- AlicenseAqualityBmaintenanceMCP server to read X (Twitter) posts, threads, replies, quotes, and search using your own logged-in session, no API key required.8206 PyPI4MIT
- AlicenseBqualityDmaintenanceAn MCP server that provides access to Twitter data and write actions through TwitterAPI.io, bypassing the need for a standard Twitter developer account. It enables users to search tweets, retrieve profiles, and post content with support for pagination and enterprise proxy configurations.13 npmMIT
- AlicenseAqualityAmaintenanceReal-time X (Twitter) data platform with 2 MCP tools covering 120+ REST API endpoints. Search tweets, look up users, get timelines, extract followers/likes/retweets in bulk, monitor accounts, run giveaway draws, and perform write actions (tweet, like, retweet, follow, DM). OAuth 2.1 authentication with PKCE.2796 npm229MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.