Skip to main content
Glama

twitterapi-docs-mcp

by dorukardahan
OverviewInspectSchemaRelated ServersScoreDiscussions
JavaScript
Local
MIT License

twitterapi-docs-mcp

npm version npm downloads MCP Registry License: MIT Node.js

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

One-click Deploy
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

Resources

Tools

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/dorukardahan/twitterapi-docs-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server