Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.carboncopy.inc/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

The Carboncopy MCP server lets AI agents — like Claude, Cursor, or any MCP-compatible client — manage your Polymarket copy-trading portfolio through natural tool calls. Install it with a single line. No code required.

​
Quick Install

claude mcp add carboncopy -s user -e CARBONCOPY_API_KEY=cc_your_key -- npx -y @carbon-copy/mcp
Replace cc_your_key with your actual API key from Settings.

​
Manual Setup

​
Claude Desktop

Add to your 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"
      }
    }
  }
}

​
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"
      }
    }
  }
}

​
Any MCP client

The server uses stdio transport — any MCP-compatible client can run it: 
CARBONCOPY_API_KEY=cc_... npx @carbon-copy/mcp

​
Available Tools

​
Portfolio

ToolDescription
get_portfolioPortfolio summary — total value, P&L, win rate
get_portfolio_historyPaginated trade history with date filtering
get_positionsCurrently open positions

​
Trader Discovery

ToolDescription
discover_tradersSearch/filter traders by profit, ROI, win rate, volume, followers
get_trader_performanceDetailed performance analytics and P&L history for any trader

​
Follow Management

ToolDescription
list_tradersAll followed traders with copy settings and stats
follow_traderStart following a new trader
get_traderDetails for a single followed trader
update_traderChange copy percentage, max amount, notifications
batch_update_tradersUpdate up to 100 followed traders in one call
unfollow_traderStop following a trader
pause_traderTemporarily pause copy-trading without unfollowing
resume_traderResume paused copy-trading

​
Orders & Account

ToolDescription
list_ordersPaginated orders with status/date filters
get_orderSingle order by ID
get_accountAccount information
healthAPI health check

​
Resources

The MCP server also exposes two read-only resources that AI agents can pull for context without a tool call:
URIDescription
carboncopy://portfolioCurrent portfolio snapshot
carboncopy://tradersList of followed traders

​
Authentication

Set the CARBONCOPY_API_KEY environment variable. The server passes it as a Bearer token on every API call. Generate a key from Settings → API Keys. For full agent access, grant portfolio:read, traders:write, orders:read, and account:read.

​
Source Code

The MCP server is open source: github.com/CarbonCopyInc/carboncopy-mcp