Carbon Copy MCP Server

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