Prediction-market research MCP for live Polymarket and Kalshi markets, odds, public-wallet analytics, leaderboards, signals, backtests, dashboard state, and paper-only orders.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
Manual Client & Custom JSON ConfigExpand JSON ▾
Install Config Generator
Choose your client
💡 Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
Documentation Overview
Polyrama MCP Server
The official Model Context Protocol server for Polyrama, the real-time terminal for prediction markets. It gives MCP-compatible assistants ten typed tools for researching Polymarket and Kalshi markets, analyzing public Polymarket wallets, reading signals, and running paper-only workflows.
This repository contains only the public MCP adapter. The Polyrama application, trading engine, backend, deployment configuration, and private credentials remain private.
Prerequisites
- Node.js 20 or newer
- A Polyrama API token from polyrama.io/api
Pass the token through your MCP client's environment settings. Never commit it to a repository, paste it into an issue, or include it in screenshots and logs.
Run with npx
You do not need a global installation. Use npx in any stdio-compatible MCP client.
Claude Desktop
Claude Code
Codex
Cursor, Windsurf, Cline, Goose, Zed, OpenClaw, and other stdio MCP clients use the same command and environment variable.
Tools
| Tool | Purpose | Scope |
|---|---|---|
polyrama_search_markets | Search live Polymarket and Kalshi markets | read |
polyrama_get_market | Inspect one market by token id | read |
polyrama_top_traders | Rank public Polymarket wallets | read |
polyrama_get_trader | Read one wallet's positions and performance | read |
polyrama_refresh_trader | Refresh one public wallet | write:paper |
polyrama_recent_signals | Read whales, jolts, spikes, and mispricing signals | read |
polyrama_list_bots | List configured bots and status | read |
polyrama_state_snapshot | Read the full dashboard state | read |
polyrama_run_backtest | Run a historical strategy backtest | write:paper |
polyrama_place_paper_order | Record a paper-only trade | write:paper |
The public MCP package has no live-order tool and never calls a live-order endpoint. It cannot move funds or submit an exchange order.
Environment variables
| Variable | Required | Default |
|---|---|---|
POLYRAMA_API_TOKEN | Yes | — |
POLYRAMA_API_URL | No | https://polyrama.io |
POLYRAMA_REQUEST_TIMEOUT_MS | No | 30000 |
POLYRAMA_API_URL is intended for Polyrama development and staging deployments.
Development
See CONTRIBUTING.md before opening a pull request. Security reports should follow SECURITY.md.
Links
Disclaimer
Polyrama is for research and informational use only, not financial advice. Prediction markets involve risk. Review source data and venue rules before acting on any result.
License
MIT © 2026 Polyrama contributors
Related MCP Servers
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about Polyrama MCP
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/polyrama-mcp)HTML Embed
<a href="https://allmcps.com/mcp/polyrama-mcp"><img src="https://allmcps.com/api/badge/polyrama-mcp?style=directory" alt="Polyrama MCP on AllMCPs" /></a>Technical Specs & Signals
CategoryFinance & Fintech
35Quality signal: Fair · 35/100How this signal is calculated ▾
Server availabilityNot measured
Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.
Verified ownership8/20
Documentation & tools17/30
Adoption & activity1/15
Community engagement0/10
A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.
Own this project?
This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to get the verified badge.
Free dofollow backlink: after claiming, verify your product site and place a dofollow AllMCPs badge — we recheck it stays live.
Claim & get free dofollowShare & Embed
Add our SVG badge (dark/light directory styles) or embeddable widget to your site.