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 端點的 HTTP 方法、參數、cURL 範例與回應結構
  • 依 user、tweet、list、community 等分類列出可用端點
  • 閱讀價格、驗證、速率限制、Webhook 與串流等指南頁面
  • 依 URL 路徑或頁面鍵取得文件頁面，並快速查看價格與驗證摘要
適用情境
適合在以 TwitterAPI.io 或 Twitter/X API 開發時使用，讓助理直接在編輯器內回答端點、參數、速率限制、價格或驗證相關問題，不必切換到文件網站。
執行需求
透過 npx 從 npm 套件以 stdio 在本機執行，需要 Node.js 18.18.0 以上版本。文件本身不需要 API 金鑰、帳號、環境變數或網路，但首次執行會從 npm 下載套件。可用一個選用環境變數關閉磁碟快取。
安裝前請注意
僅提供文件，不會呼叫 TwitterAPI.io 即時 API，因此無法抓取推文或執行操作。內建快照可能落後於線上服務，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