Polymarket Scan MCP

Servidor MCP PolymarketScan

Dados somente leitura dos mercados de previsão da Polymarket.com para assistentes de IA. Conecte ChatGPT, Claude, Grok, Cursor, Claude Code ou qualquer cliente MCP para obter probabilidades implícitas do mercado (odds), histórico de preços, maiores movimentações, mercados em alta, grandes negociações, fluxo de compra e venda, estatísticas públicas de traders e notícias relacionadas.

• Sem conta, chave de API ou OAuth. Todas as ferramentas são públicas e somente leitura.
• Somente leitura. As ferramentas não podem fazer, alterar ou cancelar ordens, mover fundos ou acessar qualquer conta.
• Versão: 2.0.0 (outubro de 2026). Protocolo: MCP sobre Streamable HTTP (stateless, respostas JSON).

Endpoint

https://mcp.polymarketscan.org/mcp

O endereço original continua funcionando e serve o mesmo servidor:

https://gzydspfquuaudqeztorw.supabase.co/functions/v1/mcp-server/mcp

Ferramentas (11)

Seu cliente MCP lê o esquema completo de entrada e saída de cada ferramenta do servidor (tools/list). Toda entrada, exceto as marcadas como obrigatórias, é opcional.

search_markets (Pesquisar mercados de previsão)

Pesquisa mercados abertos da Polymarket.com e retorna as correspondências mais próximas, cada uma com até seis probabilidades implícitas de mercado dos resultados, variação em 24 horas e volume.

• Entradas: query (obrigatório): o evento, pessoa, time, ativo ou pergunta em palavras simples, até 200 caracteres. limit: 1 a 10, padrão 5.
• Notas: apenas mercados abertos. Os resultados nomeados na consulta vêm primeiro, depois os líderes (ou os degraus da escada de preços mais próximos de 50%). Para a lista completa de resultados de um mercado, regras e status, use get_market_odds.
• Experimente perguntar: "Quais são as odds para a próxima decisão de taxa do Fed?"

get_market_odds (Obter odds do mercado)

Um mercado ou evento completo: probabilidade de cada resultado e variação em 24 horas (até 40 resultados, mais a contagem total), volume, liquidez, data de encerramento, status, regras de resolução e fonte, e o resultado após a resolução.

• Entradas: market (obrigatório): um slug de mercado ou evento, um link polymarket.com ou polymarketscan.org, um condition ID (0x + 64 hex), ou o mercado em palavras simples.
• Notas: funciona para mercados abertos, encerrados e resolvidos. Resultados mutuamente exclusivos são classificados por probabilidade. Se nada corresponder, retorna até 3 dos mercados abertos mais próximos.
• Experimente perguntar: "Mostre as chances de cada candidato na eleição presidencial de 2028."

get_price_history (Obter histórico de preços)

Como a probabilidade de um resultado mudou ao longo de um intervalo de tempo: início e fim, variação em pontos percentuais, máxima e mínima, e um gráfico.

• Entradas: market (obrigatório): como em get_market_odds. outcome: o resultado para o gráfico, como "Sim" ou o nome de um candidato; o padrão é o resultado aberto líder de um evento com múltiplos resultados, ou o primeiro resultado de um mercado único. range: 1d, 1w, 1m, 3m ou all, padrão 1w.
• Notas: os preços vêm do histórico do livro de ordens da Polymarket.com. Lacunas em mercados tranquilos ficam sem preenchimento. Para um mercado encerrado ou resolvido, o intervalo termina quando a negociação fechou.
• Experimente perguntar: "Como as odds de uma recessão nos EUA mudaram este mês?"

get_market_movers (Obter maiores movimentações do mercado)

Mercados abertos com as maiores variações em 24 horas na probabilidade (em pontos percentuais), com o resultado que se moveu, sua probabilidade atual e volume em 24 horas; no máximo dois por evento.

• Entradas: direction: up, down ou both, padrão both. category: um de politics, elections, geopolitics, world, economy, finance, crypto, tech, culture, sports, esports, weather ou science; omita para todas as categorias. limit: 1 a 20, padrão 10.
• Notas: cobre os 300 mercados mais negociados (por categoria quando uma é fornecida) com pelo menos US$ 10 mil negociados em 24 horas. Mercados com preço de 1% ou menos ou 99% ou mais são deixados de fora como efetivamente decididos. Jogos individuais de esportes e e-sports (partidas únicas e suas linhas de margem de pontos e totais de pontos, futuras ou em andamento) são deixados de fora, a menos que a categoria seja sports ou esports; futuros como um vencedor de temporada ou campeonato permanecem.
• Experimente perguntar: "Quais mercados de previsão mais se moveram hoje?"

get_trending_markets (Obter mercados em alta)

Os eventos abertos com maior volume de negociação nas últimas 24 horas, cada um com até quatro probabilidades de resultados (os líderes, ou os degraus da escada de preços mais próximos de 50%), variação em 24 horas e volume.

• Entradas: category: os mesmos valores de get_market_movers; omita para todas as categorias. limit: 1 a 20, padrão 8.
• Notas: eventos que já parecem decididos (um resultado com 99% ou mais) e planilhas secundárias de props de jogos são deixados de fora. Jogos individuais de esportes e e-sports (partidas únicas, futuras ou em andamento) são deixados de fora, a menos que a categoria seja sports ou esports; futuros como um vencedor de temporada ou campeonato permanecem.
• Experimente perguntar: "O que está em alta na Polymarket em cripto?"

get_whale_trades (Obter grandes negociações)

As maiores negociações recentes do feed público de negociações da Polymarket.com, da maior para a menor, com hora, lado, resultado, tamanho em dólares, ações, preço, mercado e a carteira e nome público do trader.

• Entradas: min_usd: menor negociação em dólares americanos, 1.000 a 1.000.000, padrão 10.000. market: limite para um mercado ou evento (um slug, um link polymarket.com ou polymarketscan.org, um condition ID, ou algumas palavras); omita para todos os mercados. hours: até onde olhar para trás, 1 a 168, padrão 24. limit: 1 a 50, padrão 15.
• Notas: em todos os mercados, preenchimentos a 99¢ ou mais ou 1¢ ou menos (mercados efetivamente decididos) são deixados de fora. Cada preenchimento é contado uma vez; dólares são ações vezes preço. Se o feed estiver ocupado demais para escanear a janela inteira, o resultado informa quanto cobre.
• Experimente perguntar: "Mostre negociações da Polymarket acima de US$ 50 mil nas últimas 24 horas."

get_market_flow (Obter fluxo do mercado)

Quem está comprando e vendendo um mercado: dólares comprados, vendidos e líquidos por resultado, contagem de negociações, até 8 maiores negociações e até 5 principais detentores por resultado.

• Entradas: market (obrigatório): como em get_market_odds. hours: até onde olhar para trás, 1 a 168, padrão 24.
• Notas: para um evento com múltiplos resultados, usa o resultado aberto líder (para uma escada de preços, o degrau aberto mais negociado) e informa isso. Os totais em dólares contam cada preenchimento uma vez (seu lado taker), então ficam em cerca de metade do volume bilateral que a Polymarket.com divulga. Em mercados muito movimentados, pequenos preenchimentos podem ser deixados de fora para caber a janela inteira; o resultado informa isso.
• Experimente perguntar: "Quem está comprando o mercado de Bitcoin a US$ 150 mil?"

get_leaderboard (Obter ranking de traders)

O ranking de traders da Polymarket.com por lucro ou volume: posição, endereço completo da carteira, nome público de exibição, lucro e volume em dólares, com link para o perfil.

• Entradas: metric: profit ou volume, padrão profit. period: day (desde 00:00 UTC), week (7 dias), month (30 dias) ou all, padrão month. category: um de sports, politics, crypto, economics, finance, tech, culture, esports, weather ou mentions; omita para todos os mercados. limit: 1 a 25, padrão 10.
• Notas: lucro do dia, semana e mês inclui posições abertas aos preços atuais; lucro de todos os tempos é apenas realizado. A Polymarket não publica volume em dólares por categoria, então os quadros por categoria deixam isso vazio.
• Experimente perguntar: "Quem são os principais traders da Polymarket por lucro este mês?"

get_trader_profile (Obter perfil do trader)

Estatísticas públicas de um trader: nome de exibição, lucro realizado de todos os tempos e volume, valor da carteira, posições abertas, mercados negociados, e até 5 maiores posições e 8 negociações mais recentes.

• Entradas: trader (obrigatório): um endereço de carteira 0x completo (42 caracteres), um link de perfil polymarket.com, um @username ou um nome de usuário.
• Notas: um nome de usuário é correspondido exatamente quando possível; caso contrário, o perfil público mais próximo é usado e o resultado informa isso. Negociações recentes são aquelas de US$ 1 ou mais. Não informa quem controla uma carteira.
• Experimente perguntar: "Consulte este trader da Polymarket: 0x…"

get_trader_positions (Obter posições do trader)

Até 50 posições abertas de um trader com ações, preço médio e atual, valor e lucro ou prejuízo não realizado, além da contagem total e valor da carteira.

• Entradas: trader (obrigatório): como em get_trader_profile. sort: value (maior valor atual primeiro) ou pnl (maior ganho não realizado primeiro), padrão value. limit: 1 a 50, padrão 20.
• Notas: posições com valor abaixo de US$ 1 e posições resolvidas aguardando resgate são deixadas de fora da lista.
• Experimente perguntar: "Quais são as maiores posições abertas deste trader?"

get_market_news (Obter notícias do mercado)

Até 10 manchetes dos últimos 14 dias sobre um mercado ou tópico, com veículo, hora de publicação e link, do feed de notícias da PolymarketScan de grandes veículos.

• Entradas: market: um slug de mercado ou evento, um link polymarket.com ou polymarketscan.org, ou um condition ID; palavras simples são tratadas como o tópico. query: palavras de tópico como "bitcoin etf"; com um mercado, mantém apenas as notícias desse mercado que as mencionam. limit: 1 a 10, padrão 5. Dê um mercado, uma consulta ou ambos.
• Notas: não é uma busca web completa: não retorna texto de artigo e pode não encontrar nada para mercados de nicho.
• Experimente perguntar: "Há notícias por trás do movimento no mercado de decisão do Fed?"

Resultados

• Unidades são as mesmas em todas as ferramentas: probabilidades são de 0 a 1, variações de preço são em pontos percentuais, preços são em centavos, dinheiro é em dólares americanos e contagens de ações são rotuladas como ações. Um valor nulo significa que o número não está disponível, nunca zero. Carteiras são endereços completos em minúsculas, então os resultados podem ser passados diretamente para as ferramentas de trader.
• Rodapés. O texto de cada resultado termina com "Fonte: Polymarket.com via PolymarketScan. Apenas informativo, não é aconselhamento financeiro." Resultados sobre negociações ou posições (get_whale_trades, get_market_flow, get_leaderboard, get_trader_profile, get_trader_positions) adicionam "Negociar é arriscado; perda de 100% pode ocorrer." get_market_news termina com "Fonte: veículos de notícias via feed de notícias da PolymarketScan. Apenas informativo, não é aconselhamento financeiro."
• Links. Links de mercado e trader abrem páginas de análise da PolymarketScan e carregam ?ref=mcp, que marca a visita como vinda de um assistente de IA. Nenhum link de resultado vai para uma página de negociação na polymarket.com. Manchetes de notícias linkam para o artigo do editor.
• Erros. Se o serviço de dados da Polymarket não responder, uma ferramenta retorna uma mensagem curta em inglês simples pedindo para tentar novamente. Nunca repassa um erro bruto de upstream ou de banco de dados.

O card

Em hosts que suportam MCP Apps (como ChatGPT), os resultados são renderizados em um card interativo da PolymarketScan: odds, gráficos de preço, listas classificadas de mercados, negociações e traders. O card não carrega nada da rede por conta própria. Em outros clientes, os mesmos resultados chegam como dados estruturados mais um resumo curto em inglês simples.

Adicione ao seu assistente

ChatGPT

• Diretório de plugins: assim que a PolymarketScan estiver listada, abra o diretório de plugins no ChatGPT, pesquise por "PolymarketScan" e conecte-a.
• Modo desenvolvedor (antes da listagem, ou para testar): ative Configurações → Segurança e login → Modo desenvolvedor, vá para chatgpt.com/plugins, clique em +, insira https://mcp.polymarketscan.org/mcp e escolha sem autenticação.

Claude (claude.ai e Claude Desktop)

• Diretório de conectores: assim que a PolymarketScan estiver listada, adicione-a em Configurações → Conectores → Procurar conectores.
• Conector personalizado: Configurações → Conectores → Adicionar conector personalizado. Nomeie como PolymarketScan, use a URL https://mcp.polymarketscan.org/mcp e deixe os campos OAuth vazios.

Grok

Adicione um conector personalizado (servidor MCP) com a URL https://mcp.polymarketscan.org/mcp e sem autenticação.

Claude Code

claude mcp add --transport http polymarketscan https://mcp.polymarketscan.org/mcp

Cursor

Adicione em ~/.cursor/mcp.json (todos os projetos) ou .cursor/mcp.json (um projeto):

{
  "mcpServers": {
    "polymarketscan": {
      "url": "https://mcp.polymarketscan.org/mcp"
    }
  }
}

Clientes que executam apenas servidores locais (stdio)

Faça a ponte com mcp-remote, por exemplo em claude_desktop_config.json:

{
  "mcpServers": {
    "polymarketscan": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.polymarketscan.org/mcp"]
    }
  }
}

Qualquer cliente MCP ou HTTP simples

Aponte um cliente Streamable HTTP para o endpoint. O servidor não tem estado e responde a JSON-RPC via POST /mcp com JSON:

curl -s https://mcp.polymarketscan.org/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Fonte de dados

Probabilidades, preços, negociações, detentores, rankings e estatísticas de traders são obtidos das APIs públicas do Polymarket.com quando uma ferramenta é chamada. Manchetes de notícias vêm do feed de notícias próprio do PolymarketScan, com os principais veículos. As respostas do Polymarket.com são armazenadas em cache por no máximo um minuto; rankings, mercados liquidados e nomes públicos de perfis são armazenados em cache por 2 minutos a uma hora.

Privacidade

O servidor recebe apenas as chamadas de ferramentas que um assistente faz, nunca a sua conversa. Ele registra dois tipos de solicitação: um cliente se conectando (initialize) e uma ferramenta sendo usada (tools/call). Listar as ferramentas e outras mensagens de protocolo não são registradas. Cada registro contém a ação (uma conexão ou o nome da ferramenta), o tipo de cliente identificado pelo user agent, os primeiros 300 caracteres do user agent, um hash com chave do endereço IP de conexão (HMAC-SHA-256 com um segredo do servidor, abreviado) e o horário. Entradas e resultados de ferramentas não são armazenados. Detalhes: Política de Privacidade, seção 3.

Aviso legal

Fonte: Polymarket.com via PolymarketScan. Apenas informativo, não é aconselhamento financeiro. Probabilidades implícitas no mercado são previsões da multidão, não certezas. Os dados podem estar atrasados ou incorretos; verifique números importantes na página vinculada. Negociar envolve risco; perda de 100% pode ocorrer.

O PolymarketScan é uma plataforma de análise independente, não é a Polymarket. Termos de Serviço · Política de Privacidade · Contato · support@polymarketscan.org