The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Polymarket News MCP listing page.
Give an AI agent a headline — get the Polymarket markets it moves.
An MCP (Model Context Protocol) server that connects real-world news to prediction markets. Plenty of MCP servers can look up Polymarket prices; this one answers a different question: "this just happened — where can the world's belief about it be read?" Matching is deterministic and explainable — every match reports the exact terms that fired and a confidence score, so your agent can judge the match itself.
Read-only by design: no API keys, no wallet, no trading. Live odds and links only.
| Tool | What it does |
|---|---|
match_news(text, top_k) | The headline tool. News headline/snippet → the markets it could move, with live odds, 24h volume, match score, matched terms, deep links |
latest_matched_news(top_k, max_age_hours) | Live feed: recent headlines from major outlets (crypto, politics, world, sports), each matched to its markets |
search_markets(query, top_k) | Lenient free-text search over ~2,000 active markets |
trending_markets(top_k) | Most active markets right now by 24h volume |
get_market(slug_or_url) | One market's live odds by URL or slug |
match_news("Federal Reserve signals rate hike as inflation stays hot")
Requires Python ≥3.10. With uv (no install needed):
Claude Code
Claude Desktop / any MCP client (claude_desktop_config.json):
Or classic pip: pip install polymarket-news-mcp
then command polymarket-news-mcp.
By default this server is read-only. Trading tools appear only when you provide your own signing key and install the extra:
Tools: trading_status, place_limit_order, place_market_buy, my_open_orders,
cancel_order, my_positions. Every order is bounded by the spend cap.
Transparency — builder attribution. Orders placed through this server carry the
newsbet builder code (0 bps maker/taker — you pay no extra fees); Polymarket's
Builders program attributes routed volume to the project. Forks can override via
POLYMARKET_BUILDER_CODE.
Security. Your key never leaves your machine and is never logged. Use a dedicated trading wallet with limited funds. Market SELL is deliberately not offered (ambiguous upstream semantics) — sell via limit orders.
Known upstream caveat (July 2026). Polymarket's py-clob-client-v2 currently cannot
sign for NEW "deposit wallet" accounts (#52,
#70,
#76). Accounts created via
the Polymarket website with a browser wallet (signature types 0/1/2) work — set
POLYMARKET_FUNDER to your Polymarket profile address.
Jurisdiction. Polymarket's CLOB rejects orders from restricted regions (incl. the US) server-side; using these tools where prohibited is on you. Nothing here is financial advice.
IDF-weighted term overlap between your text and market questions/event titles, plus:
phrase (bigram) agreement, numeric normalization ($120,000 ≡ 120k), accent folding,
a salience gate (every match needs a rare informative anchor — "openai", never "the"),
one-best-market-per-event dedupe, and a relative cutoff. Market data comes from
Polymarket's public Gamma API (top ~2,000 markets by liquidity, cached 15 minutes at
~/.cache/polymarket-news-mcp/). First call after a cold start takes ~10–15s to build
the index; subsequent calls are instant.
MIT