Dê a Claude (ou Cursor) dados de mercado de previsão Polymarket ao vivo com um servidor MCP

Polymarket tem uma API pública. Seu agente de IA — Claude Desktop, Cursor, Cline — não a compreende. Então, quando você pergunta "quais mercados de previsão acabaram de colapsar?" o agente ou inventa algo, coleta informações de uma wiki desatualizada ou recusa educadamente.

Eu me cansei disso. polymarket-mcp-pro é um servidor Model Context Protocol que expõe sete ferramentas somente leitura para qualquer cliente compatível com MCP. O agente pode listar mercados por volume, puxar instantâneas de preços históricos, encontrar colapsos recentes e inspecionar a profundidade do livro de ordens — tudo através de uma superfície de ferramenta JSON estruturada, sem código HTTP em seus prompts.

É gratuito, open source e respaldado por um conjunto de dados real (não uma demonstração de brinquedo).

Os números por trás disso

O servidor MCP é apenas a interface voltada para o agente. A camada de dados por trás dele é api.protodex.io, que indexa:

• 13.964 mercados Polymarket
• 10,8M+ instantâneas de preços (uma a cada 15 minutos por mercado ativo)
• $11,7B+ de volume cumulativo coberto
• Atualizado continuamente, servido através de uma superfície REST estável

Quando você pergunta ao agente "mostre-me os mercados que caíram 15% nas últimas 4 horas", ele está operando contra todo esse corpus, não uma amostra de 10 mercados.

Instale em 30 segundos

Se você tem uv:

uvx --from polymarket-mcp-pro polymarket-mcp

Ou, pip clássico:

pip install polymarket-mcp-pro

O nome da distribuição PyPI é polymarket-mcp-pro porque o simples polymarket-mcp foi tomado por um pacote não relacionado. O CLI e o caminho de importação permanecem polymarket_mcp.

Conecte ao Claude Desktop

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

{
  "mcpServers": {
    "polymarket": {
      "command": "uvx",
      "args": ["polymarket-mcp"]
    }
  }
}

Reinicie o Claude Desktop. As ferramentas polymarket aparecem no seletor de ferramentas.

Cursor: mesmo bloco JSON em Configurações → Recursos → Servidores MCP. Cline, Continue, qualquer outro cliente MCP via stdio: mesmo comando.

As sete ferramentas

Tudo é somente leitura. Não há colocação de ordens, não há assinatura, não há carteira. O agente observa; você decide.

Para que eu realmente uso isso

Três fluxos de trabalho, reais e não hipotéticos:

1. Scanner de colapsos como uma rotina matinal. "Execute get_crashes com limite de 15% em 4 horas, filtre para volume > $100k, resuma os 5 principais." O agente retorna com uma lista estruturada e um parágrafo sobre o que cada mercado é. Na maioria dos dias, zero correspondências. Em alguns dias, algo interessante.

2. Pesquisando um evento noticioso. Quando algo acontece no mundo que tem mercados de previsão — eleição, decisão, reunião de banco central — eu peço ao agente para puxar todos os mercados relacionados, além de sua ação de preço nas últimas 24h. O agente escolhe os mercados certos via pesquisa; os dados são frescos porque são consultados no momento do prompt, não a partir de dados de treinamento.

3. Construindo notas de estratégia. Eu mantenho um arquivo Markdown de hipóteses de estratégia. O agente anexa seções de "estado atual" chamando as ferramentas — "até esta consulta, o mercado de resolução para X está sendo negociado a Y com Z de volume no último dia." Sem copiar e colar de uma aba do navegador Polymarket.

Por que isso não é apenas uma camada fina

Uma camada fina apenas encaminharia a pergunta do agente para a API CLOB do Polymarket e encerraria o assunto. Dois problemas com isso:

1. A API CLOB tem limite de taxa e retorna diffs brutos do livro de ordens. Um agente queimando tokens decodificando sequências de diffs é desperdício.
2. Não há endpoint de preço histórico na API ao vivo. Se você quiser o preço de 18 horas atrás, precisa manter seu próprio pipeline de instantâneas.

polymarket-mcp-pro se comunica com api.protodex.io, que está executando esse pipeline de instantâneas desde o início de 2026. A profundidade histórica (10,8M+ pontos) é a coisa que o agente obtém que nenhuma alternativa de camada fina fornece.

O que vem na v0.2

Um transporte de assinatura WebSocket. Agora mesmo get_crashes é baseado em polling — o agente pergunta, o servidor retorna a instantânea atual. A v0.2 permitirá que o agente se inscreva em um fluxo e receba atualizações quando um limite de colapso for ultrapassado, sem precisar perguntar novamente. A especificação MCP suporta isso nativamente; só precisa de código de ligação da minha parte.

Obtenha também o conjunto de dados históricos

O servidor MCP dá ao seu agente acesso ao vivo. Se você quiser o corpus histórico completo como um CSV plano para análise offline, backtests ou para construir sua própria coisa em cima — isso está disponível aqui. 10,8M+ registros de preços, 13.964 mercados, $11,7B+ de volume, compra única.

O servidor MCP permanece gratuito de qualquer forma. O conjunto de dados é a camada comercial opcional para pessoas que desejam acesso em massa sem sobrecarregar uma API.

Links

• GitHub: https://github.com/LuciferForge/polymarket-mcp
• PyPI: https://pypi.org/project/polymarket-mcp-pro/
• Projeto irmão (auditor gratuito para suas negociações existentes): https://github.com/LuciferForge/pnl-truthteller
• Problemas / solicitações: d