Skip to main content
Glama
polymarket-mcp

polymarket-mcp

by amerilain

Polymarket MCP Server

Model Context Protocol server for Polymarket prediction markets. v0.3.0

Query Polymarket markets, events, narratives, arbitrage opportunities, and more — from any MCP-compatible client (Claude Desktop, OpenClaw, Cursor, etc.) OR via HTTP REST.

Zero dependencies. No API key required. MIT license.

Quick Start

Option B: HTTP (for curl/web/dashboards)

Related MCP server: Polymarket MCP Server

Available Tools

Tool

Description

top_markets

Top markets by volume (24h or total) with formatted prices

search_markets

Client-side keyword search across title+description

get_market

Detailed market info by slug

top_movers

Biggest price movers with price formatting

list_events

List events with optional child market details

market_narratives

Cluster events by theme/narrative with volume analysis

detect_volume_spikes

Find markets with unusual 24h volume spikes

find_arbitrage

Discover Yes+No != 100% opportunities

market_summary

Comprehensive ecosystem snapshot

Changelog

v0.3.0 (2026-06-26)

  • HTTP mode: --http PORT starts a REST API at /health, /tools, /call/{tool_name}

  • HTML status page: GET / shows a human-readable dashboard

  • CORS headers: All endpoints support cross-origin requests

v0.2.0 (2026-06-26)

  • Smart price formatting (Yes 52¢ / No 48¢)

  • Proper client-side search

  • Retry logic (429, 502, 503, 504)

  • Connection resilience

Technical Details

  • Protocol: JSON-RPC 2.0 over stdio (MCP) OR HTTP REST

  • Dependencies: Zero (Python standard library only)

  • API: Polymarket Gamma API (public, no key needed)

  • Python: 3.7+

  • License: MIT

Configuration with Claude Desktop

Add to claude_desktop_config.json:

Available Tools

9 tools
detect_volume_spikesC

Detect Polymarket markets with unusual 24h volume

Inputs: limit.

find_arbitrageB

Find arbitrage opportunities where Yes+No != 100%

Inputs: limit, min_spread.

get_marketC

Get detailed info about a specific Polymarket market by slug

Inputs: slug (required).

list_eventsC

List Polymarket events with child markets

Inputs: tag, limit, with_markets.

market_narrativesB

Cluster Polymarket events by theme/narrative

Inputs: limit.

market_summaryA

Get a comprehensive summary of the Polymarket ecosystem right now

Inputs: no named parameters.

search_marketsC

Search Polymarket markets by keyword

Inputs: query (required), limit.

top_marketsC

Top Polymarket markets by 24h volume

Inputs: limit, by_total.

top_moversC

Biggest price movers on Polymarket

Inputs: limit, period.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 9 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: detection of volume spikes, arbitrage, specific market details, events listing, narrative clustering, ecosystem summary, keyword search, top markets by volume, and top movers. No two tools overlap in functionality, so an agent can easily distinguish them.

    Naming Consistency4/5

    Seven out of nine tools follow a consistent verb_noun pattern (e.g., detect_volume_spikes, get_market, search_markets). Two tools, market_narratives and market_summary, use a noun_noun format, which is a minor deviation but still clear.

    Tool Count5/5

    With 9 tools, the server provides a broad yet focused set of functionalities for analyzing Polymarket prediction markets. The count is well-scoped for a single-purpose server, neither too few nor too many.

    Completeness5/5

    The tools cover key analytical tasks for Polymarket: searching, listing, summarizing, detecting anomalies, and identifying opportunities. For a read-only analysis server, the surface is complete; adding betting or account tools would shift scope.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      A read-only MCP server exposing Polymarket's public prediction-market data. Search markets, read live odds and order books, pull historical probability time-series, and inspect public wallet positions.
      14
      MIT
    • F
      license
      A
      quality
      C
      maintenance
      A Model Context Protocol server that enables seamless integration with Polymarket, providing tools to search markets, fetch events, analyze leaderboards, query user activity, and more via MCP-compatible clients like Claude.
      15
      -