Spaces:
Running
Running
| 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 | |
| - x | |
| - social-media | |
| - api | |
| # TwitterAPI.io MCP server | |
| [TwitterAPI.io](https://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](https://huggingface.co/spaces/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:** | |
| ```json | |
| { | |
| "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](https://twitterapi.io): pay per result, with free credits to start. The [MCP setup guide](https://twitterapi.io/twitter-mcp-server) has every client. | |
| Not affiliated with X Corp. | |