MCP Server

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

codex mcp add carboncopy --env CARBONCOPY_API_KEY=cc_your_key -- npx -y @carbon-copy/mcp

opencode mcp add
# Select "local", name "carboncopy", command: 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

Tool	Description
`get_portfolio`	Portfolio summary — total value, P&L, win rate
`get_portfolio_history`	Paginated trade history with date filtering
`get_positions`	Currently open positions

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 any trader

Follow Management

Tool	Description
`list_traders`	All followed traders with copy settings and stats
`follow_trader`	Start following a new trader
`get_trader`	Details for a single followed trader
`update_trader`	Change copy percentage, max amount, notifications
`batch_update_traders`	Update up to 100 followed traders in one call
`unfollow_trader`	Stop following a trader
`pause_trader`	Temporarily pause copy-trading without unfollowing
`resume_trader`	Resume paused copy-trading

Orders & Account

Tool	Description
`list_orders`	Paginated orders with status/date filters
`get_order`	Single order by ID
`get_account`	Account information
`health`	API health check

Resources

The MCP server also exposes two read-only resources that AI agents can pull for context without a tool call:

URI	Description
`carboncopy://portfolio`	Current portfolio snapshot
`carboncopy://traders`	List 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

Getting Started

Reference

Integrations

Overview

Quick Install

Manual Setup

Claude Desktop

Cursor

Any MCP client

Available Tools

Portfolio

Trader Discovery

Follow Management

Orders & Account

Resources

Authentication

Source Code

​Overview

​Quick Install

​Manual Setup

​Claude Desktop

​Cursor

​Any MCP client

​Available Tools

​Portfolio

​Trader Discovery

​Follow Management

​Orders & Account

​Resources

​Authentication

​Source Code

Overview

Quick Install

Manual Setup

Claude Desktop

Cursor

Any MCP client

Available Tools

Portfolio

Trader Discovery

Follow Management

Orders & Account

Resources

Authentication

Source Code