polymarket-mcp

🎲 prediction markets at your fingertips

mcp server and cli for polymarket. get real-time market data, prices, and search through claude desktop or terminal.

features

real-time data: active markets, trending by volume, current prices.

search: find markets by keyword across questions and descriptions.

multiple interfaces: claude desktop integration + standalone cli.

output formats: json, pretty-printed, or clean tables.

caching: built-in smart caching with auto-retry logic.

requirements

rust 1.70+ (curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh)

claude desktop for mcp integration (download)

install

cargo install --git https://github.com/ozgureyilmaz/polymarket-mcp

binary installs to ~/.cargo/bin/polymarket-mcp.

setup

configure claude desktop:

edit ~/Library/Application Support/Claude/claude_desktop_config.json (macos):

{
  "mcpServers": {
    "polymarket": {
      "command": "polymarket-mcp"
    }
  }
}

restart claude desktop.

usage

cli

# trending markets
polymarket-mcp --output table trending --limit 5

# active markets
polymarket-mcp --output table markets --limit 10

# search
polymarket-mcp --output table search "fed" --limit 5

# market details
polymarket-mcp market 601700

# prices
polymarket-mcp prices 601700

with claude

after setup, ask claude:

• "show me trending prediction markets"
• "search for markets about trump"
• "what's the current price on the fed decision market?"

development

cargo test
cargo build --release

links

• issues
• mcp docs
• polymarket-mcp docs
• polymarket api