Polymarket Agent MCP Server

by demwickio.github.demwick/polymarket-agent-mcpv1.7.0

Polymarket trading tools: direct and copy trading, smart money detection, backtesting, arbitrage scanning, portfolio optimization and live price streaming.

16Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained2mo ago

Install Polymarket Agent MCP server

claude mcp add polymarket-agent -e POLY_PRIVATE_KEY='<poly-private-key>' -e POLY_API_KEY='<poly-api-key>' -e POLY_API_SECRET='<poly-api-secret>' -e POLY_API_PASSPHRASE='<poly-api-passphrase>' -- npx -y polymarket-agent-mcp

{
  "mcpServers": {
    "polymarket-agent": {
      "command": "npx",
      "args": [
        "-y",
        "polymarket-agent-mcp"
      ],
      "env": {
        "POLY_PRIVATE_KEY": "<poly-private-key>",
        "POLY_API_KEY": "<poly-api-key>",
        "POLY_API_SECRET": "<poly-api-secret>",
        "POLY_API_PASSPHRASE": "<poly-api-passphrase>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "polymarket-agent": {
      "command": "npx",
      "args": [
        "-y",
        "polymarket-agent-mcp"
      ],
      "env": {
        "POLY_PRIVATE_KEY": "<poly-private-key>",
        "POLY_API_KEY": "<poly-api-key>",
        "POLY_API_SECRET": "<poly-api-secret>",
        "POLY_API_PASSPHRASE": "<poly-api-passphrase>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "polymarket-agent": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "polymarket-agent-mcp"
      ],
      "env": {
        "POLY_PRIVATE_KEY": "<poly-private-key>",
        "POLY_API_KEY": "<poly-api-key>",
        "POLY_API_SECRET": "<poly-api-secret>",
        "POLY_API_PASSPHRASE": "<poly-api-passphrase>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "polymarket-agent": {
      "command": "npx",
      "args": [
        "-y",
        "polymarket-agent-mcp"
      ],
      "env": {
        "POLY_PRIVATE_KEY": "<poly-private-key>",
        "POLY_API_KEY": "<poly-api-key>",
        "POLY_API_SECRET": "<poly-api-secret>",
        "POLY_API_PASSPHRASE": "<poly-api-passphrase>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
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	—	yes	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	—	yes	Polymarket CLOB API key. Required only when COPY_MODE=live.
POLY_API_SECRET	—	yes	Polymarket CLOB API secret. Required only when COPY_MODE=live.
POLY_API_PASSPHRASE	—	yes	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.

Freshness

Maintained — last maintenance signal 2mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-08-07 · 2mo ago · GitHub
Latest release
2026-08-07 · 2mo ago · GitHub · v1.7.0
Package published
no data · npm/PyPI
Registry entry updated
2026-08-07 · 2mo ago · official registry · v1.7.0

FAQ

›How do I install the Polymarket Agent MCP server in Claude Code?

Run: claude mcp add polymarket-agent -e POLY_PRIVATE_KEY='<poly-private-key>' -e POLY_API_KEY='<poly-api-key>' -e POLY_API_SECRET='<poly-api-secret>' -e POLY_API_PASSPHRASE='<poly-api-passphrase>' -- npx -y polymarket-agent-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Polymarket Agent require an API key?

Yes. It expects POLY_PRIVATE_KEY, POLY_API_KEY, POLY_API_SECRET, POLY_API_PASSPHRASE, of which 4 are secrets.

›Can I use Polymarket Agent as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Polymarket Agent in the official MCP registry?

Yes, as io.github.demwick/polymarket-agent-mcp.