polymarket-agent-mcp

Package (npm 1.7.0)

npx -y [email protected]

Or add to your MCP client config:

{
  "mcpServers": {
    "polymarket-agent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "COPY_MODE": "<YOUR_VALUE>",
        "POLY_PRIVATE_KEY": "<YOUR_VALUE>",
        "POLY_API_KEY": "<YOUR_VALUE>",
        "POLY_API_SECRET": "<YOUR_VALUE>",
        "POLY_API_PASSPHRASE": "<YOUR_VALUE>",
        "POLY_FUNDER_ADDRESS": "<YOUR_VALUE>",
        "DAILY_BUDGET": "<YOUR_VALUE>",
        "MIN_CONVICTION": "<YOUR_VALUE>",
        "CHAIN_ID": "<YOUR_VALUE>",
        "DB_PATH": "<YOUR_VALUE>"
      }
    }
  }
}

• 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.