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.
Not yet automatically verified
We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.
Manual Client & Custom JSON ConfigExpand JSON ▾
Client Config & Setup
Choose your client or environment
Target File:
💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Capabilities & Tool Schemas (10)
Inspect callable tools, capabilities, and parameters exposed to AI agents by Polyrama MCP.
polyrama_search_marketsSearch live Polymarket and Kalshi markets
polyrama_get_marketInspect one market by token id
polyrama_top_tradersRank public Polymarket wallets
polyrama_get_traderRead one wallet's positions and performance
polyrama_refresh_traderRefresh one public wallet
polyrama_recent_signalsRead whales, jolts, spikes, and mispricing signals
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
Adoption & maintenance
Factual signals from GitHub, npm, and our automated checks — not a rating.
Last commit
1mo ago
Most recent push to the default branch.
Tools exposed
10
Callable tools this server registers over MCP.
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
10/10 checks healthy over the last 43d
51Quality signal: Good · 51/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 ownership10/20
Documentation & tools26/30
Adoption & activity2/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.
Supply-chain signal
No high-severity advisories surfaced by our automated scan.
Critical 0High 0Medium 0Low 0
Scanned 13d ago via OSV.dev · @polyrama/mcp (npm)
Own this project?
This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.
Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.
Claim & get free dofollowShare & Embed
Add our SVG badge (dark/light directory styles) or embeddable widget to your site.