# Polymarket Copy-Trading Data for AI Agents: MCP, JSON, TSV

> Free, read-only data for AI agents. No key.

## MCP

https://chameleons.markets/mcp

- Claude Code:

  ```
  claude mcp add --transport http chameleons https://chameleons.markets/mcp
  ```
- Claude:

  ```
  Settings → Connectors → Add custom connector → https://chameleons.markets/mcp
  ```
- Cursor:

  ```
  {"mcpServers": {"chameleons": {"url": "https://chameleons.markets/mcp"}}}
  ```
- VS Code:

  ```
  {"servers": {"chameleons": {"type": "http", "url": "https://chameleons.markets/mcp"}}}
  ```
- Codex:

  ```
  [mcp_servers.chameleons]
  url = "https://chameleons.markets/mcp"
  ```

## Tools

| Call | Size |
|---|---|
| `find_traders cat=politics ret_lo=0 stars=all sort=copyable` · `GET /categories/politics.json?ret_lo=0&stars=all&sort=copyable` | 4.0 KB |
| `list_categories` | 0.7 KB |
| `get_trader trader=<name>-<8hex>` · `GET /traders/<name>-<8hex>.json` | 1.9 KB |
| `explain_rating trader=<name>-<8hex>` | 0.9 KB |
| `get_copy_recipe trader=<name>-<8hex>` · `GET /traders/<name>-<8hex>/copy.md` | 4.5 KB |
| `get_bot_guide` · `GET /bots.md` | 26.6 KB |

## Data

Add .json, .tsv or .md to any list or trader page: /index.json · /schema.json · /llms.txt. Defaults match the page; every answer says what applied. Paging: page=2 or offset=50.

Research API, open: /api/v1/schema.json (snapshots, fills, daily list changes). /api/v1/feed: public, no key: leader trades about 20–30 s after they happen, with gate and fill status; reads 60/min per IP (burst 30), 429 + Retry-After over it.

## Bots

Build a copy bot and steer it with these filters: /bots · /bots.md (get_bot_guide).

## Limits

Per IP: 30/min tool calls or uncached reads (burst 20), 20/min heavy (limit=0 or over 50 rows). Over that: 429 with Retry-After.

## Rules

Quote rule: past, modelled, not a recommendation; do not describe as best traders to copy.

Independent; not affiliated with Polymarket; we never trade for you or hold your funds.

Data CC BY 4.0, credit chameleons.markets. Contact ox@mail.grokbot.com.