Polymarket News MCP server

polymarket-news-mcp

<!-- mcp-name: io.github.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 design: no API keys, no wallet, no trading. Live odds and links only.

Tools

Example

match_news("Federal Reserve signals rate hike as inflation stays hot")

[
  {"question": "Fed rate hike in 2026?", "match_score": 17.2,
   "outcomes": {"Yes": 0.47, "No": 0.53}, "volume_24h_usd": 812440,
   "matched_terms": ["fed", "hike", "rate", "rate hike"],
   "url": "https://polymarket.com/event/fed-rate-hike-in-2026"},
  {"question": "Fed Rate Hike by July 2026 Meeting?", "match_score": 17.0,
   "outcomes": {"Yes": 0.08, "No": 0.92}, ...}
]

Install

Requires Python ≥3.10. With uv (no install needed):

uvx polymarket-news-mcp

Claude Code

claude mcp add polymarket-news -- uvx polymarket-news-mcp

Claude Desktop / any MCP client (claudedesktopconfig.json):

{
  "mcpServers": {
    "polymarket-news": {
      "command": "uvx",
      "args": ["polymarket-news-mcp"]
    }
  }
}

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:

pip install "polymarket-news-mcp[trading]"
export POLYMARKET_PRIVATE_KEY=0x...     # YOUR key. Stays local, signs locally.
export POLYMARKET_FUNDER=0x...          # your Polymarket proxy/funds address (browser-wallet accounts)
# optional: POLYMARKET_SIGNATURE_TYPE (0 EOA / 1 proxy / 2 Safe / 3 deposit wallet)
# optional: POLYMARKET_MAX_ORDER_USD (spend cap per order, default 100)

Tools: tradingstatus, placelimitorder, placemarketbuy, myopenorders, cancelorder, 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 POLYMARKETBUILDERCODE.

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.

Shortened. The full README is on GitHub.