dorukardahan/twitterapi-docs-mcp

> Offline TwitterAPI.io documentation for Claude and AI assistants via MCP. 67 active endpoints (with full method/params/body), 32 guides, 24 blog posts. No API key needed.
What is this?
An MCP server that gives Claude, Cursor, VS Code Copilot, and other AI assistants **instant, offline access** to TwitterAPI.io documentation.
- **67 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)
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
Cursor
Add to .cursor/mcp.json in your project root:
VS Code / VS Code Insiders
Add to .vscode/mcp.json in your project root:
Windsurf
Add to ~/.codeium/windsurf/mcp_config.json:
Docker
Or build from source:
Available tools
| Tool | Description | Best for |
|------|-------------|----------|
| search_twitterapi_docs | Full-text search across all docs (fuzzy matching, typo-tolerant) | Finding endpoints, guides, or blog posts by keyword |
| get_twitterapi_endpoint | Get full endpoint documentation with params, examples, response schema | Deep dive into a specific API endpoint |
| list_twitterapi_endpoints | List endpoints, optionally filtered by category | Browsing what's available in a category |
| get_twitterapi_guide | Get guide pages (pricing, auth, rate limits, webhooks, etc.) | Understanding platform rules and setup |
| get_twitterapi_url | Fetch content by URL path or page key | When you have a direct link to docs |
| get_twitterapi_pricing | Quick pricing overview | Cost questions |
| get_twitterapi_auth | Quick authentication guide | Auth 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 tool | Example |
|---------------|---------------|---------|
| Find an endpoint | search_twitterapi_docs | query: "advanced search" |
| Endpoint details | get_twitterapi_endpoint | endpoint_name: "tweet_advanced_search" |
| List all endpoints | list_twitterapi_endpoints | category: "user" (optional) |
| Pricing info | get_twitterapi_pricing | No params needed |