MCP.Market

Polyrama MCP server

by Polyrama·io.github.Polyrama/mcp·v1.0.1
No reviews yet

Research Polymarket and Kalshi markets, traders, signals, backtests, and paper orders.

B77/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B77/100

full report

Adoption
Growing

0 stars55 downloads/wk

Reviews

Write one

Nobody has reviewed Polyrama yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Polyrama tools (10, 2 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • polyrama_get_market

    Get live odds, spread, volume, metadata, and history fields for one market by token id.

  • polyrama_get_trader

    Get one public Polymarket wallet's portfolio, positions, activity, history, and performance stats.

  • polyrama_list_bots

    List the authenticated account's configured Polyrama bots and their current status.

  • polyrama_place_paper_orderwrite action

    Record a paper-only trade in Polyrama. This tool never submits a live order. Requires write:paper scope.

  • polyrama_recent_signals

    Get recent whale prints, volume spikes, price jolts, liquidity, wash-like trade, and market-mispricing signals.

  • polyrama_refresh_trader

    Refresh one public Polymarket wallet's positions and net worth. Requires a token with write:paper scope.

  • polyrama_run_backtestwrite action

    Run a Polyrama strategy against historical market data and return summary statistics, P&L series, and fills. Requires write:paper scope.

  • polyrama_search_markets

    Search live prediction markets tracked by Polyrama across Polymarket and Kalshi. Filter by text or YES probability and sort by volume, movement, spread, or price.

  • polyrama_state_snapshot

    Get the full current Polyrama dashboard state, including quotes, positions, P&L, signals, wallets, and scanners.

  • polyrama_top_traders

    Get the Polymarket wallet leaderboard with portfolio, P&L, volume, activity, and search filters.

Public scan report

scanner v0.1.10 · 2026-11-03 · same rubric, same numbers if you re-run it

no findings
  • Code scan8 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 77 days ago12/15
  • Maintainer identityregistry namespace matches repository owner7/10
Overall 77/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Polyrama compares

Against every graded E-commerce MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
77/100
higher than 55% of 2,174 E-commerce servers
Tools
10
the typical E-commerce server has 6
Tools that change things
20%
typical: 0%. Fewer write tools means less an agent can break
Downloads a week
55
more than 52% of 411 E-commerce servers with a package

What its tools let an agent do: 8 read · 2 change

Install Polyrama in Claude Code, Cursor or VS Code

Runs npx -y @polyrama/mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add mcp -- npx -y @polyrama/mcp
Add to Cursor

What the publisher says

From the Polyrama repository's README, as published. We do not edit it. Read it on GitHub

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

{
  "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, and other stdio MCP clients use the same command and environment variable.

Tools

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

POLYRAMAAPIURL is intended for Polyrama development and staging deployments.

Development

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

See CONTRIBUTING.md before opening a pull request. Security reports should follow SECURITY.md.

Links

  • Polyrama MCP overview
  • Polyrama documentation
  • REST API
  • Markets

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

Nothing above is checked by us. What we check is on the safety report.

Polyrama: common questions

Is Polyrama MCP server safe?
Mostly: it is graded B (77/100). Read the Polyrama safety report
How do I install Polyrama?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Polyrama need an API key?
Yes. The registry entry asks for POLYRAMA_API_TOKEN.
Is Polyrama maintained?
The last commit was 78 days ago (2026-08-18). The latest release is v1.0.1.
What can I use instead of Polyrama?
Servers from other publishers that do the same job: Polymarket Toolkit MCP server, Polymarket Paper Trader MCP server and Longbridge MCP server.
How does Polyrama compare with other E-commerce MCP servers?
safety score 77/100 (higher than 55% of 2,174 E-commerce servers); tools 10 (the typical E-commerce server has 6); tools that change things 20% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Polyrama

Same job from other publishers: the closest match first, then the best rated.

  • Polymarket Toolkit
    Read-only Polymarket data tools for AI agents: profiles, PnL, market scans. No keys, no orders.
    B
  • Polymarket Paper Trader
    Polymarket paper trading for AI agents: $10k paper money, real order books, official fees.
    A
  • Longbridge
    US/HK markets — 163 tools: quotes, options, orders, fundamentals, screener, IPO, alerts, DCA & grid
    A
  • Idea Reality
    Pre-build reality check. Scans GitHub, HN, npm, PyPI, Product Hunt — returns 0-100 signal.
    B
  • Omie
    MCP server for Omie — ERP, customers, products, orders, invoices, financials
    More from codespar →
    B