TwitterAPI.io MCP Server
Server Details
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.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-06-18
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 12 tools
Tools target distinct resources (trends, tweet engagements, user graph, search), and the descriptions proactively disambiguate the biggest risk areas — get_user_last_tweets vs. search_tweets and get_user_info vs. get_user_about. Minor residual overlap remains between get_user_mentions and search_tweets (both surface tweets about a user/topic), but an agent has enough guidance to choose correctly.
Nearly all tools follow a clean snake_case get_<resource> pattern, making the set easy to scan. Deviations are small: search_tweets uses a different verb, and get_user_followings is grammatically awkward but still readable and unambiguous.
Twelve tools is well within the sweet spot and each one maps to a real Twitter/X data need (trends, tweet engagement variants, user profile, graph, timeline, mentions, search). Nothing feels padded or missing at the count level.
The surface is entirely read-only: there is rich coverage of fetching, pagination, and search, but no write operations (post/delete tweet, like, follow, DM) and no single-tweet detail tool beyond batch get_tweets_by_ids. For a read/analytics-oriented server this is coherent, but as a 'Twitter API' surface it leaves notable lifecycle gaps.
Publisher details
- Operator
- TwitterAPI.io · Publisher source
- Operator website
- https://twitterapi.io/?utm_source=glama&utm_medium=directory&utm_campaign=glama_boost_2026_11&utm_content=website · Publisher source
- Vendor relationship
- First-party · Publisher source
- Documentation
- https://twitterapi.io/twitter-mcp-server?utm_source=glama&utm_medium=directory&utm_campaign=glama_boost_2026_11&utm_content=docs · Publisher source
- Trust center
- Not available
- Restrictions
- Requires a TwitterAPI.io API key (sent as a Bearer token) or sign-in with a TwitterAPI.io account. New accounts get free starter credits; after that, usage is paid per result returned. · Publisher source
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
Official twitterapi.io hosted MCP: Twitter/X tweets, users, followers, trends. OAuth or API key.
Your agent needs X/Twitter data — who follows a competitor, what a community is posting, who quoted that tweet, what is trending in Japan. Normally that means applying for an X developer account, passing app review, and managing a quota per endpoint. **What you can ask for** • "Who follows @stripe, and which of them are verified?" • "Pull every reply and quote on this tweet and summarise what people object to." • "List this community's moderators and its posts this week." • "What is trending in Japan right now?" • "Give me the full thread context behind this link, including the long-form article." **How to use it** Point any MCP client at https://mcp.aisa.one/twitter-api/mcp and sign in with OAuth — there is no key to create or paste. 29 read tools: users (profile, about, batch lookup by id, search, followers, verified followers, followings, follow check), tweets (timeline, latest, mentions, advanced search, replies, quotes, retweeters, thread context, articles), communities, lists, Spaces and trends. **Why this rather than the source** No developer account to apply for, no app review, no per-endpoint quota to manage. **It is also a door to the rest** The same login reaches 26 sources and 580+ operations. Ask for a handle's followers here, then ask the same agent for that brand's search traffic, its backlinks, or the people to contact — without adding a second server. **What it costs** Finding and inspecting an operation is free. Running one is billed per call at API prices, with no seat and no monthly minimum, and every call takes max_price_usd so an agent cannot overspend by accident. **Where else it reaches** https://mcp.aisa.one/social/mcp for X plus Instagram, Reddit, Pinterest and YouTube; https://mcp.aisa.one/gtm/mcp for those plus Similarweb and Apollo.
Live X/Twitter data: profiles, tweets, search, followers, lists and trends. 29 read-only tools.
Twitter (X) data for agents: profiles, tweets, search, followers, lists. $0.0006 per call.
Related MCP Servers
- AlicenseAqualityCmaintenanceOfficial MCP server for twitterapi.io — Twitter/X data access (search tweets, users, followers, replies, trends) via Claude Desktop, Cursor, VS Code Copilot, or any MCP-compatible client. 12 read-only tools, stdio transport.12112 npm1MIT
- AlicenseAqualityBmaintenanceMCP server for the Twitter/X API, enabling search, user profiles, tweets, followers, and more via natural language.941,114 npm6MIT
- AlicenseAqualityDmaintenanceAn MCP server that provides AI agents with full access to the X (Twitter) API for posting, searching, and managing engagement through natural language. It supports comprehensive tools for tweet management, media uploads, and account analytics across multiple MCP-compatible clients.1563MIT
- AlicenseAqualityCmaintenanceExposes the Twitter/X API as native MCP tools, letting agents search tweets and users, pull profiles, timelines, followers, lists, communities, and trends, and read account-scoped data like bookmarks, DMs, and home timeline. It also performs write actions such as posting, liking, retweeting, following, and their reversals, using an API key with optional linked or per-call X account credentials.991,114 npmMIT
Glama MCP Gateway
Add one secure layer between your agents and this server.