Resolved Markets MCP Server

MCP server for Resolved Markets — connect Claude, GPT, or any AI agent to live Polymarket prediction market orderbook data.

Quick Start

npx @elcara-hq/resolvedmarkets-mcp

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "resolvedmarkets": {
      "command": "npx",
      "args": ["-y", "@elcara-hq/resolvedmarkets-mcp"],
      "env": {
        "HF_API_URL": "https://api.resolvedmarkets.com",
        "HF_API_KEY": "rm_your_api_key_here"
      }
    }
  }
}

Claude Code

claude mcp add resolvedmarkets -- npx -y @elcara-hq/resolvedmarkets-mcp

Set your API key:

export HF_API_KEY=rm_your_api_key_here

Tools

| Tool | Description | |------|-------------| | list_markets | List active or historical prediction markets (BTC, ETH, SOL, XRP) | | get_orderbook | Get live orderbook for a market (bid/ask arrays, spread, depth) | | get_snapshot | Get historical orderbook state at a specific timestamp | | query_snapshots | Query multiple snapshots for time-series analysis | | get_market_summary | Get aggregated stats (volume, spread, depth, price range) | | get_system_stats | System-wide stats (live markets, snapshot throughput, crypto prices) |

Resources

| URI | Description | |-----|-------------| | markets://live | Currently active markets with token IDs and metadata | | prices://latest | Current cryptocurrency prices and system statistics |

Environment Variables

| Variable | Default | Description | |----------|---------|-------------| | HF_API_URL | http://localhost:3001 | Backend API URL | | HF_API_KEY | — | API key (get one at resolvedmarkets.com) | | MCP_TRANSPORT | stdio | Transport mode: stdio or http | | MCP_PORT | 3002 | HTTP port (when using HTTP transport) |

Example Queries

Once connected, ask your AI agent:

• "What BTC prediction markets are live right now?"
• "Show me the 5-minute BTC orderbook"
• "What was the BTC spread 2 hours ago?"
• "Pull the last 100 snapshots and analyze the spread trend"
• "How's the system performing?"

HTTP Transport

For remote integrations or custom agents:

MCP_TRANSPORT=http MCP_PORT=3002 npx @elcara-hq/resolvedmarkets-mcp

Endpoint: POST http://localhost:3002/mcp

Links

• Website
• API Docs
• CLI Tool