Servidor MCP do Twitter: 3 tipos e uma configuração em 1 linha

#O que um servidor MCP do Twitter faz

Um servidor MCP do Twitter é um programa pequeno que entrega a um agente de IA um conjunto de ferramentas para o X, como "buscar posts" ou "listar seguidores", por meio do Model Context Protocol (abre em uma nova aba), o padrão aberto que o Claude, o Cursor, o Codex e o VS Code usam para chamar ferramentas externas.

Você pede em palavras simples. O agente escolhe uma ferramenta, preenche os argumentos e a chama; o servidor transforma a chamada em uma requisição de dados do X, devolve o JSON, e o agente responde a partir dele. Você nunca escreve a requisição, e o agente pode encadear várias chamadas para concluir um trabalho, como uma busca seguida de uma consulta de perfil para cada autor encontrado.

O protocolo é gratuito e aberto, e o código da maioria dos servidores também. O que um servidor custa, e o que ele pode fazer com a sua conta do X, vem da conexão por trás dele: de quem são as credenciais que ele guarda e quem cobra cada leitura. Essa conexão divide os servidores MCP do Twitter em três tipos, e ela decide mais do que a lista de ferramentas.

#Os três tipos de servidor MCP do Twitter

Todo servidor MCP do Twitter chega ao X por uma de três conexões: o seu próprio app de desenvolvedor do X, a sua conta do X logada ou uma chave de API de dados. A conexão decide o que você configura, quanto custa uma leitura e o que o seu agente pode fazer com a sua conta.

Só o tipo com chave de dados deixa a sua conta do X totalmente de fora, e ele lê posts por uma pequena fração da tarifa oficial:

• Com uma chave de API de dados (o sorsa-mcp da Sorsa API)

  O que você configura

  Uma chave da Sorsa API

  Ler 1.000 posts

  A partir de US$ 0,014 por ID, a partir de US$ 0,07 pela busca

  O agente pode postar?

  Não, somente leitura por projeto

  Sua conta do X

  Nunca conectada

• Com o seu app de desenvolvedor do X (o MCP oficial do X, servidores de código aberto sobre a API oficial do X)

  O que você configura

  Um app do X com OAuth, as chaves dele e créditos pré-pagos

  Ler 1.000 posts

  US$ 5,00, a US$ 0,005 por post

  O agente pode postar?

  Depende do servidor e do acesso de escrita do seu app

  Sua conta do X

  Seu app age por você

• Com o seu login do X (servidores que entram como você)

  O que você configura

  Seu username e senha do X, ou cookies de sessão

  Ler 1.000 posts

  Definido pelo fornecedor

  O agente pode postar?

  Sim, como você

  Sua conta do X

  Logada por um bot, então pode ser sinalizada

Seis perguntas resolvem a escolha para um agente que lê o X: o que você configura antes da primeira chamada, quanto custa uma leitura, se o agente pode postar, se a sua conta do X está envolvida, com que velocidade ele responde e quanto do contexto do agente as ferramentas ocupam. A tabela resolve as quatro primeiras; o MCP oficial do X abaixo e a seção de configuração depois dele respondem ao resto para cada tipo.

#O MCP oficial do X: o que exige e o que cobra

O MCP oficial do X exige o seu próprio app de desenvolvedor do X e cobra cada chamada pelas tarifas de pagamento por uso da API oficial do X. O X lançou o servidor hospedado em api.x.com/mcp em 30 de junho de 2026 (anúncio do X (abre em uma nova aba)), e a documentação de MCP (abre em uma nova aba) dele lista o que uma configuração funcional pede:

• um app do X no Developer Console com OAuth 2.0 e o redirect URI http://localhost:8080/callback;
• o client ID e o segredo do app na configuração do seu agente, lidos pelo xurl, uma ponte local que roda via npx;
• um login único no navegador, com o timeout de inicialização do cliente elevado para pelo menos 300 segundos;
• o app movido para o pacote Pay-per-use do X, ou o login termina em client-not-enrolled.

Uma rota mais curta envia um Bearer token somente do app, do mesmo app, e o X o marca como somente leitura. De um jeito ou de outro, a conta de desenvolvedor vem primeiro; o nosso guia da API do Twitter sem conta de desenvolvedor percorre tudo o que ela envolve.

As ferramentas do servidor leem posts com seus curtidores, repostadores e quoters, fazem busca no arquivo completo e consultam usuários, timelines, menções, notícias e trends. As escritas dele são bookmarks e Articles; a documentação do X não lista nenhuma ferramenta que crie um post. Cada leitura é cobrada pelas tarifas da API oficial do X (abre em uma nova aba): US$ 0,005 por post e US$ 0,010 por usuário, até 3 milhões de leituras de posts por mês antes de o X pedir um contrato Enterprise. A partir de 22 de novembro de 2026, o X também cobra os autores e a mídia que voltam com os posts, a US$ 0,010 por usuário (aviso do X (abre em uma nova aba)). O nosso detalhamento dos preços da API do X tem a tabela de tarifas completa.

#Configure o servidor MCP da Sorsa em uma linha

Para um agente que faz pesquisa, monitoramento, listas de leads ou verificações no X, adicione o servidor MCP da Sorsa API: um comando no Claude Code ou no Codex, ou um bloco JSON no Cursor e no VS Code, com a sua chave em SORSA_API_KEY, e as primeiras 100 chamadas de ferramenta são grátis.

Ele responde às seis perguntas com números: uma chave de API, tweets a partir de US$ 0,014 por 1.000, zero ferramentas de escrita, nenhuma conta do X em risco, 20 requisições por segundo em todos os planos e 40 definições de ferramenta em cerca de 5.800 tokens. Postar é o único trabalho que ele deixa de fora de propósito; para postar, combine-o com a API oficial do X, que mantém as escritas no seu próprio app. O servidor roda no seu computador e transforma cada chamada de ferramenta em uma requisição, seja qual for das 40 ferramentas, devolva ela um perfil ou 100 posts.

Você precisa do Node.js 18 ou mais novo (confira com node -v) e de um app que rode servidores MCP locais. A página do servidor MCP da Sorsa guarda a linha de cada agente em um só lugar.

1. Obtenha uma chave. Cadastre-se com seu e-mail ou conta do Google. O painel mostra a sua chave de API; as primeiras 100 requisições não pedem cartão e nunca expiram.

2. Adicione o servidor ao seu agente. Coloque sua chave no lugar de YOUR_API_KEY. O Claude Code e o Codex aceitam uma linha no terminal, e -s user deixa a Sorsa API disponível em todos os projetos do Claude Code. O Cursor lê um bloco JSON de ~/.cursor/mcp.json para todos os projetos ou de .cursor/mcp.json para um só; o VS Code lê .vscode/mcp.json e pede a chave uma vez, de modo que ela nunca fique no arquivo.

   claude mcp add sorsa -s user -e SORSA_API_KEY=YOUR_API_KEY -- npx -y sorsa-mcp
   

   codex mcp add sorsa --env SORSA_API_KEY=YOUR_API_KEY -- npx -y sorsa-mcp
   

   {
     "mcpServers": {
       "sorsa": {
         "command": "npx",
         "args": ["-y", "sorsa-mcp"],
         "env": { "SORSA_API_KEY": "YOUR_API_KEY" }
       }
     }
   }
   

   {
     "inputs": [{ "type": "promptString", "id": "sorsa-key",
       "description": "Sorsa API key", "password": true }],
     "servers": {
       "sorsa": {
         "type": "stdio",
         "command": "npx",
         "args": ["-y", "sorsa-mcp"],
         "env": { "SORSA_API_KEY": "${input:sorsa-key}" }
       }
     }
   }
   

3. Confira se funciona. Pergunte ao seu agente "Quantas requisições da Sorsa API ainda tenho?". Ele chama get_key_usage_info, que lê GET /key-usage-info (abre em uma nova aba) e nunca conta contra as suas requisições; um número na resposta significa que o agente, o servidor e a chave estão conectados. No Claude Code, claude mcp get sorsa também deve dizer "Connected".

4. Faça uma pergunta de verdade. Tente "Encontre os 50 posts mais curtidos sobre servidores MCP desta semana e agrupe-os por tema". O agente a transforma em uma chamada search_tweets como a abaixo, repete-a três ou quatro vezes com o next_cursor que cada resposta devolve, cerca de 20 posts por chamada, e escreve o resumo a partir dos resultados.

   {
     "name": "search_tweets",
     "arguments": {
       "query": "\"mcp server\" min_faves:20 since:2026-10-26",
       "order": "popular"
     }
   }
   

Bom saber

No Claude Code, o nome do servidor vem antes de -e. Uma linha como claude mcp add --env SORSA_API_KEY=... sorsa -- npx -y sorsa-mcp falha com "Invalid environment variable format: sorsa" (formato de variável de ambiente inválido), porque --env aceita vários valores e lê o nome como mais um deles.

Tudo depois de -- pertence ao comando do servidor, então um -e colocado no fim nunca chega ao servidor, e ele para na inicialização, sem chave. Rodamos as três formas no Claude Code 2.1.314; só a linha acima conecta.

#Linhas para outros apps MCP

Qualquer app que rode servidores MCP locais inicia o sorsa-mcp com as mesmas três configurações: o comando npx, os argumentos -y sorsa-mcp e a sua chave como SORSA_API_KEY no ambiente dele. O Grok Build e o OpenClaw o adicionam por um terminal, e o Hermes Agent o lê do arquivo de configuração:

grok mcp add sorsa -e SORSA_API_KEY=YOUR_API_KEY -- npx -y sorsa-mcp

openclaw mcp add sorsa --command npx --arg -y --arg sorsa-mcp \
  --env SORSA_API_KEY=YOUR_API_KEY

mcp_servers:
  sorsa:
    command: "npx"
    args: ["-y", "sorsa-mcp"]
    env:
      SORSA_API_KEY: "YOUR_API_KEY"

Onde cada um fica e como ver que conectou:

• Claude Desktop: cole o bloco do Cursor no arquivo que Settings, Developer, Edit Config abre, saia do app por completo e abra-o de novo; as ferramentas ficam sob "+".
• Gemini CLI: cole o bloco do Cursor em ~/.gemini/settings.json e confira com /mcp.
• Grok Build: confira com grok mcp doctor sorsa.
• OpenClaw: confira com openclaw mcp doctor sorsa --probe.
• Hermes Agent: adicione o bloco a ~/.hermes/config.yaml e rode /reload-mcp na sua sessão.

O Claude.ai, o ChatGPT e o grok.com no navegador adicionam servidores só por URL, então não conseguem iniciar um servidor no seu computador: use o Claude Desktop ou o Claude Code com a mesma chave. Prompts prontos que põem o servidor para trabalhar estão em crie com IA.

#O que o seu agente pode ler: 40 ferramentas

O servidor MCP da Sorsa API tem 40 ferramentas, uma para cada endpoint da API que ele cobre, e todas leem dados públicos do X. O agente as escolhe pelo nome a partir do seu pedido, então você raramente precisa saber qual é qual; veja o que uma chamada traz em cada grupo:

• Busca, cerca de 20 posts ou contas por chamada, com operadores de busca do X, desde 2006: search_tweets, search_users, search_mentions.
• Posts, até 100 posts por ID por chamada, cada um com o perfil completo do autor: get_tweet_info, get_tweet_info_bulk, get_tweet_comments, get_tweet_quotes, get_retweeters, get_article, get_trends.
• Contas, até 100 perfis por chamada, ou uma timeline de 20 posts por vez: get_user_info, get_user_info_batch, get_account_about, get_user_tweets.
• Seguidores, até 200 por página: get_followers, get_following, get_verified_followers.
• Verificações, um sim ou um não por chamada: check_follow, check_retweet, check_quoted, check_comment, check_community_member.
• Listas, Comunidades e Spaces, membros, feeds e detalhes de Spaces: get_list_members, get_list_tweets, get_list_followers, get_community_members, get_community_tweets, search_community_tweets, get_space_info.
• Utilitários, IDs e as requisições que você ainda tem: username_to_id, id_to_username, link_to_id, get_key_usage_info.

Mais sete ferramentas devolvem dados do Sorsa Score para contas de cripto. As ferramentas em lote são onde um agente mais economiza: get_tweet_info_bulk roda POST /tweet-info-bulk (abre em uma nova aba) e get_user_info_batch roda GET /info-batch (abre em uma nova aba), 100 itens por uma requisição, e check_follow responde a POST /check-follow (abre em uma nova aba) em uma chamada em vez de paginar uma lista de seguidores.

Nenhuma ferramenta posta, responde, curte, segue nem envia DMs, e nenhuma devolve quem curtiu um post, as curtidas ou bookmarks de um usuário, DMs ou contas protegidas: o servidor lê apenas dados públicos.

#Quanto custa uma chamada de ferramenta

Uma chamada de ferramenta na Sorsa API custa uma requisição, a partir de US$ 0,0014, seja o que for que ela devolva; o MCP oficial do X cobra cada item dentro da chamada, então a mesma busca de 20 posts custa US$ 0,10 a US$ 0,005 por post.

A diferença cresce com o tamanho da resposta, porque a Sorsa API devolve até 200 itens pelo preço de uma requisição e inclui o autor de cada post sem custo extra:

• search_tweets

  O que devolve

  Cerca de 20 posts

  Sorsa API

  A partir de US$ 0,0014

  Tarifas da API oficial do X

  US$ 0,10

  Com autores, a partir de 22 de nov.

  Até US$ 0,30

• get_tweet_info_bulk

  O que devolve

  100 posts

  Sorsa API

  A partir de US$ 0,0014

  Tarifas da API oficial do X

  US$ 0,50

  Com autores, a partir de 22 de nov.

  Até US$ 1,50

• get_user_info_batch

  O que devolve

  100 perfis

  Sorsa API

  A partir de US$ 0,0014

  Tarifas da API oficial do X

  US$ 1,00

  Com autores, a partir de 22 de nov.

  US$ 1,00

• get_followers

  O que devolve

  200 seguidores

  Sorsa API

  A partir de US$ 0,0014

  Tarifas da API oficial do X

  US$ 2,00

  Com autores, a partir de 22 de nov.

  US$ 2,00

Na escala de um mês, os resultados de busca por POST /search-tweets (abre em uma nova aba) custam a partir de US$ 0,07 por 1.000 na Sorsa API, contra US$ 5,00 por 1.000 posts nas tarifas da API oficial do X. As consultas por ID vêm de 100 em 100 por chamada, a partir de US$ 0,014 por 1.000, e as listas de seguidores por GET /followers (abre em uma nova aba) a partir de US$ 0,007 por 1.000. Escolha o tamanho do mês do seu agente:

A velocidade acompanha o preço: a Sorsa API responde a 20 requisições por segundo em todos os planos, contas gratuitas incluídas, o que dá até 2.000 tweets por segundo em consultas em lote. Uma chamada que falha não custa nada, porque requisições com falha nunca são cobradas.

#Por que um servidor somente leitura combina com um agente

Um servidor somente leitura não consegue postar, seguir nem pagar por escritas, então um agente confuso ou preso em loop só pode gastar requisições, nunca agir no X em seu nome.

• Nenhuma ferramenta escreve. Não existe ferramenta de postar, responder, curtir, seguir ou enviar DM, e a API por trás do servidor não tem esse endpoint. Se você pedir post_tweet, o servidor responde "Tool post_tweet not found" (ferramenta não encontrada).
• Um único destino. O servidor roda no seu computador, e o código dele envia cada chamada para https://api.sorsa.io/v3 com a sua chave no header ApiKey. O código-fonte está no GitHub (abre em uma nova aba) sob a licença MIT.
• Nenhuma conta do X. A Sorsa API nunca pede seu login, cookies ou app do X.
• Um teto de gasto. Uma chave faz no máximo 20 requisições por segundo, e no pague pelo uso um limite de gasto, de US$ 100 por padrão, limita cada período de cobrança.

As ferramentas também pesam pouco no contexto do agente. As 40 definições de ferramenta somam cerca de 23 mil caracteres, aproximadamente 5.800 tokens, e o Claude Code carrega só os nomes delas até precisar de uma. Os resultados são JSON completo com o perfil de cada autor, então peça o que você precisa ("os 50 posts mais novos"): o Claude Code avisa quando o resultado de uma ferramenta passa de 10 mil tokens.

Bom saber

O texto dentro dos posts é dado, não instrução. Um agente que lê o X vai encontrar posts escritos para manipular agentes de IA; com um servidor somente leitura, o máximo que um post assim pode lhe custar é uma requisição desperdiçada. Mantenha as outras ferramentas do agente, como enviar e-mail ou editar arquivos, sob a sua aprovação.

#Corrija uma configuração que não conecta

A maioria das configurações que falham se resume ao lugar da chave, a um Node.js ausente ou a um app que não recarregou seus servidores. Compare com o que você vê:

• Invalid environment variable format: sorsa no Claude Code

  Por quê

  O nome do servidor está logo depois de --env

  Correção

  Ponha o nome primeiro: claude mcp add sorsa -s user -e ...

• "Failed to connect", e o ambiente do servidor está vazio

  Por quê

  O -e veio depois de --, então foi para o npx

  Correção

  Mova -e SORSA_API_KEY=... para antes de --

• npx: command not found

  Por quê

  O Node.js não está instalado

  Correção

  Instale o Node.js 18 ou mais novo e reinicie o app

• Missing SORSA_API_KEY environment variable

  Por quê

  A configuração não tem chave

  Correção

  Adicione SORSA_API_KEY ao env do servidor

• Toda chamada devolve 401 invalid api key

  Por quê

  A chave foi digitada errada

  Correção

  Cole-a de novo a partir do painel, sem espaços

• As chamadas devolvem 403 depois de um tempo

  Por quê

  Suas requisições acabaram

  Correção

  Mude de plano ou ative o pague pelo uso; a mesma chave continua funcionando

• O servidor foi adicionado, mas não mostra ferramentas

  Por quê

  O app não recarregou

  Correção

  Saia do Claude Desktop por completo, rode /reload-mcp no Hermes ou ative o sorsa no Cursor

• Um timeout na primeiríssima inicialização

  Por quê

  O npx está baixando o pacote

  Correção

  Inicie de novo, ou defina startup_timeout_sec = 30 no Codex

Ainda travado? Peça ao agente que chame get_key_usage_info e mostre o resultado bruto: um número significa que a chave chega à Sorsa API, e um erro diz o que falta.

#Dê dados do X ao seu agente hoje

Adicione o servidor MCP da Sorsa API e o seu agente lê o X por 40 ferramentas somente leitura: uma linha no Claude Code ou no Codex, tweets a partir de US$ 0,014 por 1.000 em vez de US$ 5,00 nas tarifas da API oficial do X, 20 requisições por segundo e nenhuma conta sua do X em qualquer ponto da cadeia. As primeiras 100 chamadas de ferramenta são grátis. Para agentes que chamam dados do X sem MCP, por REST simples ou pela skill de agente, leia o nosso guia da API do Twitter para agentes de IA.

#Perguntas frequentes