twitterapi-io

This MCP server provides an offline, self-contained snapshot of TwitterAPI.io documentation that Claude, Cursor, VS Code Copilot, and other AI assistants can query locally. It exposes a suite of tools that allow you to search the docs, fetch detailed endpoint information, browse guides and blog posts, and obtain direct content by URL or category. Key tools include: search_twitterapi_docs for full-text, fuzzy searches across endpoints, guides, and blogs; get_twitterapi_endpoint for detailed endpoint documentation including params, body, examples, and response schemas; list_twitterapi_endpoints to browse endpoints (optionally filtered by category); get_twitterapi_guide to retrieve specific guides like authentication, rate limits, and pricing; get_twitterapi_url to fetch content by a URL path or page key; get_twitterapi_pricing for pricing overview; get_twitterapi_auth for authentication guidance. Use these to build rich, contextual responses for AI assistants, enabling offline access to the documentation without API keys. The server is packaged as the twitterapi-io-mcp MCP server and can be invoked via npx or integrated into your development environment via Claude, Cursor, VS Code, Windsurf, or Docker workflows as shown in the README examples.

Prerequisites:

• Node.js 18.18.0+ (per the project requirements)
• npm (comes with Node.js) or a compatible package manager

Installation and setup (several integration paths):

1. Global installation (CLI usage via npm):

npm install -g twitterapi-io-mcp

2. Run via npx (no global install required):

npx -y twitterapi-io-mcp

3. Claud e Code integration (example from README):

# 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

4. Docker/startup workflow (alternative local build):

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

5. Quick verification (using the provided example config in Claude Desktop):

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

Prerequisites for Docker path: Docker must be installed and running on your machine.

Tips and caveats:

• The MCP server ships a complete, offline documentation snapshot of TwitterAPI.io, so no API keys are required.
• Environment variable TWITTERAPI_MCP_DISK_CACHE controls disk caching (default 1 to enable). Set to 0 to disable.
• If npx hangs on first run (downloading the package), try the recommended fallback: npx -y twitterapi-io-mcp@latest or install globally with npm install -g twitterapi-io-mcp.
• Ensure your Node.js version matches the supported range (the project notes mention Node.js 18.18.0+ and compatibility considerations).
• When integrating with Claude or other assistants, you can copy the same mcp configuration snippet shown in the README into your editor integrations (Claude Desktop, Cursor, VS Code, Windsurf) to wire up twitterapi-io-mcp as a local data source.