Polymarket Agent Kit
Intelligence for Polymarket trading bots and AI agents — scored wallets, insider signals, funding clusters, whale flow, and live market data over 1.88B indexed on-chain fills, delivered to your agent through MCP or REST.
The official Polymarket/agents repo (3.7K★) was archived in May 2026 and no longer runs. This kit is a maintained, intelligence-first path for the same builders: connect your agent to the CrowdIntel MCP server for the decision side, and pair it with the official CLOB client for execution.
Read-only by design. No custody, no order placement, no keys to your funds. Your agent decides with CrowdIntel data; it trades through Polymarket's official CLOB API. Not affiliated with Polymarket — see DISCLAIMER.
60-second quickstart (Claude Desktop)
- Sign in at crowdintel.xyz → Settings → API → mint an MCP token (
cint_mcp_…). Free on every plan, no credit card.
- Add to your
claude_desktop_config.json:
{
"mcpServers": {
"crowdintel": {
"type": "http",
"url": "https://mcp.crowdintel.xyz/mcp",
"headers": {
"Authorization": "Bearer cint_mcp_YOUR_TOKEN_HERE"
}
}
}
}
- Restart Claude Desktop. Ask: "Which Polymarket wallets have real category edge in politics right now?"
Cursor, Zed, and raw JSON-RPC setups: quickstart/. Every endpoint also exists as plain REST — see the API reference and the drop-in AI context doc.
What your agent gets
| Group | Tools |
|---|
| Wallets | get_wallet_stats (flagship dossier), get_wallet_timing (entry-timing edge), get_wallet_alerts (insider scores), search_wallets |
| Markets | get_market, get_market_alerts, get_market_flow (smart-money vs crowd), get_market_movers, get_whale_activity |
| Clusters | get_cluster, find_funding_clusters |
| Alpha discovery | scan_insider_signals, screen_wallets_by_edge |
| Cohorts | list_cohorts, get_cohort |
| Investigations | get_investigation, list_investigations |
| Leaderboard | get_leaderboard |
Full parameter reference: docs/tools.md.
Recipes — agent patterns that work
- Follow the smart money on a hot market —
get_market_movers → get_market_flow → get_whale_activity.
- Should my agent trust this wallet's signal? —
search_wallets → get_wallet_stats + get_wallet_timing + get_wallet_alerts. Raw win rates lie (small samples, wash trading, sybil clusters); the dossier ships shrinkage-adjusted stats.
- Find a coordinated ring before it resolves —
scan_insider_signals / find_funding_clusters → get_cluster.
- Category-specialist copy-trade screen —
screen_wallets_by_edge → get_leaderboard.
Each recipe ends where execution begins: hand the decision to the official CLOB client. This kit never places orders.
Agent Skills
Four drop-in skills for Claude / Cursor / any Agent-Skills client — each one is
a procedure, not a prompt, and each states where its numbers come from:
Copy skills/ into ~/.claude/skills/ (or your client's skills directory).
Rate limits
Every tool answers on a free token; paid tiers raise the caps (see pricing). MCP daily calls: 20 free / 50 Pro / 300 Terminal / 1,500 Terminal Pro. REST: 50 req/hr free up to 5,000 req/hr Terminal Pro.
Links
Docs
- docs/metrics.md — the formulas: EV-per-dollar CI, event-clustered z, FDR q-values, the gated insider score.
- docs/pitfalls.md — seven ways Polymarket wallet data lies to you. Win rate can filter a board; it can never sort one.
- docs/comparison.md — honest comparison, including when to use the official CLOB, a raw dataset, or Bitquery instead.
- docs/tools.md — every tool, by group.
- examples/ — Python screener, TypeScript webhook receiver, MCP config.
- openapi.json — the full REST spec (40 endpoints), refreshed weekly by CI.
Last updated: 2026-08-16 · 1.88B fills · 2.13M markets · 3.06M scored wallets (freshness).
License
MIT. Not affiliated with, endorsed by, or sponsored by Polymarket — see DISCLAIMER.