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

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

Tool	Description
get_portfolio	Portfolio summary: balance, exposure, gross volume, and P&L
get_portfolio_history	Paginated trade history with optional date filtering
get_positions	Live open positions with optional filters

Trader Discovery

Tool	Description
discover_traders	Search/filter traders by profit, ROI, win rate, volume, followers
get_trader_performance	Detailed performance analytics and P&L history for a trader

Follow Management

Tool	Description
list_traders	All followed traders with copy settings and stats
follow_trader	Start following a trader
get_trader	Details for a single followed trader
update_trader	Update copy trading settings for a followed trader
batch_update_traders	Update up to 100 followed traders in one call
unfollow_trader	Stop following a trader
pause_trader	Pause copy trading for a trader (without unfollowing)
resume_trader	Resume copy trading for a paused trader

Orders & Account

Tool	Description
list_orders	Paginated orders with optional status/date filters
get_order	Single order details
get_account	Account information
health	API health check

Resources

URI	Description
carboncopy://portfolio	Current portfolio snapshot
carboncopy://traders	Followed traders list

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