Servidor MCP
O servidor MCP (Model Context Protocol) da PolyTest permite que uma ferramenta de IA leia diretamente os dados de mercado da PolyTest. Ele funciona no Claude Code, Cursor, VS Code, Codex, Gemini CLI, Claude Desktop e em outros clientes MCP. Todas as suas ferramentas são somente leitura.
Conectar
O servidor hospedado fica em https://mcp.polytest.io/mcp e usa Streamable HTTP. O comando do Claude Code adiciona o servidor sem chave, e depois você faz login com sua conta da PolyTest. Os outros trechos enviam uma chave de API lida da variável de ambiente POLYTEST_KEY. Autenticação explica as duas opções.
claude mcp add --transport http polytest https://mcp.polytest.io/mcp{
"mcpServers": {
"polytest": {
"url": "https://mcp.polytest.io/mcp",
"headers": {
"Authorization": "Bearer ${env:POLYTEST_KEY}"
}
}
}
}{
"mcpServers": {
"polytest": {
"type": "http",
"url": "https://mcp.polytest.io/mcp",
"headers": {
"Authorization": "Bearer ${POLYTEST_KEY}"
}
}
}
}[mcp_servers.polytest]
url = "https://mcp.polytest.io/mcp"
bearer_token_env_var = "POLYTEST_KEY"gemini mcp add --transport http --header "Authorization: Bearer $POLYTEST_KEY" polytest https://mcp.polytest.io/mcpExecute as linhas do Claude Code e do Gemini CLI em um terminal. O bloco do Cursor vai em ~/.cursor/mcp.json, o do VS Code em .mcp.json e o do Codex em ~/.codex/config.toml.
Autenticação
Se o seu cliente tiver suporte a OAuth, faça login com sua conta da PolyTest. No Claude Code, execute /mcp, selecione polytest e escolha Authenticate. Se /mcp não estiver disponível, como no Claude Code dentro do app para desktop, execute claude mcp login polytest em um terminal, a partir da pasta onde você adicionou o servidor. Outros clientes pedem que você faça login ao se conectar ou na primeira vez que chamam uma ferramenta.
Seu navegador abre um link de login em qpzofvjvtdvdnvgpxplg.supabase.co, o endereço do Supabase Auth, serviço que a PolyTest usa para login. Em seguida ele passa para www.polytest.io, onde você aprova a conexão. Depois, você pode removê-la em Configurações, em Apps conectados.
Você também pode enviar uma chave de API no cabeçalho Authorization: Bearer <key>. X-API-Key também funciona. Crie uma chave na página de chaves de API e nunca a coloque na URL.
No Claude Code, a chave vai na opção --header:
claude mcp add --transport http polytest https://mcp.polytest.io/mcp --header "Authorization: Bearer $POLYTEST_KEY"Executar localmente
npx -y @polytest/mcp executa o servidor na sua própria máquina a partir do pacote npm @polytest/mcp. Ele precisa do Node 20 ou superior e lê sua chave da variável de ambiente POLYTEST_KEY.
claude mcp add --transport stdio --env POLYTEST_KEY=$POLYTEST_KEY polytest -- npx -y @polytest/mcp{
"mcpServers": {
"polytest": {
"command": "npx",
"args": ["-y", "@polytest/mcp"],
"env": {
"POLYTEST_KEY": "pt_live_..."
}
}
}
}O bloco do Claude Desktop vai em claude_desktop_config.json. Troque pt_live_... pela sua chave.
Ferramentas
O servidor tem cinco ferramentas. A última coluna mostra quantas requisições à API uma chamada custa.
| Ferramenta | Retorna | Requisições à API |
|---|---|---|
polytest_list_markets | Os mercados de um market_type para uma moeda, mais novos primeiro. Cada linha traz a janela, o status, o preço spot de abertura e de fechamento, o vencedor e o volume. | 1 |
polytest_get_market | Um mercado, por market_id ou slug, com os ids dos tokens e os campos de resolução. | 1 |
polytest_get_snapshots | Os snapshots de um mercado, mais antigos primeiro, cada um com time, spot_price, price_up e price_down. Com include_orderbook, cada linha traz também os dois livros de ofertas. | 1 |
polytest_get_price_series | Pontos de preço em intervalos iguais ao longo de um mercado, mais antigos primeiro. | 1 mais uma por amostra, 21 com o padrão |
polytest_get_limits | Os limites do seu plano: nível, limites de requisições, teto de concorrência, acesso a dados, teto de chaves e orçamento de teste. | 1 |
price_up é o menor ask no livro de ofertas de Up: o preço que você pagaria para comprar Up naquele momento. price_down é o mesmo para Down. Os dois vão de 0 a 1 e ficam null quando ninguém está oferecendo aquele lado. Nenhum deles é um preço médio nem o preço do último negócio. Como os dois são asks, Up mais Down costuma somar um pouco mais que 1.
Uma sessão típica chama polytest_list_markets para encontrar um mercado, polytest_get_price_series para ver o formato desse mercado e depois polytest_get_snapshots para o detalhe tick a tick ou o livro de ofertas em um momento.
Cobertura e atualização dos dados
A PolyTest tem mercados de btc, eth e sol em 5m, 15m e 1hr, e só de btc em 4hr e 24hr.
A PolyTest carrega mercados novos em lotes, então os mais recentes podem estar horas ou dias atrás do tempo real. O atraso varia conforme a moeda e o tipo de mercado.
Cada linha de mercado tem um campo status:
upcoming: a janela ainda não começou.open: a janela ainda está em andamento.resolved: o vencedor já é conhecido.ended_no_result: a janela terminou e a PolyTest não tem resultado para ela.
Quando você lista os mercados mais recentes, sem end_time, e o mais recente começou bem antes do horário atual, polytest_list_markets adiciona uma nota avisando. Em um mercado ainda em andamento, polytest_get_price_series para no horário atual em vez de amostrar o futuro. Quando os últimos buckets de uma série voltam vazios, ela informa onde os dados terminam. Um intervalo que começa depois do horário atual, como um mercado que ainda não começou, retorna um erro.
Limites e custo
Cada chamada de ferramenta faz requisições comuns à API, então conta para os mesmos limites do plano que as chamadas REST.
- Os limites de requisições são por chave, então crie uma chave dedicada para o servidor MCP.
- A concorrência é compartilhada com tudo o mais que estiver rodando na sua conta. O servidor tenta de novo por um instante quando não há vaga livre.
polytest_get_limitsretornatrial_budgetpara todas as contas, inclusive as pagas. São os totais de requisições, registros e bytes que um teste grátis pode usar nos seus 3 dias, e eles só valem durante o teste. As ferramentas não mostram quanto resta: a API REST informa os valores restantes só nos cabeçalhos de resposta, e os clientes MCP não os veem.- Os resultados são dimensionados para a janela de contexto de uma IA: as páginas são pequenas e os livros de ofertas são cortados em uma profundidade escolhida. Para downloads em massa ou backtests, peça à IA para escrever código com o SDK TypeScript ou a API REST.
Experimente
Com o servidor conectado, pergunte em linguagem natural. Por exemplo:
Liste os cinco mercados BTC 5m mais recentes da PolyTest e mostre como o preço de Up se moveu no mais recente.
Encontre o último mercado BTC 15m resolvido na PolyTest e mostre os dois livros de ofertas trinta segundos antes do fechamento.
Consulte os limites do meu plano da PolyTest e me diga quantas requisições à API custa uma série de preços com 40 amostras.
Solução de problemas
- Um erro da ferramenta diz que a chave de API está faltando ou foi rejeitada
- O erro diz como corrigir na sua configuração: defina
POLYTEST_KEY, adicione o cabeçalhoAuthorizationou faça login de novo. Suas chaves ficam na página de chaves de API. - Um erro da ferramenta cita o seu plano
- O plano não cobre essa requisição. Peça à IA para chamar
polytest_get_limitse ver o que ele cobre. - O cliente diz que o servidor precisa de autenticação
- Faça login quando o cliente oferecer, ou adicione o cabeçalho
Authorizationmostrado em Autenticação. - Um erro da ferramenta diz que o limite de requisições foi atingido
- O erro diz quanto tempo esperar antes de tentar de novo.