{
  "markdown": "# Polyrama MCP Server\n\n[![npm](https://img.shields.io/npm/v/@polyrama/mcp)](https://www.npmjs.com/package/@polyrama/mcp)\n[![CI](https://github.com/Polyrama/mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/Polyrama/mcp/actions/workflows/ci.yml)\n\nThe official [Model Context Protocol](https://modelcontextprotocol.io) server for\n[Polyrama](https://polyrama.io), the real-time terminal for prediction markets. It gives\nMCP-compatible assistants ten typed tools for researching Polymarket and Kalshi markets,\nanalyzing public Polymarket wallets, reading signals, and running paper-only workflows.\n\nThis repository contains only the public MCP adapter. The Polyrama application, trading engine,\nbackend, deployment configuration, and private credentials remain private.\n\n## Prerequisites\n\n- Node.js 20 or newer\n- A Polyrama API token from [polyrama.io/api](https://polyrama.io/api)\n\nPass the token through your MCP client's environment settings. Never commit it to a repository,\npaste it into an issue, or include it in screenshots and logs.\n\n## Run with npx\n\nYou do not need a global installation. Use `npx` in any stdio-compatible MCP client.\n\n### Claude Desktop\n\n```json\n{\n  \"mcpServers\": {\n    \"polyrama\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@polyrama/mcp\"],\n      \"env\": {\n        \"POLYRAMA_API_TOKEN\": \"<your-token>\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add polyrama --env POLYRAMA_API_TOKEN=<your-token> -- npx -y @polyrama/mcp\n```\n\n### Codex\n\n```toml\n[mcp_servers.polyrama]\ncommand = \"npx\"\nargs = [\"-y\", \"@polyrama/mcp\"]\n\n[mcp_servers.polyrama.env]\nPOLYRAMA_API_TOKEN = \"<your-token>\"\n```\n\nCursor, Windsurf, Cline, Goose, Zed, OpenClaw, and other stdio MCP clients use the same command\nand environment variable.\n\n## Tools\n\n| Tool | Purpose | Scope |\n| --- | --- | --- |\n| `polyrama_search_markets` | Search live Polymarket and Kalshi markets | `read` |\n| `polyrama_get_market` | Inspect one market by token id | `read` |\n| `polyrama_top_traders` | Rank public Polymarket wallets | `read` |\n| `polyrama_get_trader` | Read one wallet's positions and performance | `read` |\n| `polyrama_refresh_trader` | Refresh one public wallet | `write:paper` |\n| `polyrama_recent_signals` | Read whales, jolts, spikes, and mispricing signals | `read` |\n| `polyrama_list_bots` | List configured bots and status | `read` |\n| `polyrama_state_snapshot` | Read the full dashboard state | `read` |\n| `polyrama_run_backtest` | Run a historical strategy backtest | `write:paper` |\n| `polyrama_place_paper_order` | Record a paper-only trade | `write:paper` |\n\nThe public MCP package has no live-order tool and never calls a live-order endpoint. It cannot\nmove funds or submit an exchange order.\n\n## Environment variables\n\n| Variable | Required | Default |\n| --- | --- | --- |\n| `POLYRAMA_API_TOKEN` | Yes | — |\n| `POLYRAMA_API_URL` | No | `https://polyrama.io` |\n| `POLYRAMA_REQUEST_TIMEOUT_MS` | No | `30000` |\n\n`POLYRAMA_API_URL` is intended for Polyrama development and staging deployments.\n\n## Development\n\n```bash\nnpm ci\nnpm run check\nnpm pack --dry-run\n```\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) before opening a pull request. Security reports should\nfollow [SECURITY.md](SECURITY.md).\n\n## Links\n\n- [Polyrama MCP overview](https://polyrama.io/mcp)\n- [Polyrama documentation](https://polyrama.io/docs#mcp-what)\n- [REST API](https://polyrama.io/api)\n- [Markets](https://polyrama.io/markets)\n\n## Disclaimer\n\nPolyrama is for research and informational use only, not financial advice. Prediction markets\ninvolve risk. Review source data and venue rules before acting on any result.\n\n## License\n\nMIT © 2026 Polyrama contributors\n",
  "bytes": 3655,
  "sha": "319c449510e15f2c8b6887aedad3f22ac847f2d3884bcb7a2b2f873df1b92ab3",
  "repo_slug": "polyrama/mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_polyrama_mcp_12d63228/readme"
}