Polyrama

Terminal de mercado de previsões e MCP para odds ao vivo, traders, sinais e backtests.

Documentação

Polyrama MCP Server

O servidor oficial do Model Context Protocol para Polyrama, o terminal em tempo real para mercados de previsão. Ele oferece aos assistentes compatíveis com MCP dez ferramentas tipadas para pesquisar mercados Polymarket e Kalshi, analisar carteiras públicas da Polymarket, ler sinais e executar fluxos de trabalho somente de simulação.

Este repositório contém apenas o adaptador MCP público. O aplicativo Polyrama, o mecanismo de negociação, o backend, a configuração de implantação e as credenciais privadas permanecem privados.

Pré-requisitos

Node.js 20 ou mais recente
Um token de API da Polyrama em polyrama.io/api

Passe o token pelas configurações de ambiente do seu cliente MCP. Nunca o envie para um repositório, cole-o em uma issue ou o inclua em capturas de tela e logs.

Executar com npx

Você não precisa de uma instalação global. Use npx em qualquer cliente MCP compatível com stdio.

Claude Desktop

{
  "mcpServers": {
    "polyrama": {
      "command": "npx",
      "args": ["-y", "@polyrama/mcp"],
      "env": {
        "POLYRAMA_API_TOKEN": "<your-token>"
      }
    }
  }
}

Claude Code

claude mcp add polyrama --env POLYRAMA_API_TOKEN=<your-token> -- npx -y @polyrama/mcp

Codex

[mcp_servers.polyrama]
command = "npx"
args = ["-y", "@polyrama/mcp"]

[mcp_servers.polyrama.env]
POLYRAMA_API_TOKEN = "<your-token>"

Cursor, Windsurf, Cline, Goose, Zed, OpenClaw e outros clientes MCP stdio usam o mesmo comando e a mesma variável de ambiente.

Ferramentas

Ferramenta	Finalidade	Escopo
`polyrama_search_markets`	Pesquisar mercados ao vivo da Polymarket e Kalshi	`read`
`polyrama_get_market`	Inspecionar um mercado por token id	`read`
`polyrama_top_traders`	Classificar carteiras públicas da Polymarket	`read`
`polyrama_get_trader`	Ler posições e desempenho de uma carteira	`read`
`polyrama_refresh_trader`	Atualizar uma carteira pública	`write:paper`
`polyrama_recent_signals`	Ler sinais de baleias, abalos, picos e precificação incorreta	`read`
`polyrama_list_bots`	Listar bots configurados e status	`read`
`polyrama_state_snapshot`	Ler o estado completo do painel	`read`
`polyrama_run_backtest`	Executar um backtest histórico de estratégia	`write:paper`
`polyrama_place_paper_order`	Registrar uma negociação somente de simulação	`write:paper`

O pacote MCP público não possui ferramenta de ordem ao vivo e nunca chama um endpoint de ordem ao vivo. Ele não pode mover fundos nem enviar uma ordem de exchange.

Variáveis de ambiente

Variável	Obrigatória	Padrão
`POLYRAMA_API_TOKEN`	Sim	—
`POLYRAMA_API_URL`	Não	`https://polyrama.io`
`POLYRAMA_REQUEST_TIMEOUT_MS`	Não	`30000`

POLYRAMA_API_URL é destinado a implantações de desenvolvimento e staging da Polyrama.

Desenvolvimento

npm ci
npm run check
npm pack --dry-run

Consulte CONTRIBUTING.md antes de abrir um pull request. Relatórios de segurança devem seguir SECURITY.md.

Aviso legal

A Polyrama é apenas para fins de pesquisa e informação, não constitui aconselhamento financeiro. Mercados de previsão envolvem risco. Revise os dados de origem e as regras da plataforma antes de agir com base em qualquer resultado.