Skip to main content
Glama

mcp-server

Server Details

Official twitterapi.io hosted MCP: Twitter/X tweets, users, followers, trends. OAuth or API key.

Ownership verified
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

A4.2/5.0

Scored across 12 tools

Disambiguation4/5

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.

Naming Consistency4/5

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.

Tool Count5/5

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.

Completeness4/5

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 tools
get_tweet_quotesGet Tweet QuotesA
Read-only
Inspect

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 RepliesA
Read-only
Inspect

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 RetweetersA
Read-only
Inspect

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 IDsA
Read-only
Inspect

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 PageA
Read-only
Inspect

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 FollowersA
Read-only
Inspect

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 FollowingsA
Read-only
Inspect

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 ProfileA
Read-only
Inspect

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 TweetsA
Read-only
Inspect

⚠️ 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 UserA
Read-only
Inspect

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 TweetsA
Read-only
Inspect

🎯 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

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      MCP server for the Twitter/X API, enabling search, user profiles, tweets, followers, and more via natural language.
      94
      1,114 npm
      6
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      MCP server to read X (Twitter) posts, threads, replies, quotes, and search using your own logged-in session, no API key required.
      8
      206 PyPI
      4
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      An 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 npm
      MIT
    • A
      license
      A
      quality
      A
      maintenance
      Real-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.
      2
      796 npm
      229
      MIT
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.

    Resources