Skip to main content

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

[
  {"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 (claude_desktop_config.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: 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

Metadata

Release files for polymarket-news-mcp 0.2.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for polymarket-news-mcp 0.2.2
File Size Uploaded Provenance Actions
polymarket_news_mcp-0.2.2.tar.gz 23.2 kB With provenance Details for polymarket_news_mcp-0.2.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for polymarket-news-mcp 0.2.2
File Interpreter ABI Platform Actions
polymarket_news_mcp-0.2.2-py3-none-any.whl Python 3 none any Details for polymarket_news_mcp-0.2.2-py3-none-any.whl

Total release size: 45.5 kB

Release files / polymarket_news_mcp-0.2.2.tar.gz

Download URL polymarket_news_mcp-0.2.2.tar.gz
Size 23.2 kB
Tags Source
SHA-256 checksum
How to use checksums
82e413e3252c7032831c2e4e2f0d350795748941b589b053e9683ad900940be7
BLAKE2b-256 checksum
How to use checksums
8ac1e9787fbcf6f0ed9eb41333d9a8494d62d3f0f8ba9d51c73af08f57c1339f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 5, 2026.

Transparency log

Release files / polymarket_news_mcp-0.2.2-py3-none-any.whl

Download URL polymarket_news_mcp-0.2.2-py3-none-any.whl
Size 22.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a647fe10ae29995e0b398e95a0203b0507b9b62ab76d8ba4bb9f47e9a5bda323
BLAKE2b-256 checksum
How to use checksums
3a6141896472dd1ea534e28d77c88baf12b57cfbaf1fbd3e987d584589474dcb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 5, 2026.

Transparency log

Security for polymarket-news-mcp 0.2.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for polymarket_news_mcp-0.2.2.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 5, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page