io.github.demwick/polymarket-agent-mcp MCP Server

Name: io.github.demwick/polymarket-agent-mcp MCP Server
Author: io.github.demwick

io.github.demwick/polymarket-agent-mcp

Repository Registry

What is the io.github.demwick/polymarket-agent-mcp MCP server?

Polymarket trading, market discovery, copy trading and backtesting — 48 MCP tools.

How to install io.github.demwick/polymarket-agent-mcp

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

COPY_MODE
Execution mode: 'preview' simulates trades in a local SQLite DB (default, safe for inspection); 'live' places real orders on Polymarket and requires all POLY_* credentials.
POLY_PRIVATE_KEY
secret
Polygon wallet private key used to sign CLOB orders. Required only when COPY_MODE=live. Never logged, persisted, or transmitted outside signed order bodies.
POLY_API_KEY
secret
Polymarket CLOB API key. Required only when COPY_MODE=live.
POLY_API_SECRET
secret
Polymarket CLOB API secret. Required only when COPY_MODE=live.
POLY_API_PASSPHRASE
secret
Polymarket CLOB API passphrase. Required only when COPY_MODE=live.
POLY_FUNDER_ADDRESS
Polymarket funder wallet address (proxy wallet) used for live trading.
DAILY_BUDGET
Maximum USDC the agent may spend per day. Used by BudgetManager to cap copy-trading exposure.
MIN_CONVICTION
Minimum conviction score (0–100) required before a copy trade is executed.
CHAIN_ID
EVM chain ID for Polymarket (137 = Polygon mainnet).
DB_PATH
Optional override for the SQLite database path. Defaults to a package-local file.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "polymarket-agent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "polymarket-agent-mcp"
      ],
      "env": {
        "COPY_MODE": "<YOUR_COPY_MODE>",
        "POLY_PRIVATE_KEY": "<YOUR_POLY_PRIVATE_KEY>",
        "POLY_API_KEY": "<YOUR_POLY_API_KEY>",
        "POLY_API_SECRET": "<YOUR_POLY_API_SECRET>",
        "POLY_API_PASSPHRASE": "<YOUR_POLY_API_PASSPHRASE>",
        "POLY_FUNDER_ADDRESS": "<YOUR_POLY_FUNDER_ADDRESS>",
        "DAILY_BUDGET": "<YOUR_DAILY_BUDGET>",
        "MIN_CONVICTION": "<YOUR_MIN_CONVICTION>",
        "CHAIN_ID": "<YOUR_CHAIN_ID>",
        "DB_PATH": "<YOUR_DB_PATH>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "polymarket-agent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "polymarket-agent-mcp"
      ],
      "env": {
        "COPY_MODE": "<YOUR_COPY_MODE>",
        "POLY_PRIVATE_KEY": "<YOUR_POLY_PRIVATE_KEY>",
        "POLY_API_KEY": "<YOUR_POLY_API_KEY>",
        "POLY_API_SECRET": "<YOUR_POLY_API_SECRET>",
        "POLY_API_PASSPHRASE": "<YOUR_POLY_API_PASSPHRASE>",
        "POLY_FUNDER_ADDRESS": "<YOUR_POLY_FUNDER_ADDRESS>",
        "DAILY_BUDGET": "<YOUR_DAILY_BUDGET>",
        "MIN_CONVICTION": "<YOUR_MIN_CONVICTION>",
        "CHAIN_ID": "<YOUR_CHAIN_ID>",
        "DB_PATH": "<YOUR_DB_PATH>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "polymarket-agent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "polymarket-agent-mcp"
      ],
      "env": {
        "COPY_MODE": "<YOUR_COPY_MODE>",
        "POLY_PRIVATE_KEY": "<YOUR_POLY_PRIVATE_KEY>",
        "POLY_API_KEY": "<YOUR_POLY_API_KEY>",
        "POLY_API_SECRET": "<YOUR_POLY_API_SECRET>",
        "POLY_API_PASSPHRASE": "<YOUR_POLY_API_PASSPHRASE>",
        "POLY_FUNDER_ADDRESS": "<YOUR_POLY_FUNDER_ADDRESS>",
        "DAILY_BUDGET": "<YOUR_DAILY_BUDGET>",
        "MIN_CONVICTION": "<YOUR_MIN_CONVICTION>",
        "CHAIN_ID": "<YOUR_CHAIN_ID>",
        "DB_PATH": "<YOUR_DB_PATH>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "polymarket-agent-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "polymarket-agent-mcp"
      ],
      "env": {
        "COPY_MODE": "<YOUR_COPY_MODE>",
        "POLY_PRIVATE_KEY": "<YOUR_POLY_PRIVATE_KEY>",
        "POLY_API_KEY": "<YOUR_POLY_API_KEY>",
        "POLY_API_SECRET": "<YOUR_POLY_API_SECRET>",
        "POLY_API_PASSPHRASE": "<YOUR_POLY_API_PASSPHRASE>",
        "POLY_FUNDER_ADDRESS": "<YOUR_POLY_FUNDER_ADDRESS>",
        "DAILY_BUDGET": "<YOUR_DAILY_BUDGET>",
        "MIN_CONVICTION": "<YOUR_MIN_CONVICTION>",
        "CHAIN_ID": "<YOUR_CHAIN_ID>",
        "DB_PATH": "<YOUR_DB_PATH>"
      }
    }
  }
}

Claude Code

claude mcp add polymarket-agent-mcp --env COPY_MODE=<YOUR_COPY_MODE> --env POLY_PRIVATE_KEY=<YOUR_POLY_PRIVATE_KEY> --env POLY_API_KEY=<YOUR_POLY_API_KEY> --env POLY_API_SECRET=<YOUR_POLY_API_SECRET> --env POLY_API_PASSPHRASE=<YOUR_POLY_API_PASSPHRASE> --env POLY_FUNDER_ADDRESS=<YOUR_POLY_FUNDER_ADDRESS> --env DAILY_BUDGET=<YOUR_DAILY_BUDGET> --env MIN_CONVICTION=<YOUR_MIN_CONVICTION> --env CHAIN_ID=<YOUR_CHAIN_ID> --env DB_PATH=<YOUR_DB_PATH> -- npx -y polymarket-agent-mcp