PolyTrackers Agent Skill — Copy Trading & Paper Trading for Polymarket, built for AI agents

Copy trading and paper (mock) trading for Polymarket, built for AI agents. This repo packages the PolyTrackers Agent Skill plus MCP server config so Claude, Cursor, Codex, OpenClaw, and other MCP hosts can pull Polymarket market intelligence, whale tracking, anomaly detection, and copy-trading review, then use tier-gated paper-trading and real-trade workflows. Free MCP access is read-only; the separate PolyTrackers web app includes a free $10K virtual wallet.

• Website: https://polytrackers.com
• Agent skill (canonical): https://polytrackers.com/skill.md
• Agent guidance for automated clients: https://polytrackers.com/llms.txt
• OpenAPI contract: https://polytrackers.com/api/openapi.json
• API docs: https://polytrackers.com/docs/api

Install

# Agent Skills CLI
npx skills add polytrackers/polymarket-copy-trading-skill

# ClawHub
npx clawhub install polymarket-copy-trading

SKILL.md in this repo is derived from the canonical, maintained skill at https://polytrackers.com/skill.md.

Free tier

You can start for free — no card required — through two distinct surfaces:

• Free MCP access. Free accounts can generate a scoped Agent API Key (ptk_...). Free MCP access is read-only and uses exactly the signals:read scope. It covers market, anomaly, account, and recommendation reads plus mock wallet inspection, live mock prices, P&L summaries, and the caller's own full-depth real-trade receipts. It does not include MCP writes or mock analytics export. Free-tier data shaping applies to other read surfaces, with 10 requests/min per tool plus 200 requests/day shared across all tools.
• Free web-app mock trading. Separately from MCP, a free account can use one mock wallet in the PolyTrackers web app. It starts with $10,000 in virtual funds for testing strategies against live Polymarket odds. See https://polytrackers.com/polymarket-paper-trading.

Pro adds optional narrow real-trade and scan scopes, mock analytics export, and larger history windows. Elite adds agent:full for broad writes, including committed mock trades. The authoritative source for what your key can do is the live MCP capabilities payload (pt_mcp_capabilities_get); pricing and upgrade details live in the PolyTrackers account/subscription UI.

What agents can do

• Market intelligence — search markets, composed market intel, CLOB and mock entry prices, and lifecycle/contradiction warnings.
• Whale tracking & copy-trading review — whale activity/performance, recommendations, trader profiles, leaderboard, and mock copy-trading roster review.
• Anomaly detection — list/inspect anomaly signals with tier-gated history and (Pro+) scan triggering.
• Paper / mock trading (tier-gated over MCP) — Free MCP access can inspect mock wallets, prices, and P&L summaries. Committed mock writes require agent:full, which normal Agent API Key generation provides only on Elite; that includes creating wallets, placing simulated trades (sized by notional cost), setting a paper-only 1–100x whale-copy sizing multiplier, and resolving/reconciling positions. Existing risk ceilings still apply; real copies stay 1x. Mock analytics export requires Pro or Elite with signals:read.
• Real trade execution (Pro/Elite, gated) — pt_trade_preflight then pt_trade_execute only after explicit user approval, with idempotency and preflight-token safeguards.

Full tool groups, scopes, and safety rules are in SKILL.md.

MCP setup

PolyTrackers exposes a hosted MCP endpoint at https://polytrackers.com/api/mcp. Use that hosted Streamable HTTP endpoint when your MCP host supports it.

Create an Agent API Key from your PolyTrackers Profile (ptk_...), then add one of the following server blocks. Prefer the hosted Streamable HTTP endpoint when your MCP host supports it. If your