Polymarket News Mcp

io.github.mobymediaPublished by GitHub account mobymediav0.2.2Updated Oct 29, 2026

Match news headlines to the Polymarket prediction markets they move - live odds and deep links

VerifiedSTDIODesktop onlyWeb Search & ScrapingFinance

Overview

AI-generated overview

Matches news headlines to Polymarket prediction markets, returning live odds, match scores and deep links; read-only by default.

What you can do
  • Match a headline or snippet to the prediction markets it could move, with live odds, 24h volume, matched terms and links
  • Browse a live feed of recent headlines from major outlets, each already matched to markets
  • Search active markets by free text, list the most active markets by 24h volume, and look up one market's odds by slug or URL
  • Optionally, with the trading extra and your own signing key, check trading status, place limit or market-buy orders, list open orders and positions, and cancel orders
When to use it
Useful when an assistant needs to connect current news to prediction-market odds, for example to see which markets a headline affects, to scan trending markets, or to check a single market's live pricing.
Requirements
Local Python process, Python 3.10 or newer, run via uvx or pip install. Network access to Polymarket's public Gamma API and to news RSS feeds. No API keys or wallet for the default read-only tools; trading tools require the trading extra plus POLYMARKET_PRIVATE_KEY and POLYMARKET_FUNDER, with optional POLYMARKET_SIGNATURE_TYPE and POLYMARKET_MAX_ORDER_USD. First call after a cold start takes about 10-15 seconds to build the index.
Before you install
Read-only by default, but the opt-in trading tools place real orders and need a signing key in POLYMARKET_PRIVATE_KEY; use a dedicated wallet with limited funds and rely on the per-order spend cap. Orders carry a builder attribution code. Polymarket rejects orders from restricted regions, and nothing here is financial advice. Market data is cached locally and fetched from Polymarket's public API.

Installation

In SourceWeft

  1. Open Polymarket News Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

ToolWhat 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")

json
[  {"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):

bash
uvx polymarket-news-mcp

Claude Code

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

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

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:

bash
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: 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.

How matching works

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.

Notes & limits

  • Informational only — not financial advice. Polymarket availability depends on your jurisdiction; this server never places orders.
  • News feed sources: CoinDesk, Cointelegraph, Decrypt, The Block, SEC, BBC World & Politics, ESPN (RSS). PRs welcome for more.
  • Match scores ≥15 are high-confidence; 10–15 are related-entity matches.

License

MIT

Source: README.md at commit eb5de74

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

2
  1. v0.2.2LatestOct 29, 2026
  2. v0.2.1Sep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts