Carbon Copy MCP Server

An MCP server that gives AI agents programmatic access to Carbon Copy — a Polymarket copy-trading platform.

Features

• Portfolio Management — View portfolio summary (including exposure, gross volume, and unrealized P&L), open positions, and trade history

• Trader Discovery — Search and filter traders by profit, ROI, win rate, volume, and followers

• Follow Management — Follow/unfollow traders, pause/resume copy trading, adjust per-trader settings

• Batch Operations — Update up to 100 followed traders in a single call

• Performance Analytics — Trader P&L history, drawdown, and Sharpe ratio

• Order Tracking — List and inspect copy trade orders with filtering

• Account Info — Access account details

• Cursor Pagination — Iterate through large datasets efficiently

Related MCP server: Polymarket Agent Mcp

Quick Start

Prerequisites

1. A Carbon Copy account

2. An API key (generate from the dashboard)

Usage with Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "carboncopy": {
      "command": "npx",
      "args": ["-y", "@carbon-copy/mcp"],
      "env": {
        "CARBONCOPY_API_KEY": "cc_your_key_here"
      }
    }
  }
}

Usage with Cursor

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "carboncopy": {
      "command": "npx",
      "args": ["-y", "@carbon-copy/mcp"],
      "env": {
        "CARBONCOPY_API_KEY": "cc_your_key_here"
      }
    }
  }
}

Available Tools

Portfolio

Trader Discovery

Follow Management

Orders & Account

Resources

Development

npm install
npm run build
npm run dev           # Watch mode
npm test              # Run tests

Authentication

All tools authenticate via CARBONCOPY_API_KEY (format: cc_<64 hex chars>). Generate keys from the Carbon Copy dashboard.

API keys carry scoped permissions (portfolio, traders, orders, markets, account). Tools return a 403 permission error if your key lacks the required scope.

You can override the default API origin with CARBONCOPY_BASE_URL (defaults to https://carboncopy.inc).

Rate Limits

The API enforces rate limits (60 reads/min, 20 writes/min). The MCP server surfaces rate limit errors transparently — retry after the indicated delay.

Links

• Carbon Copy

• API Reference

• OpenAPI Spec

License

MIT