TwitterAPIs

Servidor MCP para a API do Twitter/X: 51 ferramentas que cobrem busca de tweets e usuários, perfis, timelines, seguidores, threads, listas, menções, curtidas, favoritos e DMs, além de ações de escrita.

Documentação

Servidor MCP do Twitter / X para Claude, Cursor e qualquer cliente MCP

O que é o servidor MCP do Twitter (X)?

O servidor MCP TwitterAPIs é um servidor do Model Context Protocol que dá ao Claude Desktop, Cursor, Cline e a qualquer agente compatível com MCP acesso nativo à API do Twitter/X. Pesquise tweets, leia perfis, seguidores, threads e listas, e publique, responda, curta, retweet ou siga a partir de uma conta vinculada, tudo com um único bearer token. Chamadas de leitura custam US$ 0,0008; ações de escrita são cobradas a partir de US$ 0,0008 (criação de tweet US$ 0,0016), as mesmas tarifas da API REST direta.

Cada tarifa aqui é o preço que a TwitterAPIs publica. A tarifa cobrada é de US$ 0,0008 por chamada de leitura; US$ 0,04 por 1.000 tweets é derivado disso em uma página completa de 20 tweets, o tamanho de página padrão, e não uma garantia de rendimento. De acordo com nossa própria especificação, 60 de 99 endpoints cobram essa tarifa (fonte: twitterapis.com/pricing).

Funciona no Claude Desktop, Cursor e em qualquer cliente MCP.

O que você pode construir com seis linhas de configuração

Os endpoints de leitura do TwitterAPIs se tornam ferramentas nativas dentro do seu cliente MCP. Sem código de integração, sem fluxo OAuth, sem revisão de escopo.

Peça ao Claude para encontrar tweets sobre qualquer assunto

Digite "encontre posts recentes sobre servidores MCP" no Claude Desktop e o agente chama o endpoint de busca avançada e resume os resultados em linha.

twitter_advanced_search

Traga os posts recentes de um perfil para o Cursor

Configure um comando de barra no Cursor que passe um perfil para a ferramenta twitter_user_tweets. A camada MCP busca os posts mais recentes e os retorna para rascunho ou análise.

twitter_user_tweets

Reconstrua uma thread completa com um agente Claude

Entregue ao Claude um ID de tweet e peça para ele puxar a conversa inteira. As ferramentas twitter_tweet_thread e twitter_tweet_replies retornam a árvore completa de respostas para resumo.

twitter_tweet_thread, twitter_tweet_replies

Crie um painel de análise do Twitter com Claude Artifacts

Entregue ao Claude um perfil e um intervalo de datas. O agente chama twitter_user_info, twitter_user_followers e twitter_user_tweets e, em seguida, renderiza um painel Recharts em um Artifact.

twitter_user_info, twitter_user_followers

Sincronize seguidores no Notion pelo Claude

Agende um agente Claude para chamar twitter_user_followers, deduplicar contra seu banco de dados do Notion e adicionar novas linhas. Sem código de integração, sem middleware Zapier.

twitter_user_followers

Monitor de menções que rascunha respostas

Execute um agente Cursor ou Claude que observa menções a cada 30 minutos, classifica por sinal e rascunha uma resposta que você pode revisar antes de enviar.

twitter_user_mentions

As ferramentas que o servidor expõe

O servidor mapeia a API do Twitter/X da TwitterAPIs em ferramentas MCP. Abaixo estão as que os agentes mais usam. As ferramentas de leitura funcionam apenas com sua chave de API, sem tela OAuth e sem conta de desenvolvedor X; as ações de escrita agem como uma conta X vinculada. Cada uma encapsula um endpoint que você também pode chamar diretamente via REST.

Ferramentas de busca e tweets

Somente TWITTERAPIS_KEY

  • twitter_advanced_search Busca avançada com operadores, filtros e intervalos de datas
  • twitter_tweet_detail Consulte um único tweet por ID com metadados completos
  • twitter_tweet_replies Traga as respostas de um tweet com paginação
  • twitter_tweet_retweeters Liste as contas que retweetaram um tweet
  • twitter_tweet_thread Reconstrua uma thread completa a partir de um ID de tweet

Ferramentas de usuário e grafo

Somente TWITTERAPIS_KEY

  • twitter_user_info Perfil, bio, contagens de seguidores e seguidos para um perfil
  • twitter_user_tweets Traga os posts recentes de um perfil
  • twitter_user_mentions Leia as menções de uma conta (uma busca to:username)
  • twitter_user_followers Liste os seguidores de uma conta com paginação
  • twitter_user_following Liste as contas que um perfil segue
  • twitter_user_verified_followers Liste os seguidores verificados de uma conta

Ferramentas de leitura adicionais

Somente TWITTERAPIS_KEY

  • twitter_user_search Busque usuários por palavra-chave ou fragmento de perfil
  • twitter_user_info_by_id Consulte um perfil de usuário por ID numérico
  • twitter_user_tweets_and_replies Traga os tweets e respostas de um perfil juntos
  • twitter_user_media Liste os tweets de mídia (imagens e vídeo) de um usuário
  • twitter_list_members Liste os membros de uma lista do X por ID da lista

Ações de escrita

Sessão X vinculada

  • twitter_create_tweet Publique um tweet, resposta ou citação
  • twitter_favorite_tweet Curta um tweet (desfaça com twitter_unfavorite_tweet)
  • twitter_retweet Retweet um post (desfaça com twitter_unretweet)
  • twitter_follow_user Siga uma conta (desfaça com twitter_unfollow_user)
  • twitter_dm_send Envie uma mensagem direta a um usuário

Quer as ferramentas de leitura sem a camada MCP? Elas encapsulam os mesmos endpoints por trás da nossa API de busca do Twitter e do scraper do Twitter, chamáveis via HTTP simples. Cada chamada de ferramenta é cobrada pelo preço padrão de US$ 0,0008 por leitura, e você só precisa de uma chave de API do Twitter no bloco de ambiente para começar.

Crie seu próprio servidor MCP ou use o nosso

A maioria dos servidores MCP do Twitter no GitHub são wrappers finos sobre a API oficial do X. Eles funcionam, mas você herda a configuração da API do X e seus limites. Aqui está a troca honesta em relação ao servidor TwitterAPIs.

Crie o seu próprio na API oficial do X

  • Solicite uma conta de desenvolvedor X e aguarde a aprovação.
  • Configure OAuth 1.0a ou OAuth 2.0 com PKCE, gerencie a renovação de tokens e armazene segredos por usuário.
  • Viva dentro dos limites de nível: o nível gratuito fica perto de 100 leituras por mês, e os endpoints de curtir e seguir foram removidos dele em 2025. O Basic custa US$ 200 por mês.
  • Mantenha o tratamento de limite de taxa e os fallbacks v1.1 para v2 você mesmo.

O servidor MCP TwitterAPIs (ao vivo no npm)

  • Uma linha para instalar e uma chave de API no bloco de ambiente, sem revisão de conta de desenvolvedor.
  • As ferramentas de leitura funcionam apenas com sua chave. Sem tela OAuth para configurar para busca, perfis e seguidores.
  • As ações de escrita (publicar, curtir, retweet, seguir, DM) agem como uma conta X vinculada, cobradas a partir de US$ 0,0008.
  • Pague por chamada a partir de US$ 0,0008, sem assinatura mensal e sem limite de nível nos endpoints de leitura.
  • Código aberto no GitHub. Os mesmos endpoints de leitura também podem ser chamados via REST com a mesma chave.

Configuração para Claude Desktop, Cursor, Windsurf, Cline

O mesmo bloco de configuração funciona em todos os clientes MCP. Cada ferramenta de leitura precisa apenas do seu TWITTERAPIS_KEY, sem tela OAuth e sem conta de desenvolvedor X.

{
  "mcpServers": {
    "twitterapis": {
      "command": "npx",
      "args": ["-y", "@twitterapis/mcp@latest"],
      "env": { "TWITTERAPIS_KEY": "YOUR_API_KEY" }
    }
  }
}

FAQ

Tudo o que os desenvolvedores perguntam antes de migrar sua stack da API do X para MCP.

O que é o Model Context Protocol (MCP)?

MCP é um protocolo aberto da Anthropic para conectar assistentes de IA a ferramentas e dados externos. Um servidor MCP expõe um conjunto de ferramentas (com entradas e saídas tipadas) que qualquer cliente compatível (Claude Desktop, Cursor, Cline, Continue, outros) pode chamar durante uma conversa. O servidor MCP TwitterAPIs transforma a API do Twitter/X da TwitterAPIs em ferramentas MCP para que o Claude possa buscar tweets, buscar perfis, listar seguidores, ler threads, publicar e muito mais.

Como o servidor MCP TwitterAPIs se compara à API oficial do X?

A API oficial do X (Twitter) exige uma assinatura paga, uma solicitação de conta de desenvolvedor e um fluxo OAuth por usuário. A TwitterAPIs é paga por chamada a partir de US$ 0,0008 por requisição, sem assinaturas e sem revisão de conta de desenvolvedor. O servidor MCP adiciona zero sobrecarga além da sua chave de API TwitterAPIs existente. Mesmos endpoints e preços de chamar a TwitterAPIs diretamente, apenas expostos como ferramentas MCP.

Quanto custa usar o servidor MCP?

Nada extra pelo servidor em si. Cada chamada de ferramenta atinge o endpoint subjacente da TwitterAPIs e é cobrada pela tarifa padrão de US$ 0,0008 por chamada de leitura (busca, perfil, seguidores, threads). Seus primeiros US$ 0,50 em chamadas são por nossa conta.

Com quais clientes MCP isso funciona?

Qualquer cliente que implemente a especificação MCP: Claude Desktop, Cursor, Cline (VS Code), Continue e qualquer runtime compatível com MCP, incluindo agentes personalizados construídos no SDK da Anthropic com a camada de transporte MCP.

O servidor MCP pode publicar tweets ou escrever no X?

Sim. Junto com as ferramentas de leitura, o servidor expõe ações de escrita: criar um tweet (resposta ou citação), curtir, retweet, favoritar, seguir e enviar DM. As ações de escrita agem como uma conta X vinculada (ou credenciais inline por chamada) em vez de apenas sua chave de API, e como o X bloqueia suavemente escritas de IPs de datacenter, elas passam por um proxy residencial. A criação de tweet custa US$ 0,0016 por chamada e as ações de escrita mais simples custam US$ 0,0008.

Como posso dar acesso ao Twitter ao Claude hoje?

Instale o servidor MCP com npx -y @twitterapis/mcp@latest, adicione o bloco de configuração ao seu cliente MCP (Claude Desktop, Cursor ou Cline) e reinicie o cliente. As ferramentas aparecem automaticamente. Você também pode chamar os endpoints REST da TwitterAPIs diretamente: cada um é um único HTTP GET com um cabeçalho Authorization: Bearer TWITTERAPIS_KEY, sem conta de desenvolvedor X e sem tela OAuth.

Como começo?

Cadastre-se em twitterapis.com/signup, gere uma chave de API no painel e execute npx -y @twitterapis/mcp@latest. Coloque sua chave na variável de ambiente TWITTERAPIS_KEY na configuração do seu cliente MCP. Envie um e-mail para emma@twitterapis.com se tiver dúvidas.

O servidor MCP TwitterAPIs já está disponível?

Sim. O servidor MCP está publicado no npm como @twitterapis/mcp e tem código aberto no GitHub. Instale-o com npx -y @twitterapis/mcp@latest e adicione um pequeno bloco de configuração ao seu cliente MCP. Você também pode chamar cada endpoint diretamente via HTTP simples com sua chave bearer; veja as páginas da API de busca do Twitter e do scraper do Twitter.

Como o servidor MCP TwitterAPIs é diferente do servidor MCP oficial do X?

O X lançou seu próprio servidor MCP hospedado em api.x.com/mcp em junho de 2026, e ele é uma boa opção se você já opera na API oficial do X: ele autentica com suas próprias credenciais de desenvolvedor X via OAuth 2.0 e cobra pelos preços da própria API do X, que não tem nível gratuito e exige uma conta de desenvolvedor aprovada. O servidor MCP TwitterAPIs é feito para o caso em que você não quer essa configuração. Ele autentica com um único bearer token do cadastro, não precisa de conta de desenvolvedor X nem fluxo OAuth, expõe o conjunto completo de ferramentas de leitura e escrita (busca, perfis, grafo de seguidores, threads, além de publicar, curtir, retweet e DM) e cobra por chamada a partir de US$ 0,0008 por requisição, o que dá cerca de US$ 0,04 por 1.000 tweets quando uma chamada retorna uma página completa de 20 tweets, com um crédito inicial de US$ 0,50. Use o servidor do X se quiser a opção nativa da plataforma e já paga pela API do X; use este para o caminho mais barato de pagamento por uso para dados do Twitter e do X dentro de um agente, sem revisão de conta de desenvolvedor.

Preciso de uma chave de API TwitterAPIs?

Sim. Cadastre-se em twitterapis.com/signup (Google ou e-mail), gere uma chave de API no painel e coloque-a no bloco de ambiente da configuração do seu cliente MCP (TWITTERAPIS_KEY). O servidor MCP lê a chave na inicialização e a encaminha em cada chamada de ferramenta. A mesma chave também funciona nos endpoints REST.

O que posso ler pelo servidor MCP?

O servidor expõe a superfície de leitura da TwitterAPIs como ferramentas MCP: busca avançada de tweets (twitter_advanced_search), detalhe de tweet único (twitter_tweet_detail), respostas, retweeters, threads, informações e busca de usuários, timelines de usuários, menções, grafo de seguidores e seguidos, seguidores verificados e membros de listas. Cada chamada é controlada pela sua chave de API TwitterAPIs.

Há limite de taxa no servidor MCP?

O servidor MCP em si não é medido. A API subjacente da TwitterAPIs aplica limites padrão de uso justo por conta, que ficam bem acima do que uma sessão interativa do Claude ou Cursor pode atingir. Se você estiver executando um agente em lote de alto throughput, envie um e-mail para emma@twitterapis.com e aumentaremos o teto.

Existe um servidor MCP do Twitter gratuito?

O servidor MCP TwitterAPIs é gratuito para instalar. As chamadas são cobradas por requisição a partir de US$ 0,0008, e seus primeiros US$ 0,50 de uso são gratuitos, o que cobre cerca de 625 chamadas de leitura antes de você gastar um centavo. A maioria dos servidores MCP do Twitter de código aberto são gratuitos para executar, mas ficam em cima da API oficial do X, onde o nível gratuito limita você a cerca de 100 leituras por mês e removeu os endpoints de curtir e seguir em 2025. A TwitterAPIs não tem limite mensal nem portões de nível nos endpoints de leitura.

Onde nos encontrar

A TwitterAPIs está listada em marketplaces de desenvolvedores e é coberta pela comunidade. O servidor MCP está publicado no npm como @twitterapis/mcp e tem código aberto no GitHub.

Pronto para dar a Claude um cérebro de Twitter/X?

Instale o servidor MCP com um único comando, ou chame os endpoints de leitura diretamente via REST. $0,50 em créditos gratuitos cobrem as primeiras 625 chamadas.