MCP SERVERSearch X and read profiles, followers, replies, quotes and trends in plain language, through twitterapi.io.
LABSCO SUMMARY
It covers what social research actually needs — operator search, follower graphs, the replies and quotes around a single post, trends by place — and stops there: nothing in the set can change anything on an account.
The official twitterapi.io server — twelve read-only tools mapped one to one onto that API's production endpoints. Every call is a live read of Twitter/X data, and nothing in the set writes.
npx and Node; the package is @twitterapi_io/mcp-server. A twitterapi.io API key, with a free tier available, passed as TWITTERAPI_IO_API_KEY. Read-only — none of the twelve tools posts, follows or deletes anything.
One command plus a key — npx -y @twitterapi_io/mcp-server, then supply credentials
USE CASES
Pull the replies, the quote-tweets and the retweeters of one tweet, which separates plain agreement from the commentary wrapped around it.
Search with operators for the phrasing you care about, and read the mentions of the account itself alongside it.
Profile basics, the extended about page and the recent timeline together — who they are and what they have actually been posting.
Walk the followers and the following list with full profile metadata, paging through with the cursor until you have the picture.
Trends for a WOEID, then a search on whichever term looks worth reading.
Batch up to 100 IDs into one call and get full tweet objects back, instead of fetching them one at a time.
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
get_trendsFetch 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_quotesFetch 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_repliesFetch 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_retweetersFetch 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_idsBatch-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_aboutFetch 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_followersFetch 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_followingsFetch 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_infoFetch 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_tweetsFetch the most recent tweets posted by a Twitter/X user, sorted by created_at descending. 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.
get_user_mentionsFetch 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_tweetsSearch 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.
BEFORE YOU INSTALL
12 tools when we connected. All tools read; posting, likes, follows, DMs and media upload are intentionally excluded, so writes need the REST API. A hosted endpoint at mcp.twitterapi.io/mcp is declared alongside stdio.
All 4 documented clients run the server on your machine.
CONTEXT COST
Rated by the size of the 12 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
npx -y @twitterapi_io/mcp-serverhttps://mcp.twitterapi.io/mcpAdd this hosted endpoint to your MCP client using the credentials listed under Requirements.
{
"mcpServers": {
"twitterapi-io": {
"command": "npx",
"args": [
"-y",
"@twitterapi_io/mcp-server"
],
"env": {
"TWITTERAPI_IO_API_KEY": "<YOUR_TWITTERAPI_IO_API_KEY>"
}
}
}
}{
"servers": {
"twitterapi-io": {
"command": "npx",
"args": [
"-y",
"@twitterapi_io/mcp-server"
],
"env": {
"TWITTERAPI_IO_API_KEY": "<YOUR_TWITTERAPI_IO_API_KEY>"
}
}
}
}claude mcp add twitterapi-io -e TWITTERAPI_IO_API_KEY=<YOUR_TWITTERAPI_IO_API_KEY> -- npx -y @twitterapi_io/mcp-serverMCP servers
pranciskus
AiAgentKarl
DevinChen2014DevinChen2014