twitterapi-docs-mcp

MCP (Model Context Protocol) server providing offline access to TwitterAPI.io documentation for Claude and other AI assistants.

Disclaimer: This is an unofficial community project. Not affiliated with, endorsed by, or sponsored by TwitterAPI.io. TwitterAPI.io is a trademark of its respective owner.

Why I Built This

I'm an independent developer who uses TwitterAPI.io for my projects. I found myself constantly switching between my code editor and the documentation website, searching for endpoint details, checking rate limits, and looking up authentication requirements.

So I built this MCP server to have instant access to the entire documentation right inside Claude. No more tab-switching, no more searching — just ask Claude and get the answer.

I'm sharing this with the community because if it helped me, it might help you too. 🚀

Features

• 52 API endpoints documented
• 8 guide pages (pricing, QPS limits, filter rules, changelog, etc.)
• 5 blog articles (pricing comparison, analytics guide, etc.)
• Offline-first - Works without network access
• Fast search with fuzzy matching and camelCase support
• Hybrid caching for optimal performance

Installation

Claude Desktop

Add to your Claude Desktop configuration file:

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

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

Claude Code

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

# Or add to current project only
claude mcp add twitterapi-docs -- npx -y twitterapi-docs-mcp

Verify installation:

claude mcp list

Available Tools

Tool	Description
search_twitterapi_docs	Full-text search across all docs (endpoints, guides, blogs)
get_twitterapi_endpoint	Get detailed info for a specific API endpoint
list_twitterapi_endpoints	List all endpoints with optional category filter
get_twitterapi_guide	Get guide pages (pricing, qps_limits, authentication, etc.)
get_twitterapi_pricing	Quick access to pricing information
get_twitterapi_auth	Quick access to authentication guide

Available Resources

Resource URI	Description
twitterapi://guides/pricing	Pricing guide
twitterapi://guides/qps-limits	QPS limits and rate limiting
twitterapi://guides/filter-rules	Tweet filter rules syntax
twitterapi://guides/changelog	API changelog
twitterapi://guides/introduction	Introduction to TwitterAPI.io
twitterapi://guides/authentication	Authentication guide
twitterapi://endpoints/list	Full endpoint listing
twitterapi://status/freshness	Data freshness status

Usage Examples

Once installed, you can ask Claude questions like:

• "What are the QPS limits for TwitterAPI.io?"
• "Show me the advanced search endpoint"
• "How do webhook filter rules work?"
• "How do I get user followers?"
• "What's the pricing structure?"
• "How do I authenticate with the API?"

API Endpoint Categories

Category	Count	Examples
User	9	get_user_by_username, get_user_followers, get_user_followings
Tweet	7	tweet_advanced_search, get_tweet_reply, get_tweet_quote
Community	5	get_community_by_id, get_community_members
Webhook	4	add_webhook_rule, get_webhook_rules
Stream	2	add_user_to_monitor_tweet
Action	16	create_tweet, like_tweet, follow_user_v2
DM	2	send_dm_v2, get_dm_history_by_user_id
List	2	get_list_followers, get_list_members
Trend	1	get_trends

How It Works

This MCP server bundles a snapshot of TwitterAPI.io documentation (scraped with permission patterns). When Claude or another MCP-compatible AI assistant needs information about TwitterAPI.io:

1. The assistant calls one of the available tools
2. The server searches/retrieves from the local documentation cache
3. Results are returned instantly without network latency

The documentation includes:

• Complete API reference with request/response examples
• Authentication guides
• Rate limiting information
• Pricing details
• Best practices

Updating Documentation

If TwitterAPI.io updates their documentation, clone the repo and run the scraper:

git clone https://github.com/dorukardahan/twitterapi-docs-mcp.git
cd twitterapi-docs-mcp
npm install
node scrape-all.cjs

Note: The scraper is included in the repository but not in the npm package.

Development

# Clone repository
git clone https://github.com/dorukardahan/twitterapi-docs-mcp.git
cd twitterapi-docs-mcp

# Install dependencies
npm install

# Run tests
npm test

# Start server locally
npm start

Technical Details

• Runtime: Node.js 18.18.0+
• Module System: ES Modules (no build step)
• Protocol: MCP (Model Context Protocol) via stdio
• Caching: Hybrid (memory + disk) with 24-hour TTL
• Search: Advanced tokenization with n-gram fuzzy matching

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

MIT - see LICENSE file for details.

Acknowledgments

• TwitterAPI.io for providing excellent Twitter/X API access
• Anthropic for the Model Context Protocol
• MCP SDK for the server framework