Servidor MCP da Sorsa API

Dados ao vivo do X (Twitter) como 40 ferramentas nativas para Claude, Cursor e qualquer cliente MCP. Um comando para instalar, somente leitura, sem conta de desenvolvedor do X.

$npx -y sorsa-mcp

Visão geral

O que é

MCP (Model Context Protocol) é o padrão aberto que permite a um cliente de IA chamar ferramentas externas de um jeito uniforme. O servidor MCP da Sorsa API é a peça do X (Twitter) nesse padrão: ele embrulha os endpoints somente leitura da Sorsa API para que qualquer cliente compatível com MCP ganhe ferramentas de busca de tweets e leitura de perfis, seguidores, respostas, menções, trending topics e mais. Você pede em linguagem natural, o modelo escolhe a ferramenta certa e a chama. É somente leitura por design: sem postar, sem login e sem scraping.


Ferramentas

As ferramentas que a sua IA recebe

O servidor expõe 40 ferramentas, uma por endpoint da Sorsa API, e devolve apenas dados públicos do X. O modelo escolhe a certa para cada pedido. A tabela abaixo mostra as mais usadas.

FerramentaO que devolveUso típico
search_tweetsBusca avançada de tweets com o conjunto completo de operadores (from:, since:, lang:, min_faves:).Monitoramento de temas, montagem de datasets
search_usersContas que combinam com uma palavra-chave ou frase.Descoberta de audiência e de leads
get_user_infoPerfil completo por @ ou por ID: bio, número de seguidores, verificação.Consulta e enriquecimento de contas
get_followersOs seguidores de uma conta com metadados, paginados.Análise de audiência e de rede
get_followingAs contas que um usuário segue.Mapeamento do grafo de interesses
get_user_tweetsTweets recentes da timeline de um usuário.Acompanhamento de atividade e resumos
get_tweet_infoDados completos de um tweet por URL ou ID, com autor. O get_tweet_info_bulk cobre até 100 tweets em uma chamada.Enriquecer tweets com métricas
get_tweet_commentsA thread de respostas embaixo de um tweet.Análise de conversa
get_tweet_quotesCitações de um tweet.Análise de alcance e de discurso
get_retweetersAs contas que deram retweet em um tweet.Amplificação e alcance
search_mentionsTweets que mencionam uma conta, com filtros de curtidas, respostas e data.Monitoramento de marca e reputação
get_trendsTrending topics de uma localidade, por WOEID.Detecção de tendências e conteúdo oportuno
check_follow, check_retweet, check_quoted, check_comment, check_community_memberVerifica se um usuário seguiu, deu retweet, comentou, citou ou entrou em uma comunidade.Verificação de campanhas e sorteios

Além disso, ferramentas de listas, comunidades, Sorsa Score e utilitários, 40 no total. O conjunto completo de endpoints está na documentação.


Instalação

Instale e conecte

O servidor roda localmente pelo npx, então não há nada para clonar nem compilar. Adicione a configuração do seu cliente, defina a sua chave da Sorsa API e reinicie.

Um comando no terminal, nada para colar em arquivo de configuração.

claude mcp add --transport stdio --env SORSA_API_KEY=YOUR_API_KEY sorsa -- npx -y sorsa-mcp

Todos os clientes usam o mesmo bloco padrão. Basta trazer a sua chave da Sorsa API e reiniciar o cliente depois de adicioná-la.


Autenticação

Pegue a sua chave de API

O servidor se autentica com a sua própria chave da Sorsa API, passada pela variável de ambiente SORSA_API_KEY na configuração acima. Entre na conta, copie a chave, cole e reinicie o cliente. Suas primeiras 100 requisições são grátis: sem cartão e sem prazo de validade.

1

Entre na Sorsa API e abra o seu painel.

2

Copie a sua chave de API.

3

Cole como SORSA_API_KEY e reinicie o cliente.


Na prática

Como é uma requisição

Com o servidor conectado você nunca chama a API direto. Você pede em linguagem natural, o cliente escolhe a ferramenta, faz a chamada e lê o resultado de volta.

1

Você pede, no Claude ou no Cursor, em linguagem natural: "Traga o perfil do @naval."

2

O cliente escolhe a ferramenta e faz a chamada.

chamada de ferramenta
{
  "name": "get_user_info",
  "arguments": { "username": "naval" }
}
3

O servidor devolve dados ao vivo.

resposta
{
  "username": "naval",
  "display_name": "Naval",
  "followers_count": 2600000,
  "followings_count": 800,
  "verified": true,
  "created_at": "2007-04-09T17:51:23Z"
}
4

O cliente responde em linguagem natural, em tabela ou no formato que você pediu. Sem código de cola e sem tratar rate limit do seu lado.

O mesmo padrão vale para todas as ferramentas. "O que está bombando nos EUA" vai para o get_trends, "tweets recentes do @sama sobre IA" vai para o search_tweets e "o @user deu retweet nisso" vai para o check_retweet.


Por que a Sorsa API

Por que a Sorsa API é a API por trás disso

O servidor vale o que vale a API por trás dele.

Sem conta de desenvolvedor

Sem aprovação do X, sem análise de app, só uma chave.

Preço fixo

1 requisição equivale a 1 chamada em todos os endpoints e planos, então os loops do agente ficam previsíveis.

20 req/s em todos os planos

Seu cliente não é estrangulado conforme você cresce.

Somente leitura e seguro

As ferramentas leem dados públicos do X, mas nunca postam, apagam ou seguem.


Perguntas frequentes

Perguntas frequentes

É um servidor MCP que dá ao Claude, ao Cursor e a qualquer cliente MCP ferramentas somente leitura para dados ao vivo do X (Twitter): busca, perfis, seguidores, tweets, menções, trending topics e verificação. Instale uma vez e a sua IA passa a chamar essas ferramentas sozinha.

Com qualquer cliente compatível com MCP: Claude Desktop, Claude Code, Cursor, VS Code com GitHub Copilot, Windsurf e outros. A configuração é o mesmo bloco padrão em todos.

O servidor é de código aberto no GitHub. Ele chama a Sorsa API, então você traz a sua própria chave e paga só pelas requisições que as ferramentas fizerem. Suas primeiras 100 requisições são grátis: sem cartão e sem prazo de validade.

Precisa. O servidor lê a sua chave da variável de ambiente SORSA_API_KEY. Criar uma chave leva alguns minutos no painel.

Não. Todas as ferramentas são somente leitura. O servidor lê dados públicos do X, mas nunca posta, responde, curte, segue ou envia DMs, o que mantém agentes autônomos seguros.

A API oficial do X exige conta de desenvolvedor, tranca o acesso atrás de planos caros e não foi feita para MCP. A Sorsa API dispensa conta de desenvolvedor, cobra preço fixo por requisição e chega como ferramentas MCP nativas.

Não. A configuração sobe o servidor pelo npx, que baixa a versão mais recente sozinho. Você define a sua chave e reinicia o cliente.

Cole o endereço da documentação da Sorsa API no seu LLM e ele escreve o código de integração para você. Veja Construa com IA.

Dê ao seu cliente de IA dados ao vivo do X

Instale o servidor, coloque a sua chave e o Claude ou o Cursor já busca tweets e lê perfis, seguidores e trending topics na próxima mensagem que você mandar. Suas primeiras 100 requisições são grátis: sem cartão e sem prazo de validade.