Polymarket trading, market discovery, copy trading and backtesting — 48 MCP tools.
Connect Runs on your machine
claude mcp add polymarket-agent-mcp -e COPY_MODE=<COPY_MODE> -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> -e POLY_FUNDER_ADDRESS=<POLY_FUNDER_ADDRESS> -e DAILY_BUDGET=<DAILY_BUDGET> -e MIN_CONVICTION=<MIN_CONVICTION> -e CHAIN_ID=<CHAIN_ID> -e DB_PATH=<DB_PATH> -- npx -y [email protected]{
"mcpServers": {
"polymarket-agent-mcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"COPY_MODE": "<COPY_MODE>",
"POLY_PRIVATE_KEY": "<POLY_PRIVATE_KEY>",
"POLY_API_KEY": "<POLY_API_KEY>",
"POLY_API_SECRET": "<POLY_API_SECRET>",
"POLY_API_PASSPHRASE": "<POLY_API_PASSPHRASE>",
"POLY_FUNDER_ADDRESS": "<POLY_FUNDER_ADDRESS>",
"DAILY_BUDGET": "<DAILY_BUDGET>",
"MIN_CONVICTION": "<MIN_CONVICTION>",
"CHAIN_ID": "<CHAIN_ID>",
"DB_PATH": "<DB_PATH>"
}
}
}
}{
"mcpServers": {
"polymarket-agent-mcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"COPY_MODE": "<COPY_MODE>",
"POLY_PRIVATE_KEY": "<POLY_PRIVATE_KEY>",
"POLY_API_KEY": "<POLY_API_KEY>",
"POLY_API_SECRET": "<POLY_API_SECRET>",
"POLY_API_PASSPHRASE": "<POLY_API_PASSPHRASE>",
"POLY_FUNDER_ADDRESS": "<POLY_FUNDER_ADDRESS>",
"DAILY_BUDGET": "<DAILY_BUDGET>",
"MIN_CONVICTION": "<MIN_CONVICTION>",
"CHAIN_ID": "<CHAIN_ID>",
"DB_PATH": "<DB_PATH>"
}
}
}
}{
"servers": {
"polymarket-agent-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"COPY_MODE": "<COPY_MODE>",
"POLY_PRIVATE_KEY": "<POLY_PRIVATE_KEY>",
"POLY_API_KEY": "<POLY_API_KEY>",
"POLY_API_SECRET": "<POLY_API_SECRET>",
"POLY_API_PASSPHRASE": "<POLY_API_PASSPHRASE>",
"POLY_FUNDER_ADDRESS": "<POLY_FUNDER_ADDRESS>",
"DAILY_BUDGET": "<DAILY_BUDGET>",
"MIN_CONVICTION": "<MIN_CONVICTION>",
"CHAIN_ID": "<CHAIN_ID>",
"DB_PATH": "<DB_PATH>"
}
}
}
}Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
COPY_MODEOptional | 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_KEYOptional, 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_KEYOptional, secret | Polymarket CLOB API key. Required only when COPY_MODE=live. |
POLY_API_SECRETOptional, secret | Polymarket CLOB API secret. Required only when COPY_MODE=live. |
POLY_API_PASSPHRASEOptional, secret | Polymarket CLOB API passphrase. Required only when COPY_MODE=live. |
POLY_FUNDER_ADDRESSOptional | Polymarket funder wallet address (proxy wallet) used for live trading. |
DAILY_BUDGETOptional | Maximum USDC the agent may spend per day. Used by BudgetManager to cap copy-trading exposure. |
MIN_CONVICTIONOptional | Minimum conviction score (0–100) required before a copy trade is executed. |
CHAIN_IDOptional | EVM chain ID for Polymarket (137 = Polygon mainnet). |
DB_PATHOptional | Optional override for the SQLite database path. Defaults to a package-local file. |
Details
| Package | [email protected] (NPM, stdio) |
| First published | 7 Aug 2026 |
| Last updated | 7 Aug 2026 |
| Registry name | io.github.demwick/polymarket-agent-mcp |
More ai and media servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.