TwitterAPI.io MCP Server

Acesso somente leitura aos dados do Twitter/X — tweets, perfis, seguidores, busca avançada, tendências — via 12 ferramentas MCP fornecidas pela twitterapi.io. API paga por chamada, sem OAuth, chave instantânea.

GitHubExperimente este MCPPatrocinado

Documentação

twitterapi.io MCP Server

Servidor oficial do Model Context Protocol para twitterapi.io — API de dados do Twitter / X para agentes de IA e aplicações.

Conecte Claude Desktop, Cursor, VS Code Copilot ou qualquer cliente MCP ao twitterapi.io e pesquise tweets, obtenha perfis de usuários, seguidores, respostas, tendências e muito mais — tudo em linguagem natural.

Recursos

12 ferramentas somente leitura mapeadas 1:1 para os endpoints de produção verificados do twitterapi.io:

Ferramenta	O que faz
`search_tweets`	Pesquisa avançada com operadores do Twitter (`from:`, `since:`, `lang:`, `has:`, …)
`get_user_info`	Informações básicas do perfil do usuário pelo nome de tela
`get_user_about`	Perfil estendido / página sobre
`get_user_followers`	Seguidores com metadados completos do perfil (paginado)
`get_user_followings`	Lista de seguidos com metadados do perfil (paginado)
`get_user_last_tweets`	Tweets recentes de um usuário (linha do tempo)
`get_user_mentions`	Tweets que mencionam um usuário
`get_tweets_by_ids`	Busca em lote de tweets por ID (até 100)
`get_tweet_replies`	Respostas a um tweet
`get_tweet_quotes`	Citações de um tweet
`get_tweet_retweeters`	Usuários que retweetaram um tweet
`get_trends`	Tópicos em alta por localização (WOEID)

Início Rápido

1. Obtenha uma chave de API

Cadastre-se em twitterapi.io — plano gratuito disponível.

2. Configure seu cliente MCP

Claude Desktop

Edite ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "twitterapi-io": {
      "command": "npx",
      "args": ["-y", "@twitterapi_io/mcp-server"],
      "env": {
        "TWITTERAPI_IO_API_KEY": "your_key_here"
      }
    }
  }
}

Reinicie o Claude Desktop. As 12 ferramentas estarão disponíveis em qualquer chat — o Claude escolherá a correta com base no seu prompt.

Cursor

Abra Configurações → MCP → Adicionar novo servidor MCP:

{
  "mcpServers": {
    "twitterapi-io": {
      "command": "npx",
      "args": ["-y", "@twitterapi_io/mcp-server"],
      "env": {
        "TWITTERAPI_IO_API_KEY": "your_key_here"
      }
    }
  }
}

VS Code (Copilot Chat com MCP)

Adicione à configuração de servidores MCP — mesmo formato do Claude Desktop / Cursor.

Claude Code

claude mcp add twitterapi-io npx -- -y @twitterapi_io/mcp-server -e TWITTERAPI_IO_API_KEY=your_key_here

3. Use

Em qualquer chat com MCP habilitado:

"Encontre tweets recentes de @elonmusk sobre IA na última semana"

"Obtenha a lista de seguidores de @sama e mostre os 20 primeiros por número de seguidores"

"Quais são os tópicos em alta no Japão agora?"

O Claude (ou seu cliente) escolherá automaticamente search_tweets / get_user_followers / get_trends e os chamará com os parâmetros corretos.

Autenticação

A autenticação é feita pela variável de ambiente TWITTERAPI_IO_API_KEY, injetada pelo seu cliente MCP. O servidor nunca armazena ou registra a chave. Cada chamada de ferramenta envia a chave no cabeçalho X-API-Key para https://api.twitterapi.io.

Paginação

Ferramentas que retornam listas (seguidores, respostas, resultados de pesquisa, etc.) retornam um campo next_cursor. Passe-o de volta como argumento cursor na próxima chamada para navegar pelas páginas. Cada página normalmente tem ~20 itens.

Tratamento de erros

Respostas 429 / 5xx são automaticamente repetidas com backoff exponencial (3 tentativas, 1s/2s/4s)
Tempos limite de rede: 30s por solicitação
Erros 4xx (exceto 429) são exibidos imediatamente ao LLM com a mensagem original

Ferramentas — especificação completa

O esquema de entrada de cada ferramenta é exposto via tools/list do MCP e segue o JSON Schema. Execute npx @twitterapi_io/mcp-server com mcp-inspector para navegar interativamente:

npx @modelcontextprotocol/inspector npx -y @twitterapi_io/mcp-server

O que NÃO está incluído

Por design, este servidor expõe endpoints somente leitura. Os seguintes itens são intencionalmente excluídos para manter o servidor seguro para uso autônomo por agentes:

❌ Publicar tweets, curtidas, retweets, seguir, DMs
❌ Login de conta / 2FA
❌ Edição de perfil / banner / avatar
❌ Upload de mídia
❌ Exclusão de conta
❌ Stream em tempo real / configuração de webhook (não se encaixa no modelo de solicitação/resposta do MCP)

Esses recursos estão disponíveis na API REST do twitterapi.io completa — use-a diretamente se precisar de acesso de escrita.

Conformidade com a especificação

Construído sobre @modelcontextprotocol/sdk v1
Visa a especificação MCP 2025-11-25 (mais recente)
Transporte: stdio (Streamable HTTP planejado para v0.2+ para uso remoto/hospedado)
Testado com: mcp-inspector, Claude Desktop, Cursor, Claude Code

Desenvolvimento

git clone https://github.com/kaitoInfra/twitterapi-io-mcp-server.git
cd twitterapi-io-mcp-server
npm install
npm run build
TWITTERAPI_IO_API_KEY=xxx npm run inspect  # opens mcp-inspector