---
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](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.