Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Carbon Copy MCP Server show my portfolio summary"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
An MCP server that gives AI agents programmatic access to Carbon Copy — a Polymarket copy-trading platform.
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: pmxt-mcp
A Carbon Copy account
An API key (generate from the dashboard)
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"
}
}
}
}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"
}
}
}
}Tool | Description |
| Portfolio summary: balance, exposure, gross volume, and P&L |
| Paginated trade history with optional date filtering |
| Live open positions with optional filters |
Tool | Description |
| Search/filter traders by profit, ROI, win rate, volume, followers |
| Detailed performance analytics and P&L history for a trader |
Tool | Description |
| All followed traders with copy settings and stats |
| Start following a trader |
| Details for a single followed trader |
| Update copy trading settings for a followed trader |
| Update up to 100 followed traders in one call |
| Stop following a trader |
| Pause copy trading for a trader (without unfollowing) |
| Resume copy trading for a paused trader |
Tool | Description |
| Paginated orders with optional status/date filters |
| Single order details |
| Account information |
| API health check |
URI | Description |
| Current portfolio snapshot |
| Followed traders list |
npm install
npm run build
npm run dev # Watch mode
npm test # Run testsAll 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).
The API enforces rate limits (60 reads/min, 20 writes/min). The MCP server surfaces rate limit errors transparently — retry after the indicated delay.
MIT
Update settings across multiple followed traders in one request.
Inputs: updates (required).
Close an open position by selling shares back to the market.
Inputs: shares (required), direction (required), marketSlug (required), positionId (required), +1 more.
Search and rank traders available to follow.
Inputs: q, limit, minRoi, sortBy, +2 more.
Start copy-trading a Polymarket trader by their wallet address.
Inputs: wallet (required), copyPercentage (required), maxCopyAmount, notificationsEnabled.
Retrieve your Carbon Copy account details including wallet address, balance, and settings.
Inputs: no named parameters.
Retrieve details about a specific copy-trade order by ID.
Inputs: id (required).
Get a breakdown of realized P&L grouped by each market you have traded.
Inputs: no named parameters.
Get a breakdown of realized P&L grouped by each trader you copy.
Inputs: no named parameters.
Retrieve time-series portfolio P&L data for charting performance over time. Returns snapshots with realized/unrealized P&L breakdown.
Inputs: days, interval.
Retrieve the current portfolio summary including total value, P&L, and allocation.
Inputs: no named parameters.
Retrieve paginated copy-trade history (individual trade records) with optional date filtering. For portfolio value over time, use get_pnl_history instead.
Inputs: limit, since, until, cursor.
Retrieve live open portfolio positions (mark-to-market) with optional filtering. status=closed currently returns an empty set.
Inputs: fresh, limit, since, until, +1 more.
Retrieve details about a specific trader you are following.
Inputs: wallet (required).
Retrieve performance metrics and history for a trader.
Inputs: wallet (required).
Check the health and availability of the Carbon Copy API.
Inputs: no named parameters.
Retrieve a list of copy-trade orders with optional status filter, pagination, and date range.
Inputs: limit, since, until, cursor, +1 more.
List all traders you are currently following.
Inputs: no named parameters.
Pause copy-trading for a specific trader without unfollowing them.
Inputs: wallet (required).
Resume copy-trading for a previously paused trader.
Inputs: wallet (required).
Stop copy-trading a trader and remove them from your follow list.
Inputs: wallet (required).
Update copy-trading settings for a trader you are following.
Inputs: wallet (required), maxCopyAmount, copyPercentage, copyTradingEnabled, +1 more.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 21 tools
Most tools have clear, distinct purposes (positions vs. portfolio vs. traders vs. orders). However, get_portfolio_history and get_pnl_history have overlapping names despite explicit description disambiguation, and get_trader vs. get_trader_performance could be misselected if read quickly.
The set predominantly uses consistent verb_noun snake_case (get_, list_, close_, follow_, etc.). Minor deviations include the bare noun 'health' and the slightly awkward 'batch_update_traders' alongside 'update_trader', but the overall pattern is predictable.
At 21 tools, the set is on the heavier side but remains reasonable for a copy-trading platform. Each tool handles a distinct resource or action, and the count does not feel bloated.
The domain is well-covered: full trader lifecycle (discover/follow/update/pause/resume/unfollow), portfolio and P&L reporting, position management with closing, order lookup, and account access. No critical operations appear missing.
Trading MCP server for AI agents, with live market data, account reads and controlled execution.
MCP server for OpenMM — exposes market data, account, trading, and strategy tools to AI agents
MCP server exposing the Backtest360 engine API as tools for AI agents.
MCP server for Gainium — manage trading bots, deals, and balances via AI assistants
