MCP server

Twitterapi

io.github.kaitoInfra/twitterapi-mcp-server

Checked 25 Oct 2026, 20:29 UTC · Connected to it and listed its tools

Twitter/X read-only MCP server — 12 tools: search, users, tweets, followers, timelines, trends.

Website

At a glance

Type

MCP server

Publisher

Not verified

Status

Working at last check

Tools

12

Token cost

About 2,832 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

25 Oct 2026, 20:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http twitterapi-mcp-server https://mcp.twitterapi.io/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.twitterapi-mcp-server]
url = "https://mcp.twitterapi.io/mcp"

Gemini CLI

{"mcpServers":{"twitterapi-mcp-server":{"httpUrl":"https://mcp.twitterapi.io/mcp"}}}

Cursor

{"mcpServers":{"twitterapi-mcp-server":{"url":"https://mcp.twitterapi.io/mcp"}}}

VS Code

{"servers":{"twitterapi-mcp-server":{"type":"http","url":"https://mcp.twitterapi.io/mcp"}}}

Antigravity

agy mcp add twitterapi-mcp-server https://mcp.twitterapi.io/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"twitterapi-mcp-server","server_url":"https://mcp.twitterapi.io/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"twitterapi-mcp-server","server_url":"https://mcp.twitterapi.io/mcp"}

Tools

• get_trends ~205 tokens
  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.
• get_tweet_quotes ~239 tokens
  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).
• get_tweet_replies ~193 tokens
  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.
• get_tweet_retweeters ~146 tokens
  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).
• get_tweets_by_ids ~167 tokens
  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.
• get_user_about ~139 tokens
  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.
• get_user_followers ~262 tokens
  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 l
• get_user_followings ~187 tokens
  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).
• get_user_info ~154 tokens
  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.
• get_user_last_tweets ~372 tokens
  ⚠️ 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-
• get_user_mentions ~254 tokens
  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.
• search_tweets ~514 tokens
  🎯 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'

Browse

• GitHub tools
• SEO
• Social media
• GitHub and code hosting
• Translation

Related MCP servers

• xdataapi: X (Twitter) data
  Read-only public X (Twitter) data: profiles, tweets, threads, followers, search. Pay per result.
• twitr.sh
  X/Twitter reads, search, monitors and posting. Pay-per-call in USDC — no signup, no API keys.
• X Twitter
  X (twitter): x, xapi, Twitter, twitter api, twitters ,tweets, tw, twttr, FollowerIds, friendsIds.
• Jojapi Twitter
  X (formerly Twitter): X (formerly Twitter) public and private data API for search, posts (Tweets).
• YouSpot
  Query one person's second brain: contacts, companies, notes, files and connected accounts.
• agdata
  Unblocking and fresh web data for agents: URL to Markdown, YouTube, Maps, Amazon, jobs. Pay per call
• Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ)
  Twitter/X, Instagram, Reddit & TikTok data for AI agents. Billions of posts. No API keys.
• Twitter / X data for agents
  15 Twitter / X endpoints. Pay per call in USDC via x402.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.kaitoInfra/twitterapi-mcp-server.svg)](https://aptlynx.net/servers/io.github.kaitoInfra/twitterapi-mcp-server)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents