Twitterapi Docs Mcp

io.github.dorukardahan由 GitHub 账号 dorukardahan 发布v1.0.3更新于 Oct 24, 2026

Offline access to TwitterAPI.io docs for AI assistants. 52 endpoints, guides, pricing.

发布方自己的服务：Twitterapi

已验证STDIO仅桌面知识与记忆开发者工具

概览

AI 生成的概览

内置 TwitterAPI.io 文档离线快照的 MCP 服务器，让助手无需联网即可检索接口、指南、价格与认证信息。

可以做什么
  • 以模糊、容错的全文检索方式搜索全部内置文档
  • 查询单个 API 接口的请求方法、参数、cURL 示例与响应结构
  • 按 user、tweet、list、community 等分类列出可用接口
  • 阅读价格、认证、速率限制、Webhook 与流式推送等指南页面
  • 按 URL 路径或页面键获取文档页面，并快速查看价格与认证摘要
适用场景
适合在基于 TwitterAPI.io 或 Twitter/X API 开发时使用，让助手在编辑器内直接回答接口、参数、速率限制、价格或认证相关问题，无需切换到文档网站。
运行要求
通过 npx 从 npm 包以 stdio 方式在本地运行，需要 Node.js 18.18.0 或更高版本。文档本身不需要 API 密钥、账号、环境变量或网络，但首次运行会从 npm 下载包。可通过一个可选环境变量关闭磁盘缓存。
安装前请注意
仅提供文档，不会调用 TwitterAPI.io 实时接口，因此无法抓取推文或执行操作。内置快照可能落后于线上服务，README 也提到平台变更（如搜索运算符被停用）。该项目为独立社区项目，与 TwitterAPI.io 无隶属关系。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Twitterapi Docs Mcp，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

twitterapi-io-mcp

Offline TwitterAPI.io documentation for Claude and AI assistants via MCP. 75 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.

  • 75 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 75 endpoints by category
CategoryCountEndpoints
User13get_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
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    │└─────────────┘                      │  (75 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 75 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

来源：README.md，提交 66c79b1

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.0.3最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Twitterapi 集成

Twitterapi

io.twitterapi官方发布者

twitterapi.io 的托管 MCP 服务器，让助手搜索推文、查看 X 用户、粉丝、回复和热门话题。

Streamable HTTP可网页运行
网页搜索与抓取12 个工具Oct 24, 2026

Twitterapi

由 GitHub 账号 pedrot95dev 发布

本地 MCP 服务器，让助手通过 twitterapi.io 读取 X（Twitter）提及和推文串上下文，并创建或删除推文。

STDIO仅桌面
网页搜索与抓取尚未验证Oct 24, 2026

Twitterapi Mcp Server

由 GitHub 账号 kaitoInfra 发布

面向 Twitter/X 的远程只读 MCP 服务器：可搜索推文、查询用户、关注者、时间线、回复、引用、转发者和热门趋势。

Streamable HTTP可网页运行
网页搜索与抓取12 个工具Oct 25, 2026

Twitterapi Io Mcp Server

由 GitHub 账号 kaitoInfra 发布

twitterapi.io 官方 MCP 服务器，让助手搜索推文并查询 Twitter/X 用户、关注者、回复、引用、转发者和热门话题。

STDIO仅桌面
网页搜索与抓取尚未验证Oct 24, 2026

Twitterapi Io Mcp

由 GitHub 账号 dorukardahan 发布

内置 TwitterAPI.io 文档离线快照的 MCP 服务器，让助手在本地检索接口、指南、价格与鉴权信息。

STDIO仅桌面
知识与记忆7 个工具Nov 7, 2026