Polyrama

Terminal de mercado de predicción y MCP para probabilidades en vivo, traders, señales y backtests.

Documentación

Servidor MCP de Polyrama

El servidor oficial de Model Context Protocol para Polyrama, la terminal en tiempo real para mercados de predicción. Proporciona a los asistentes compatibles con MCP diez herramientas tipadas para investigar mercados de Polymarket y Kalshi, analizar carteras públicas de Polymarket, leer señales y ejecutar flujos de trabajo solo en papel.

Este repositorio contiene únicamente el adaptador MCP público. La aplicación Polyrama, el motor de trading, el backend, la configuración de despliegue y las credenciales privadas permanecen privados.

Requisitos previos

Node.js 20 o superior
Un token de API de Polyrama desde polyrama.io/api

Pasa el token a través de la configuración de entorno de tu cliente MCP. Nunca lo confirmes en un repositorio, lo pegues en un issue ni lo incluyas en capturas de pantalla o registros.

Ejecutar con npx

No necesitas una instalación global. Usa npx en cualquier cliente MCP compatible con 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 y otros clientes MCP stdio usan el mismo comando y variable de entorno.

Herramientas

Herramienta	Propósito	Alcance
`polyrama_search_markets`	Buscar mercados en vivo de Polymarket y Kalshi	`read`
`polyrama_get_market`	Inspeccionar un mercado por id de token	`read`
`polyrama_top_traders`	Clasificar carteras públicas de Polymarket	`read`
`polyrama_get_trader`	Leer posiciones y rendimiento de una cartera	`read`
`polyrama_refresh_trader`	Actualizar una cartera pública	`write:paper`
`polyrama_recent_signals`	Leer señales de ballenas, sacudidas, picos y errores de precio	`read`
`polyrama_list_bots`	Listar bots configurados y su estado	`read`
`polyrama_state_snapshot`	Leer el estado completo del panel	`read`
`polyrama_run_backtest`	Ejecutar un backtest histórico de estrategia	`write:paper`
`polyrama_place_paper_order`	Registrar una operación solo en papel	`write:paper`

El paquete MCP público no tiene herramienta de órdenes en vivo y nunca llama a un endpoint de órdenes en vivo. No puede mover fondos ni enviar una orden a un exchange.

Variables de entorno

Variable	Requerida	Predeterminado
`POLYRAMA_API_TOKEN`	Sí	—
`POLYRAMA_API_URL`	No	`https://polyrama.io`
`POLYRAMA_REQUEST_TIMEOUT_MS`	No	`30000`

POLYRAMA_API_URL está pensada para despliegues de desarrollo y staging de Polyrama.

Desarrollo

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

Consulta CONTRIBUTING.md antes de abrir una pull request. Los informes de seguridad deben seguir SECURITY.md.

Enlaces

Aviso legal

Polyrama es solo para fines de investigación e informativos, no constituye asesoramiento financiero. Los mercados de predicción implican riesgo. Revisa los datos de origen y las reglas de la plataforma antes de actuar sobre cualquier resultado.