POLYRAMA UTC --:--:-- LOCAL --:--:--

Polyrama MCP server

Plug live prediction-market data straight into your AI agent. The Polyrama Model Context Protocol (MCP) server lets Claude, ChatGPT, Cursor and any MCP-compatible assistant search markets, pull Polymarket + Kalshi odds, look up on-chain traders and read signals — by just asking, in plain language. No glue code; the agent calls the tools itself.

Why an MCP server

Ask, don't integrate

“What are the biggest 24h movers on Polymarket?” or “Show me the top traders in this market and their P&L.” Your agent answers using live Polyrama data — no API wrangling, no CSV exports.

Research at agent speed

Chain it: find a moving market → pull its order book → check who's trading it → inspect its price history. All in one conversation, all grounded in real data.

What your agent can do

Data tools backed by the same data as the dashboard. Trading and backtest tools are disabled:

search_marketsFind markets by keyword, category, platform, volume or movement.
get_marketLive odds, spread, volume and history for a single market.
top_tradersLeaderboards — by portfolio value, P&L, 24h movers, volume.
get_traderAny wallet's positions, P&L and recent activity.
refresh_traderPull a wallet's latest book + history on demand.
recent_signalsWhale prints, volume spikes and sharp odds moves.
state_snapshot · list_botsDashboard data and archived configurations; execution is disabled.

Connect your AI agent

The Polyrama MCP server sits on top of our REST API and authenticates with an API token. Add it to your MCP client's config — the shape is the same across clients (Claude, Cursor, ChatGPT, Windsurf, …); only the config file location differs.

MCP is an open standard, so Polyrama works with any MCP-compatible agent — including:

Claude DesktopClaude Code ChatGPTOpenAI Codex CursorWindsurf ClineGoose ZedOpenClaw Hermes+ any MCP agent

Standard MCP config

{
  "mcpServers": {
    "polyrama": {
      "command": "polyrama",
      "args": ["mcp"],
      "env": {
        "POLYRAMA_API_URL": "{POLYRAMA_URL}",
        "POLYRAMA_API_TOKEN": "<your-token>"
      }
    }
  }
}

Claude Desktop: add to claude_desktop_config.json · Claude Code: claude mcp add · Cursor: Settings → MCP → add server · then restart the client and ask it about a market.

Connect your agent

The Polyrama MCP server runs on an API token. Generate one on the API page and paste it into the POLYRAMA_API_TOKEN field in the config above.

→ API & tokens