Twitter/X read-only MCP server — 12 tools: search, users, tweets, followers, timelines, trends.
Inferred from the transports this listing declares (streamable-http). A client not listed here hasn’t been ruled out — it just isn’t something Forge can confirm.
Verification confirms publisher identity (repo ownership), not code safety. The security scan covers known CVEs and suspicious install scripts.
Read from a real MCP initialize → tools/list handshake against the declared endpoint. No tool was ever invoked — tools/list is the read-only introspection call the protocol defines for this. It reflects what the server advertised at that moment; a hosted endpoint is not pinned to any version and can change without notice.
https://mcp.twitterapi.io/mcp12 tools · 110mssearch_tweets🎯 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' →…🎯 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' →…
| Parameter | Type | Description |
|---|---|---|
| query* | string | Twitter advanced search query string. Supports operators: from:USER, to:USER, since:YYYY-MM-DD, until:YYYY-MM-DD, lang:en, filter:replies, -filter:retweets, ha… |
| queryType* | string | 'Latest' returns most recent tweets first; 'Top' returns highest-engagement tweets first. Default to 'Latest' for time-sensitive queries. |
| cursor | string | Pagination cursor from a previous response's next_cursor field. Omit for first page. Each page returns ~20 tweets. |
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.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.
| Parameter | Type | Description |
|---|---|---|
| userName* | string | Twitter/X screen name (handle) WITHOUT the leading @ sign. Example: 'elonmusk', not '@elonmusk'. |
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.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.
| Parameter | Type | Description |
|---|---|---|
| userName* | string | Twitter/X screen name without @ — fetches the user's profile 'about' / bio page. |
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…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…
| Parameter | Type | Description |
|---|---|---|
| userName* | string | Twitter/X screen name without @ — fetches followers of this user. |
| cursor | string | Pagination cursor from previous response's next_cursor. Omit for first page. |
| pageSize | integer | Followers per page (default 200, max 200). Each follower includes full profile metadata (name, bio, follower count, etc.). |
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).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).
| Parameter | Type | Description |
|---|---|---|
| userName* | string | Twitter/X screen name without @ — fetches accounts this user follows. |
| cursor | string | Pagination cursor; omit for first page. |
| pageSize | integer | Followings per page (default 200, max 200). Each includes full profile metadata. |
get_user_last_tweets⚠️ 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…⚠️ 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…
| Parameter | Type | Description |
|---|---|---|
| userName | string | Twitter/X screen name without @ (e.g. 'elonmusk'). Provide EITHER userName OR userId. |
| userId | string | Twitter/X numeric user ID (e.g. '44196397'). Provide EITHER userName OR userId. Prefer userId if known — handles can change. |
| cursor | string | Pagination cursor; omit for first page. |
| includeReplies | boolean | Include the user's reply tweets in addition to top-level tweets. Default false — only top-level tweets. |
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.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.
| Parameter | Type | Description |
|---|---|---|
| userName* | string | Twitter/X screen name without @ — fetches tweets that mention this user (@userName). |
| sinceTime | integer | Unix timestamp (seconds) lower bound — only mentions after this time. Omit for no lower bound. |
| untilTime | integer | Unix timestamp (seconds) upper bound. Omit for no upper bound. |
| cursor | string | Pagination cursor; omit for first page (~20 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.Batch-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.
| Parameter | Type | Description |
|---|---|---|
| tweet_ids* | string | Comma-separated tweet IDs (e.g. '1234567890,9876543210'). Batch fetch up to 100 tweets in one call. Tweet IDs are numeric strings. |
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.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.
| Parameter | Type | Description |
|---|---|---|
| tweetId* | string | Numeric ID of the tweet to fetch replies for. |
| cursor | string | Pagination cursor; omit for first page (~20 replies per page). |
| queryType | string | 'Latest' or 'Top' — sort order of replies. Default 'Latest'. |
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).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).
| Parameter | Type | Description |
|---|---|---|
| tweetId* | string | Numeric ID of the tweet to fetch quote-tweets for. |
| sinceTime | integer | Unix timestamp (seconds) lower bound. |
| untilTime | integer | Unix timestamp (seconds) upper bound. |
| includeReplies | boolean | Include reply-type quote-tweets in addition to top-level. Default false. |
| cursor | string | Pagination cursor; omit for first page (~20 per page). |
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).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 (~100 per page).
| Parameter | Type | Description |
|---|---|---|
| tweetId* | string | Numeric ID of the tweet to fetch retweeters for. |
| cursor | string | Pagination cursor; omit for first page (~100 per page). |
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.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.
| Parameter | Type | Description |
|---|---|---|
| woeid* | integer | Yahoo Where-On-Earth ID for the location. Common values: 1 = Worldwide, 23424977 = USA, 23424975 = UK, 23424856 = Japan. Use 1 for global trends if unsure. |
| count | integer | Max trends to return (default API behavior; may be silently capped by API). |
12 of 12 tools published a description.
Tool names and descriptions are written by the publisher and shown verbatim as inert text. They are the strings an MCP client passes to a model, so Forge scans them for prompt-injection patterns — any finding appears with the security scan above. “Privileged” is a keyword match on the tool name, not an audit of what the tool does: a benign-sounding name can still do anything.
Twitter/X read-only MCP server — 12 tools: search, users, tweets, followers, timelines, trends.
Linked names open Forge’s index of every entry observed exposing that tool. Browse all indexed tools.
This entry publishes no npm package, so Forge has no dependency tree for it. That is a gap in coverage — not a statement that it has no dependencies.