Skip to content
MCP server

Polymarket Agent

Search Polymarket, read order books and prices, and place or cancel CLOB v2 orders from…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.1.1
Listing updated
2 days ago

About Polymarket Agent

Polymarket Agent is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Search Polymarket, read order books and prices, and place or cancel CLOB v2 orders from your agent

Install

Run in a terminal

claude mcp add polymarket-agent --env POLYMARKET_PRIVATE_KEY='<POLYMARKET_PRIVATE_KEY>' -- npx -y https://github.com/Mattbusel/polymarket-agent/releases/download/v0.1.1/polymarket-agent-mcp-0.1.1.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "polymarket-agent": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Mattbusel/polymarket-agent/releases/download/v0.1.1/polymarket-agent-mcp-0.1.1.mcpb"
      ],
      "env": {
        "POLYMARKET_PRIVATE_KEY": "<POLYMARKET_PRIVATE_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "polymarket-agent": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Mattbusel/polymarket-agent/releases/download/v0.1.1/polymarket-agent-mcp-0.1.1.mcpb"
      ],
      "env": {
        "POLYMARKET_PRIVATE_KEY": "<POLYMARKET_PRIVATE_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "polymarket-agent": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Mattbusel/polymarket-agent/releases/download/v0.1.1/polymarket-agent-mcp-0.1.1.mcpb"
      ],
      "env": {
        "POLYMARKET_PRIVATE_KEY": "<POLYMARKET_PRIVATE_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "polymarket-agent": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Mattbusel/polymarket-agent/releases/download/v0.1.1/polymarket-agent-mcp-0.1.1.mcpb"
      ],
      "env": {
        "POLYMARKET_PRIVATE_KEY": "<POLYMARKET_PRIVATE_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "polymarket-agent": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Mattbusel/polymarket-agent/releases/download/v0.1.1/polymarket-agent-mcp-0.1.1.mcpb"
      ],
      "env": {
        "POLYMARKET_PRIVATE_KEY": "<POLYMARKET_PRIVATE_KEY>"
      }
    }
  }
}

Configuration

  • POLYMARKET_PRIVATE_KEYHex private key of the Polygon wallet that signs orders. Only the trading tools need it.
  • POLYMARKET_FUNDERProxy or Safe wallet address for polymarket.com accounts. Leave unset for a plain wallet.
  • POLYMARKET_SIGNATURE_TYPEeoa (default), proxy or safe.
  • POLYMARKET_BUILDER_CODE32-byte hex builder code on every order. Unset uses Tensorust's; all zeros attributes to nobody.

Pricing

Open source

Polymarket Agent FAQ

Is Polymarket Agent free?

Yes. Polymarket Agent is open source, so you can use and self-host it for free.

How do I add Polymarket Agent to Claude Code?

Run this command in your terminal: claude mcp add polymarket-agent --env POLYMARKET_PRIVATE_KEY='<POLYMARKET_PRIVATE_KEY>' -- npx -y https://github.com/Mattbusel/polymarket-agent/releases/download/v0.1.1/polymarket-agent-mcp-0.1.1.mcpb