README.md

metadata

title: TwitterAPI.io MCP
emoji: 🐦
colorFrom: blue
colorTo: indigo
sdk: static
pinned: false
license: mit
short_description: Connect AI agents to Twitter/X data via hosted MCP
tags:
  - mcp
  - mcp-server
  - twitter
  - x
  - social-media
  - api

TwitterAPI.io MCP server

TwitterAPI.io runs a hosted remote MCP server that gives AI agents read-only access to Twitter/X data. Its 12 tools cover tweet search with operators, user profiles, followers and followings, replies, quotes, retweeters, mentions and trends.

This Space is a connection guide. The server itself runs at https://mcp.twitterapi.io/mcp.

Want to try it right here on Hugging Face? KaitoT/twitterapi-io-mcp is a Gradio MCP Space with 3 core tools (search_tweets, get_user_info, get_user_last_tweets); bring your own key as the X-API-Key header.

Connect

Claude (claude.ai / Desktop): Settings → Connectors → Add custom connector → URL https://mcp.twitterapi.io/mcp, then sign in with your TwitterAPI.io account.

Cursor / VS Code / any MCP client with headers:

{
  "mcpServers": {
    "twitterapi-io": {
      "url": "https://mcp.twitterapi.io/mcp",
      "headers": { "Authorization": "Bearer <your twitterapi.io API key>" }
    }
  }
}

Local (stdio): npx -y @twitterapi_io/mcp-server, with your key in TWITTERAPI_IO_API_KEY.

Get a key at twitterapi.io: pay per result, with free credits to start. The MCP setup guide has every client.

Not affiliated with X Corp.