twitterapi-io-mcp

Offline TwitterAPI.io documentation for Claude and AI assistants via MCP. 59 endpoints (with full method/params/body), 32 guides, 24 blog posts. No API key needed.

# Quick install (Claude Code)
claude mcp add twitterapi-io -- npx -y twitterapi-io-mcp

What is this?

An MCP server that gives Claude, Cursor, VS Code Copilot, and other AI assistants instant, offline access to TwitterAPI.io documentation.

• 59 API endpoints with full HTTP method, body/query parameters, cURL examples, and response schemas
• 32 guide pages covering pricing, authentication, rate limits, webhooks, streaming
• 24 blog posts with tutorials and use cases
• All v2 write endpoints documented with login_cookies, proxy, and body params
• 4 deprecated v1 endpoints marked with migration notices
• Zero API key required — everything is bundled locally

Unlike other Twitter MCP servers that proxy live API calls (and need your API key), this one ships a complete documentation snapshot. Your AI assistant reads it locally, instantly.

v1.0.23 Highlights

• Platform advisory: Twitter disabled since:/until: search operators and pagination (~Mar 5, 2026). Workarounds documented in docs/platform-advisory-2026-03.md.
• Workaround: Use since_time:UNIX / until_time:UNIX format instead (tested, working)
• Webhook URL warning: URL not auto-restored after API key rotation — must be manually re-set

v1.0.22 Highlights

• 7 new endpoints (52 → 59 total): get_space_detail, get_tweet_replies_v2, get_user_about, get_user_to_monitor_tweet, update_avatar_v2, update_banner_v2, update_profile_v2

• Fresh rescrape from docs.twitterapi.io (Feb 21, 2026)

• All 59 endpoints now match official llms.txt index

• Scraper auto-extracts method/body/params — npm run scrape keeps data fresh

Disclaimer: Independent community project. Not affiliated with TwitterAPI.io.

Installation

Previously published as twitterapi-docs-mcp? Just change the package name — everything else stays the same.

Requires: Node.js 18.18.0+

Claude Code (recommended)

# Add globally (all projects)
claude mcp add --scope user twitterapi-io -- npx -y twitterapi-io-mcp

# Or project-only
claude mcp add twitterapi-io -- npx -y twitterapi-io-mcp

# Verify
claude mcp list

Claude Desktop

Add to your config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "twitterapi-io": {
      "command": "npx",
      "args": ["-y", "twitterapi-io-mcp"]
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "twitterapi-io": {
      "command": "npx",
      "args": ["-y", "twitterapi-io-mcp"]
    }
  }
}

VS Code / VS Code Insiders

Add to .vscode/mcp.json in your project root:

{
  "servers": {
    "twitterapi-io": {
      "command": "npx",
      "args": ["-y", "twitterapi-io-mcp"]
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "twitterapi-io": {
      "command": "npx",
      "args": ["-y", "twitterapi-io-mcp"]
    }
  }
}

Docker

docker run -i --rm $(docker build -q .) 2>/dev/null

Or build from source:

git clone https://github.com/dorukardahan/twitterapi-io-mcp.git
cd twitterapi-io-mcp && npm install
node index.js

Available tools

For AI assistants

If you're an AI assistant using this MCP server, here's a quick reference:

Tips:

• Search is fuzzy and typo-tolerant: "twet object" still finds results
• Use max_results: 5 for focused results
• Check the deprecation_notice field — some legacy endpoints have v2 replacements

What can you ask?

Here are real prompts that work well with this MCP server:

• "What are the rate limits for TwitterAPI.io?" — triggers get_twitterapi_guide
• "Show me the tweet advanced search endpoint" — triggers get_twitterapi_endpoint
• "How do I authenticate with the API?" — triggers get_twitterapi_auth
• "What's the pricing?" — triggers get_twitterapi_pricing
• "List all user-related endpoints" — triggers list_twitterapi_endpoints with category: "user"
• "How do webhook filter rules work?" — triggers search_twitterapi_docs
• "What endpoints are deprecated?" — triggers search_twitterapi_docs with query: "deprecated"
• "How do I upload media and create a tweet?" — triggers sequential get_twitterapi_endpoint calls

<details> <summary><strong>All 59 endpoints by category</strong></summary> </details>

Configuration

Troubleshooting

npx hangs or fails on first run

The first run downloads the package from npm. If it hangs, try:

npx -y twitterapi-io-mcp@latest

Or install globally: npm install -g twitterapi-io-mcp

"Node.js version not supported"

This server requires Node.js 18.18.0 or later. Check your version:

node --version

claude mcp add not recognized

Make sure Claude Code CLI is installed and up to date:

claude --version

Server starts but no tools appear

Restart your MCP client after adding the server config. Most clients (Claude Desktop, Cursor) need a restart to detect new MCP servers.

How it works

┌─────────────┐     MCP (stdio)      ┌──────────────────┐
│   Claude /   │ ◄──────────────────► │ twitterapi-io-mcp│
│  Cursor /    │                      │                  │
│  VS Code     │                      │  Bundled docs    │
└─────────────┘                      │  (59 endpoints)  │
                                     └──────────────────┘
                                       No network needed

1. AI assistant calls an MCP tool (search, get endpoint, etc.)
2. Server searches the bundled documentation snapshot
3. Results return instantly with no network requests

Why I built this

I use TwitterAPI.io daily for my projects. Switching between my editor and their docs site got old fast. So I packaged the entire documentation into an MCP server. Now I ask Claude and get answers without leaving my terminal.

If you work with the Twitter/X API through TwitterAPI.io, this saves you the same context-switching. Install it, forget about it, and just ask.

Develo

---