Server data from the Official MCP Registry
Search Polymarket, read order books and prices, and place or cancel CLOB v2 orders from your agent
About
Search Polymarket, read order books and prices, and place or cancel CLOB v2 orders from your agent
Security Report
Valid MCP server (2 strong, 4 medium validity signals). No known CVEs in dependencies. Imported from the Official MCP Registry.
6 files analyzed · No issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Environment variable: POLYMARKET_PRIVATE_KEY
Environment variable: POLYMARKET_FUNDER
Environment variable: POLYMARKET_SIGNATURE_TYPE
Environment variable: POLYMARKET_BUILDER_CODE
How to Install
Install command not verified. See the repository for install instructions.
View repositoryDocumentation
View on GitHubFrom the project's GitHub README.
polymarket-agent
Polymarket for AI agents. One Rust binary that is both a CLI and an MCP server: search markets, read books and prices, place and cancel CLOB v2 orders, list positions. No Node, no Python, one cargo install.
cargo install polymarket-agent
Use it from any agent
Shell (Claude Code, Codex, Cursor agents, cron jobs, your own loop):
polymarket-agent search "fed rate cut" --limit 3
polymarket-agent price 20882952001141190985444129909954556515852282417019672850316979275117126535717
polymarket-agent book 20882952001141190985444129909954556515852282417019672850316979275117126535717 --depth 5
polymarket-agent limit 2088...5717 buy 0.05 100 # GTC limit: token, side, price, shares
polymarket-agent limit 2088...5717 buy 0.05 100 --dry-run # sign only, print the order, send nothing
polymarket-agent market-order 2088...5717 buy 25 # FOK market buy for 25 USDC
polymarket-agent orders | cancel <id> | cancel-all | trades | positions
Every command prints JSON.
MCP (Claude Desktop, Claude Code, Cursor, Windsurf, anything that speaks MCP over stdio):
{
"mcpServers": {
"polymarket": {
"command": "polymarket-agent",
"args": ["mcp"],
"env": { "POLYMARKET_PRIVATE_KEY": "0x..." }
}
}
}
Claude Code one-liner: claude mcp add polymarket -e POLYMARKET_PRIVATE_KEY=0x... -- polymarket-agent mcp
Tools exposed: search_markets, get_market, get_orderbook, get_price, check_geoblock, place_limit_order, place_market_order, cancel_order, cancel_all_orders, list_open_orders, list_trades, get_positions, builder_attribution.
Keys and wallets
- Read-only commands need nothing.
- Trading needs
POLYMARKET_PRIVATE_KEY: the hex private key of the Polygon EOA that signs orders. The key never leaves your machine; it signs EIP-712 orders locally and derives Polymarket L2 API credentials on first use. - Polymarket proxy or Safe wallets (accounts created on polymarket.com with email or a browser wallet): set
POLYMARKET_FUNDERto the proxy wallet address shown on your profile andPOLYMARKET_SIGNATURE_TYPEtoproxyorsafe. Plain EOA users leave both unset. - Funds: the trading wallet needs pUSD (or USDC) on Polygon with the exchange allowances set. Set them once on polymarket.com or with the official SDKs.
Builder attribution (read this)
Every order this tool signs carries a Polymarket builder code in the order's builder field. The default is Tensorust's code:
0xa1101e5f6b3f69288122de5e489cd6574d9b4fc4b7bc7482de0c66b7e9193c96
That attributes the volume to the Tensorust builder profile under the Polymarket Builder Program, and Polymarket adds a builder fee to taker fills (Tensorust's rate is 0.25 percent taker, 0 maker; it is public on the profile). It is how this tool is paid for.
You can change it in one env var:
POLYMARKET_BUILDER_CODE=0x<your code>attributes volume to your own builder profile (create one at polymarket.com, Settings, Builders).POLYMARKET_BUILDER_CODE=0x0000000000000000000000000000000000000000000000000000000000000000attributes to nobody and pays no builder fee.
polymarket-agent builder-code prints the code in effect. polymarket-agent limit ... --dry-run shows the exact signed order so you can see the field yourself.
Geoblocking
Polymarket rejects orders from blocked regions and asks builders to check location before sending. Trading commands call Polymarket's own geoblock endpoint first and refuse to send if it says blocked; polymarket-agent geoblock shows the answer for your machine. This tool does nothing to work around that.
Library
use polymarket_agent::Agent;
let agent = Agent::new()?; // reads POLYMARKET_PRIVATE_KEY if present
let hits = agent.search("fed rate cut", 3).await?;
let book = agent.book("2088...5717", 10).await?;
let fill = agent.limit("2088...5717", "buy", "0.05", "100", false, false).await?;
Built on the official polymarket_client_sdk_v2 and rmcp crates.
Status
v0.1: CLOB v2, Gamma search, Data API positions, stdio MCP. Not yet: websockets, perps, combos, the gasless relayer. Issues and PRs welcome.
Made by Tensorust.
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Rea
Freeby Morluto · Developer Tools
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
Paperclip
Freeby Paperclipai · Developer Tools
Trending hip-hop artist momentum scores across four cultural dimensions.
Scrapling
Freeby D4Vinci · Developer Tools
Web scraping with stealth HTTP, real browsers, and Cloudflare bypass. CSS selectors supported.
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
