mobymedia/polymarket-news-mcp

**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 default** — no API keys, no wallet, no custody: live odds and links only.
Optional trading tools exist (v0.2.0+) but stay absent unless you install the [trading]
extra *and* set your own signing key — see Trading.
Tools
| 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 |
Example
> match_news("Federal Reserve signals rate hike as inflation stays hot")
Install
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.
Trading (opt-in, v0.2.0+)
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