Twitterapi Io Mcp

io.github.dorukardahanPublished by GitHub account dorukardahanv1.7.1Updated Nov 7, 2026

Offline access to TwitterAPI.io docs for AI assistants. 67 endpoints, 32 pages, 24 blog posts.

The publisher's own server: Twitterapi

VerifiedSTDIODesktop onlyKnowledge & MemoryDeveloper Tools

Overview

AI-generated overview

Bundled offline snapshot of TwitterAPI.io documentation that lets an assistant search endpoints, guides, pricing and auth details locally.

What you can do
  • Search the bundled docs full-text with fuzzy matching across endpoints, guides and blog posts
  • Look up a specific endpoint's path, parameters, cURL example and response schema
  • Browse endpoints by category such as user, tweet, community, webhook, stream, action, dm, list and trend
  • Read guide pages and fetch a page by URL or page key, optionally from the live site
  • Get pricing, credit costs, QPS limits and the API key authentication guide
When to use it
Useful when you build against TwitterAPI.io and want the assistant to answer questions about endpoints, parameters, pricing, rate limits or authentication without leaving the editor. Not needed if you only want to call the Twitter API itself, since it serves documentation only.
Requirements
Runs locally over stdio via npx, so Node.js 18.18.0 or later is required. No API key or account is needed because the documentation is bundled. An optional environment variable disables the disk cache. Live fetching is limited to the vendor's own domains.
Before you install
The documentation is a snapshot and can lag behind the live service, so verify details before relying on them. The optional live fetch sends requests to the vendor's documentation domains. The docs describe write endpoints that use login cookies and proxy settings; handling those credentials is up to you. Independent community project, not affiliated with the vendor.

Installation

In SourceWeft

  1. Open Twitterapi Io Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

twitterapi-io-mcp

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

[npm version] [npm downloads] [Smithery] [GitHub stars] [License: MIT]

bash
# 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.

  • 76 active 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
  • All deprecated v1 endpoints removed — only current v2 endpoints remain
  • 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.

Recent Changes

  • v1.2.0: OpenAPI-first scraper rewrite — structured parameters with types, response schemas, eliminates Vercel checkpoint issues
  • v1.1.x: Added list_timeline + get_user_timeline, removed 7 deprecated V1 endpoints, security fixes (hono, ajv, express-rate-limit)
  • v1.0.23: Platform advisory — Twitter disabled since:/until: search operators. Use since_time:UNIX / until_time:UNIX instead
  • v1.0.22: Added 7 endpoints (get_space_detail, get_tweet_replies_v2, get_user_about, etc.)

See CHANGELOG.md for full history.

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)

bash
# Add globally (all projects)claude mcp add --scope user twitterapi-io -- npx -y twitterapi-io-mcp
# Or project-onlyclaude mcp add twitterapi-io -- npx -y twitterapi-io-mcp
# Verifyclaude 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
json
{  "mcpServers": {    "twitterapi-io": {      "command": "npx",      "args": ["-y", "twitterapi-io-mcp"]    }  }}

Cursor

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

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

VS Code / VS Code Insiders

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

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

Windsurf

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

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

Docker

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

Or build from source:

bash
git clone https://github.com/dorukardahan/twitterapi-io-mcp.gitcd twitterapi-io-mcp && npm installnode index.js

Available tools

ToolDescriptionBest for
search_twitterapi_docsFull-text search across all docs (fuzzy matching, typo-tolerant)Finding endpoints, guides, or blog posts by keyword
get_twitterapi_endpointGet full endpoint documentation with params, examples, response schemaDeep dive into a specific API endpoint
list_twitterapi_endpointsList endpoints, optionally filtered by categoryBrowsing what's available in a category
get_twitterapi_guideGet guide pages (pricing, auth, rate limits, webhooks, etc.)Understanding platform rules and setup
get_twitterapi_urlFetch content by URL path or page keyWhen you have a direct link to docs
get_twitterapi_pricingQuick pricing overviewCost questions
get_twitterapi_authQuick authentication guideAuth setup and API key usage

For AI assistants

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

User wants...Use this toolExample
Find an endpointsearch_twitterapi_docsquery: "advanced search"
Endpoint detailsget_twitterapi_endpointendpoint_name: "tweet_advanced_search"
List all endpointslist_twitterapi_endpointscategory: "user" (optional)
Pricing infoget_twitterapi_pricingNo params needed
Auth guideget_twitterapi_authNo params needed
Any guide/pageget_twitterapi_guideguide_name: "qps_limits"
Fetch by URLget_twitterapi_urlurl: "pricing"

Tips:

  • Search is fuzzy and typo-tolerant: "twet object" still finds results
  • Use max_results: 5 for focused results
  • All endpoints are current v2 — no deprecated endpoints remain

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 write endpoints need login?" — triggers search_twitterapi_docs with query: "login_cookies"
  • "How do I upload media and create a tweet?" — triggers sequential get_twitterapi_endpoint calls
All 76 endpoints by category
CategoryCountEndpoints
User14get_user_by_username, get_user_about, search_user, batch_get_user_by_userids, get_user_last_tweets, get_user_timeline, get_user_mention, get_user_followers, get_user_verified_followers, get_user_followings, check_follow_relationship, get_my_info, get_user_followers_ids, get_user_subscriptions
Other2get_space_detail, bookmarks_v2
Trend1get_trends
Tweet10get_tweet_by_ids, get_article, get_tweet_reply, get_tweet_replies_v2, get_tweet_thread_context, get_tweet_quote, get_tweet_retweeter, tweet_advanced_search, bookmark_tweet_v2, unbookmark_tweet_v2
List6list_timeline, get_list_members, get_list_followers, add_list_member, remove_list_member, get_list_tweets
Community9get_all_community_tweets, create_community_v2, delete_community_v2, join_community_v2, leave_community_v2, get_community_by_id, get_community_members, get_community_moderators, get_community_tweets
Action25user_login_v2, create_tweet_v2, upload_media_v2, like_tweet_v2, unlike_tweet_v2, delete_tweet_v2, retweet_tweet_v2, follow_user_v2, unfollow_user_v2, update_avatar_v2, update_banner_v2, update_profile_v2, login_by_2fa, login_by_email_or_username, upload_image, create_tweet, like_tweet, retweet_tweet, block_user_v2, mute_user_v2, pin_tweet_v2, unblock_user_v2, unmute_user_v2, unpin_tweet_v2, unretweet_tweet_v2
Dm2send_dm_v2, get_dm_history
Webhook4get_webhook_rules, add_webhook_rule, update_webhook_rule, delete_webhook_rule
Stream3add_user_to_monitor_tweet, remove_user_to_monitor_tweet, get_user_to_monitor_tweet

Configuration

Environment VariableDefaultDescription
TWITTERAPI_MCP_DISK_CACHE1 (on)Set to 0 to disable disk caching

Troubleshooting

npx hangs or fails on first run

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

bash
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:

bash
node --version

claude mcp add not recognized

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

bash
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    │└─────────────┘                      │  (76 endpoints)  │                                     └──────────────────┘                                       No network needed
PropertyValue
RuntimeNode.js 18.18.0+ (ES Modules, no build step)
ProtocolMCP via stdio
CachingHybrid (memory + disk), 24h TTL
SearchN-gram tokenization with fuzzy matching
  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.

Development

bash
git clone https://github.com/dorukardahan/twitterapi-io-mcp.gitcd twitterapi-io-mcpnpm installnpm test        # Run tests (48 tests)npm start       # Start server locallynpm run scrape  # Update docs snapshot from twitterapi.io

Not using MCP?

If your AI tool doesn't support MCP (like OpenClaw), use the skill version instead — a single markdown file with all 76 active endpoints:

👉 twitterapi-io-skill — works with OpenClaw, Claude, GPT, Gemini, and any LLM.

Links

Contributing

PRs welcome! Fork the repo, create a branch, make your changes, and open a pull request. Bug reports and feature requests go to GitHub Issues.

License

MIT

Acknowledgments

Source: README.md at commit 2e006a0

Tools

7

search_twitterapi_docs

Search TwitterAPI.io documentation: API endpoints, guides (pricing, rate limits, filter rules), and blog posts. USE THIS WHEN: You need to find information across the entire documentation. RETURNS: Ranked results with endpoint paths, descriptions, and relevance scores. Examples: - "advanced search" → finds tweet search endpoints - "rate limit" → finds QPS limits and pricing info - "webhook" → finds webhook setup endpoints - "getUserInfo" → finds user info endpoints (supports camelCase)

Parametersqueryrequiredmax_results

get_twitterapi_endpoint

Get complete documentation for a specific TwitterAPI.io endpoint. USE THIS WHEN: You know the exact endpoint name (e.g., from search results). RETURNS: Full details including path, parameters, cURL example, and code snippets. Common endpoints: - get_user_info, get_user_followers, get_user_following - tweet_advanced_search, get_tweet_by_id - add_webhook_rule, get_webhook_rules

Parametersendpoint_namerequired

list_twitterapi_endpoints

List all TwitterAPI.io API endpoints organized by category. USE THIS WHEN: You need to browse available endpoints or find endpoints by category. CATEGORIES: user, tweet, community, webhook, stream, action, dm, list, trend RETURNS: Endpoint names with HTTP method and path for each category.

Parameterscategory

get_twitterapi_guide

Get a TwitterAPI.io page from the offline snapshot by page key. USE THIS WHEN: You need the full content of a specific page (guides, docs, policies, contact, etc.). TIP: Use search_twitterapi_docs if you don't know the page key. RETURNS: Full guide content with headers, paragraphs, and code examples.

Parametersguide_namerequired

get_twitterapi_url

Fetch a TwitterAPI.io or docs.twitterapi.io URL. USE THIS WHEN: You have a specific link and want its full content. RETURNS: Parsed content from the offline snapshot. If not found, you can set fetch_live=true (restricted to twitterapi.io/docs.twitterapi.io).

Parametersurlrequiredfetch_live

get_twitterapi_pricing

Get TwitterAPI.io pricing information: credit system, endpoint costs, QPS limits. USE THIS WHEN: You need to know API costs, credit calculations, or rate limits. RETURNS: Pricing tiers, credit costs per endpoint, QPS limits by balance level.

Takes no parameters.

get_twitterapi_auth

Get TwitterAPI.io authentication guide: API key usage, headers, code examples. USE THIS WHEN: You need to set up authentication or see request examples. RETURNS: API key header format, base URL, cURL/Python/JavaScript examples.

Takes no parameters.

Version history

15
  1. v1.7.1LatestNov 6, 2026
  2. v1.7.0Nov 3, 2026
  3. v1.6.2Oct 29, 2026
  4. v1.6.1Oct 25, 2026
  5. v1.6.0Oct 24, 2026
  6. v1.5.31Oct 23, 2026
  7. v1.5.30Oct 21, 2026
  8. v1.5.29Oct 19, 2026
  9. v1.5.28Oct 18, 2026
  10. v1.5.26Oct 17, 2026
  11. v1.5.25Oct 16, 2026
  12. v1.5.24Oct 13, 2026
  13. v1.5.23Oct 7, 2026
  14. v1.5.22Oct 6, 2026
  15. v1.5.19Sep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Twitterapi integrations

Twitterapi

io.twitterapiOfficial publisher

Hosted twitterapi.io MCP server giving an assistant read-only access to Twitter/X tweets, user profiles, followers, replies, quotes and trends.

Streamable HTTPWeb executable
Web Search & Scraping12 toolsNov 8, 2026

Twitterapi

Published by GitHub account pedrot95dev

Local MCP server that lets an assistant read X (Twitter) mentions and thread context and create or delete tweets through twitterapi.io.

STDIODesktop only
Web Search & ScrapingNot validated yetOct 24, 2026

Twitterapi Mcp Server

Published by GitHub account kaitoInfra

A remote, read-only MCP server for Twitter/X data: search tweets, look up users, followers, timelines, replies, quotes, retweeters and trends.

Streamable HTTPWeb executable
Web Search & Scraping12 toolsOct 25, 2026

Twitterapi Io Mcp Server

Published by GitHub account kaitoInfra

Official twitterapi.io MCP server that lets an assistant search tweets and look up Twitter/X users, followers, replies, quotes, retweeters and trends.

STDIODesktop only
Web Search & ScrapingNot validated yetOct 24, 2026

Twitterapi Docs Mcp

Published by GitHub account dorukardahan

Bundled offline snapshot of TwitterAPI.io documentation that lets an assistant search endpoints, guides, pricing and auth details without network calls.

STDIODesktop only
Knowledge & MemoryNot validated yetOct 24, 2026