{"_id":"@carbon-copy/mcp","_rev":"8-d8769fdd498de32092c99d3cfc3f13b7","name":"@carbon-copy/mcp","dist-tags":{"latest":"0.4.0"},"versions":{"0.1.0":{"name":"@carbon-copy/mcp","version":"0.1.0","keywords":["mcp","carboncopy","polymarket","copy-trading"],"author":"","license":"MIT","_id":"@carbon-copy/mcp@0.1.0","maintainers":[{"name":"bencered","email":"bence@carboncopy.inc"}],"homepage":"https://github.com/CarbonCopyInc/carboncopy-mcp#readme","bugs":{"url":"https://github.com/CarbonCopyInc/carboncopy-mcp/issues"},"bin":{"carboncopy-mcp":"dist/index.js"},"dist":{"shasum":"e5ae2c6a69b3e5ad631c146c66b8986769acd4e8","tarball":"https://registry.npmjs.org/@carbon-copy/mcp/-/mcp-0.1.0.tgz","fileCount":62,"integrity":"sha512-58z5NHToiYM6JbN7p+wRa61YP5OQTMbyJuFU2Y3lamNRPRylV+5BOK+20yaoMhdNx/NVK+NS/0am2Hs9C1TCdQ==","signatures":[{"sig":"MEUCIDFs8cDNOfSYCXT/3Aj10BdiuPcooM+hMyM81Sz9qmoYAiEAkMlZn4XjgMgLjDTD4/KSE8uHXuvYo0sKuwgwLxioayg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":186567},"type":"module","gitHead":"b147d87b0cd621562c8195b52f45fac39e98f45c","scripts":{"dev":"tsc --watch","test":"vitest run","build":"tsc","prepare":"npm run build","test:watch":"vitest","test:coverage":"vitest run --coverage"},"_npmUser":{"name":"bencered","email":"bence@carboncopy.inc"},"repository":{"url":"git+https://github.com/CarbonCopyInc/carboncopy-mcp.git","type":"git"},"_npmVersion":"11.6.2","description":"An MCP server that gives AI agents programmatic access to Carbon Copy - a Polymarket copy-trading platform.","directories":{},"_nodeVersion":"24.11.1","dependencies":{"zod":"^3.25.0","@modelcontextprotocol/sdk":"^1.27.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.0.18","typescript":"^5.8.0","@types/node":"^22.0.0","@vitest/coverage-v8":"^4.0.18"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.0_1773183586457_0.740296980698977","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@carbon-copy/mcp","version":"0.1.1","keywords":["mcp","carboncopy","polymarket","copy-trading"],"author":"","license":"MIT","_id":"@carbon-copy/mcp@0.1.1","maintainers":[{"name":"bencered","email":"bence@carboncopy.inc"}],"homepage":"https://github.com/CarbonCopyInc/carboncopy-mcp#readme","bugs":{"url":"https://github.com/CarbonCopyInc/carboncopy-mcp/issues"},"bin":{"carboncopy-mcp":"dist/index.js"},"dist":{"shasum":"0199c819aad1579a226d16856c93a7ec134b28bf","tarball":"https://registry.npmjs.org/@carbon-copy/mcp/-/mcp-0.1.1.tgz","fileCount":62,"integrity":"sha512-JxQyzOBRuGxT2G/yDcrmFOj7h3sz32YJmZpCfVDXbMCRWjiv+moG/DnU5tnD73LEPNip/uVHitolElKNTpMKzw==","signatures":[{"sig":"MEQCIDSH8jWXLOAZ6B5S2V4KprO9gGiiVl296WIoRkF/L4p3AiB62IiuN5I8mFaIv9JISIjLviU59Ak5dcJVEW882rneYA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@carbon-copy%2fmcp@0.1.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":186613},"type":"module","gitHead":"b1b33dbefd70c016a2975edd273b70e513294767","scripts":{"dev":"tsc --watch","test":"vitest run","build":"tsc","prepare":"npm run build","test:watch":"vitest","test:coverage":"vitest run --coverage"},"_npmUser":{"name":"bencered","email":"bence@carboncopy.inc"},"repository":{"url":"git+https://github.com/CarbonCopyInc/carboncopy-mcp.git","type":"git"},"_npmVersion":"10.9.4","description":"An MCP server that gives AI agents programmatic access to Carbon Copy — a Polymarket copy-trading platform.","directories":{},"_nodeVersion":"22.22.0","dependencies":{"zod":"^3.25.0","@modelcontextprotocol/sdk":"^1.27.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.0.18","typescript":"^5.8.0","@types/node":"^22.0.0","@vitest/coverage-v8":"^4.0.18"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.1_1773184220904_0.33270075899907936","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@carbon-copy/mcp","version":"0.2.0","keywords":["mcp","carboncopy","polymarket","copy-trading"],"author":"","license":"MIT","_id":"@carbon-copy/mcp@0.2.0","maintainers":[{"name":"bencered","email":"bence@carboncopy.inc"}],"homepage":"https://github.com/CarbonCopyInc/carboncopy-mcp#readme","bugs":{"url":"https://github.com/CarbonCopyInc/carboncopy-mcp/issues"},"bin":{"carboncopy-mcp":"dist/index.js"},"dist":{"shasum":"f1ddbe931b615b4ac447d798c34b628bd49d69f1","tarball":"https://registry.npmjs.org/@carbon-copy/mcp/-/mcp-0.2.0.tgz","fileCount":62,"integrity":"sha512-3z8IJ4XHRguAaCIPnqr9sq4SYD8pGfcR5m7tWo8YVhpbH4TmHvkd9oWdKgamUTjIogz0c1ZpRutK2JTwOoM2CQ==","signatures":[{"sig":"MEUCIBL94Un7J1L/qjqltZeHLJszunxQBzkLsFZc8tYeRfETAiEApdq5wmKFAmUI0UmqPdg4/ZtUR6rRQid9Gdu4QSBi2qc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@carbon-copy%2fmcp@0.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":216292},"type":"module","gitHead":"481ef750ad03f76c4f1797f9a0961207fdaac26c","scripts":{"dev":"tsc --watch","test":"vitest run","build":"tsc","prepare":"npm run build","test:watch":"vitest","test:coverage":"vitest run --coverage"},"_npmUser":{"name":"bencered","email":"bence@carboncopy.inc"},"repository":{"url":"git+https://github.com/CarbonCopyInc/carboncopy-mcp.git","type":"git"},"_npmVersion":"10.9.4","description":"An MCP server that gives AI agents programmatic access to Carbon Copy — a Polymarket copy-trading platform.","directories":{},"_nodeVersion":"22.22.0","dependencies":{"zod":"^3.25.0","@modelcontextprotocol/sdk":"^1.27.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.0.18","typescript":"^5.8.0","@types/node":"^22.0.0","@vitest/coverage-v8":"^4.0.18"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.2.0_1773269149007_0.7681343566618777","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@carbon-copy/mcp","version":"0.2.1","keywords":["mcp","carboncopy","polymarket","copy-trading"],"author":"","license":"MIT","_id":"@carbon-copy/mcp@0.2.1","maintainers":[{"name":"bencered","email":"bence@carboncopy.inc"}],"homepage":"https://github.com/CarbonCopyInc/carboncopy-mcp#readme","bugs":{"url":"https://github.com/CarbonCopyInc/carboncopy-mcp/issues"},"bin":{"carboncopy-mcp":"dist/index.js"},"dist":{"shasum":"926442980160e4a2535620394760d8f34738fed8","tarball":"https://registry.npmjs.org/@carbon-copy/mcp/-/mcp-0.2.1.tgz","fileCount":62,"integrity":"sha512-nQO76TfOSVIPJ45AYMKwJwax8V0TYhPLKqF0WiXb6tfZtWHT25IfyCUcreZtglPh/cS9fA3UStb9yNfJSjcACA==","signatures":[{"sig":"MEUCIQDMFmk50sEt39ac+5fLTv2JMHrfGXQ2+SAzzFXUhy5PEAIgK33qQ/TR0Blor6F96GKTs5kwB9q7Ks6ycQ2c7cS0Oxw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@carbon-copy%2fmcp@0.2.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":216308},"type":"module","gitHead":"8e96c60cc56aebc93bef536fcfb3cf51d73bf921","scripts":{"dev":"tsc --watch","test":"vitest run","build":"tsc","prepare":"npm run build","test:watch":"vitest","test:coverage":"vitest run --coverage"},"_npmUser":{"name":"bencered","email":"bence@carboncopy.inc"},"repository":{"url":"git+https://github.com/CarbonCopyInc/carboncopy-mcp.git","type":"git"},"_npmVersion":"10.9.4","description":"An MCP server that gives AI agents programmatic access to Carbon Copy — a Polymarket copy-trading platform.","directories":{},"_nodeVersion":"22.22.0","dependencies":{"zod":"^3.25.0","@modelcontextprotocol/sdk":"^1.27.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.0.18","typescript":"^5.8.0","@types/node":"^22.0.0","@vitest/coverage-v8":"^4.0.18"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.2.1_1773270271124_0.9057473891892573","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@carbon-copy/mcp","version":"0.2.2","keywords":["mcp","carboncopy","polymarket","copy-trading"],"author":"","license":"MIT","_id":"@carbon-copy/mcp@0.2.2","maintainers":[{"name":"bencered","email":"bence@carboncopy.inc"}],"homepage":"https://github.com/CarbonCopyInc/carboncopy-mcp#readme","bugs":{"url":"https://github.com/CarbonCopyInc/carboncopy-mcp/issues"},"bin":{"carboncopy-mcp":"dist/index.js"},"dist":{"shasum":"b88b3ff2dedffa01dfbb6d5d72c5edfedca91564","tarball":"https://registry.npmjs.org/@carbon-copy/mcp/-/mcp-0.2.2.tgz","fileCount":62,"integrity":"sha512-Iyasj4egk28tYaxZY68azazsyk5G7gY4XnZT40G0WTxk2rdmc52T7WkmKwthV/u5Pwga96ciOaSGBSt/68GV1A==","signatures":[{"sig":"MEUCIAct/npIFqQBGdyQc3f+zR7bw7+W6rewO+CpVSu028e2AiEA+wlcSr1uPoY2z5BykG3sBT/qyjI3cb3KGGNqicUYJnw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@carbon-copy%2fmcp@0.2.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":216264},"type":"module","gitHead":"8ea48f87511fb02ba88d8ec5b2361b7532a61ae4","scripts":{"dev":"tsc --watch","test":"vitest run","build":"tsc","prepare":"npm run build","test:watch":"vitest","test:coverage":"vitest run --coverage"},"_npmUser":{"name":"bencered","email":"bence@carboncopy.inc"},"repository":{"url":"git+https://github.com/CarbonCopyInc/carboncopy-mcp.git","type":"git"},"_npmVersion":"10.9.4","description":"An MCP server that gives AI agents programmatic access to Carbon Copy — a Polymarket copy-trading platform.","directories":{},"_nodeVersion":"22.22.0","dependencies":{"zod":"^3.25.0","@modelcontextprotocol/sdk":"^1.27.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.0.18","typescript":"^5.8.0","@types/node":"^22.0.0","@vitest/coverage-v8":"^4.0.18"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.2.2_1773274446238_0.45615897440884967","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@carbon-copy/mcp","version":"0.3.0","keywords":["mcp","carboncopy","polymarket","copy-trading"],"author":"","license":"MIT","_id":"@carbon-copy/mcp@0.3.0","maintainers":[{"name":"bencered","email":"bence@carboncopy.inc"}],"homepage":"https://github.com/CarbonCopyInc/carboncopy-mcp#readme","bugs":{"url":"https://github.com/CarbonCopyInc/carboncopy-mcp/issues"},"bin":{"carboncopy-mcp":"dist/index.js"},"dist":{"shasum":"8879c05e34319c5002f94d985b0202a1c32d38e2","tarball":"https://registry.npmjs.org/@carbon-copy/mcp/-/mcp-0.3.0.tgz","fileCount":63,"integrity":"sha512-mv9cNfF/mlvR17URRfHCK2USCRxvQ/YBklybmsm/bKjhEm0TVm/Dy7gS57tME2lPX0QN1IdXUMqgt21eHSbbvA==","signatures":[{"sig":"MEUCIFgr+qZzcQOvd5bsVUYkmQCYTwWlBTZqPj40fgJgaAgUAiEA/1FyhSEDX/jUxY4evrI+3WTocgcx37JgvDKi+PDbY0U=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@carbon-copy%2fmcp@0.3.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":224233},"type":"module","gitHead":"16a97f619147455e837e8bc36e1c57e307f2e1d3","scripts":{"dev":"tsc --watch","test":"vitest run","build":"tsc","prepare":"husky","test:watch":"vitest","test:coverage":"vitest run --coverage"},"_npmUser":{"name":"bencered","email":"bence@carboncopy.inc"},"repository":{"url":"git+https://github.com/CarbonCopyInc/carboncopy-mcp.git","type":"git"},"_npmVersion":"10.9.4","description":"An MCP server that gives AI agents programmatic access to Carbon Copy — a Polymarket copy-trading platform.","directories":{},"_nodeVersion":"22.22.0","dependencies":{"zod":"^3.25.0","@modelcontextprotocol/sdk":"^1.27.0"},"_hasShrinkwrap":false,"devDependencies":{"husky":"^9.1.7","vitest":"^4.0.18","typescript":"^5.8.0","@types/node":"^22.0.0","@vitest/coverage-v8":"^4.0.18"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.3.0_1773335059058_0.673478639926294","host":"s3://npm-registry-packages-npm-production"}},"0.3.1":{"name":"@carbon-copy/mcp","version":"0.3.1","keywords":["mcp","carboncopy","polymarket","copy-trading"],"author":"","license":"MIT","_id":"@carbon-copy/mcp@0.3.1","maintainers":[{"name":"bencered","email":"bence@carboncopy.inc"}],"homepage":"https://github.com/CarbonCopyInc/carboncopy-mcp#readme","bugs":{"url":"https://github.com/CarbonCopyInc/carboncopy-mcp/issues"},"bin":{"carboncopy-mcp":"dist/index.js"},"dist":{"shasum":"e028fbff1c12bfda893ad4364ee758c561b762a8","tarball":"https://registry.npmjs.org/@carbon-copy/mcp/-/mcp-0.3.1.tgz","fileCount":47,"integrity":"sha512-NCThk8bRNs4LuDOEchbefqWlYD8iYtBuW5N2ZQKnjRuJM3vnpIpmW7sHLa1NI1y4H3HhbaXZTav3Xqm9vmqJhw==","signatures":[{"sig":"MEYCIQD8zHG01xg/Ft7963cW12TZowQ/m/TxzJCSIKBtHxBwCwIhAKGQ1AQuExgmrU4pwZiDYLrv6uvF2srYZO7WPFQIbAsG","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@carbon-copy%2fmcp@0.3.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":149239},"type":"module","gitHead":"6585ab9063cc9aeaf011d8887ca6b9435f6cc829","scripts":{"dev":"tsc --watch","test":"vitest run","build":"tsc","prepare":"husky","test:watch":"vitest","test:coverage":"vitest run --coverage"},"_npmUser":{"name":"bencered","email":"bence@carboncopy.inc"},"repository":{"url":"git+https://github.com/CarbonCopyInc/carboncopy-mcp.git","type":"git"},"_npmVersion":"10.9.4","description":"An MCP server that gives AI agents programmatic access to Carbon Copy — a Polymarket copy-trading platform.","directories":{},"_nodeVersion":"22.22.0","dependencies":{"zod":"^3.25.0","@modelcontextprotocol/sdk":"^1.27.0"},"_hasShrinkwrap":false,"devDependencies":{"husky":"^9.1.7","vitest":"^4.0.18","typescript":"^5.8.0","@types/node":"^22.0.0","@vitest/coverage-v8":"^4.0.18"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.3.1_1773345320589_0.11180463094498494","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"@carbon-copy/mcp","version":"0.4.0","description":"An MCP server that gives AI agents programmatic access to Carbon Copy — a Polymarket copy-trading platform.","type":"module","bin":{"carboncopy-mcp":"dist/index.js"},"scripts":{"build":"tsc","dev":"tsc --watch","prepare":"husky","test":"vitest run","test:watch":"vitest","test:coverage":"vitest run --coverage"},"repository":{"type":"git","url":"git+https://github.com/CarbonCopyInc/carboncopy-mcp.git"},"keywords":["mcp","carboncopy","polymarket","copy-trading"],"author":"","license":"MIT","bugs":{"url":"https://github.com/CarbonCopyInc/carboncopy-mcp/issues"},"homepage":"https://github.com/CarbonCopyInc/carboncopy-mcp#readme","dependencies":{"@modelcontextprotocol/sdk":"^1.27.0","zod":"^3.25.0"},"devDependencies":{"@types/node":"^22.0.0","@vitest/coverage-v8":"^4.0.18","husky":"^9.1.7","typescript":"^5.8.0","vitest":"^4.0.18"},"_id":"@carbon-copy/mcp@0.4.0","gitHead":"dda1798530720acf52687ef22a836a9b539c00a5","_nodeVersion":"22.22.0","_npmVersion":"10.9.4","dist":{"integrity":"sha512-MhrzQuCKtGnSV+6NN9IpxxM+4GPrDP1ZQ1vT00u4Vi8YB68sR17PrX7aostpGCVVcQVtGAtzDnRlK2A8YncmcQ==","shasum":"b2b769b5ef06876f63dfda4ebb132f5799689b41","tarball":"https://registry.npmjs.org/@carbon-copy/mcp/-/mcp-0.4.0.tgz","fileCount":47,"unpackedSize":154948,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@carbon-copy%2fmcp@0.4.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDIOg8X/eklgSovfZwKFWk56ERghoVZutmZNJ8g6OnvWQIhAM12O9NgmfSaO8C+4Fcm+PeSFjvoVX3P2xjrMBS4hDCt"}]},"_npmUser":{"name":"bencered","email":"bence@carboncopy.inc"},"directories":{},"maintainers":[{"name":"bencered","email":"bence@carboncopy.inc"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_0.4.0_1773443006136_0.29509077812460194"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-10T22:59:46.347Z","modified":"2026-03-13T23:03:26.628Z","0.1.0":"2026-03-10T22:59:46.625Z","0.1.1":"2026-03-10T23:10:21.090Z","0.2.0":"2026-03-11T22:45:49.174Z","0.2.1":"2026-03-11T23:04:31.286Z","0.2.2":"2026-03-12T00:14:06.398Z","0.3.0":"2026-03-12T17:04:19.249Z","0.3.1":"2026-03-12T19:55:20.742Z","0.4.0":"2026-03-13T23:03:26.299Z"},"bugs":{"url":"https://github.com/CarbonCopyInc/carboncopy-mcp/issues"},"license":"MIT","homepage":"https://github.com/CarbonCopyInc/carboncopy-mcp#readme","keywords":["mcp","carboncopy","polymarket","copy-trading"],"repository":{"type":"git","url":"git+https://github.com/CarbonCopyInc/carboncopy-mcp.git"},"description":"An MCP server that gives AI agents programmatic access to Carbon Copy — a Polymarket copy-trading platform.","maintainers":[{"name":"bencered","email":"bence@carboncopy.inc"}],"readme":"# Carbon Copy MCP Server\n\nAn [MCP](https://modelcontextprotocol.io) server that gives AI agents programmatic access to [Carbon Copy](https://carboncopy.inc) — a Polymarket copy-trading platform.\n\n## Features\n\n- **Portfolio Management** — View portfolio summary (including live positions value and unrealised P&L), open positions, and trade history\n- **Trader Discovery** — Search and filter traders by profit, ROI, win rate, volume, and followers\n- **Follow Management** — Follow/unfollow traders, pause/resume copy trading, adjust per-trader settings\n- **Batch Operations** — Update up to 100 followed traders in a single call\n- **Performance Analytics** — Trader P&L history, drawdown, and Sharpe ratio\n- **Order Tracking** — List and inspect copy trade orders with filtering\n- **Account Info** — Access account details\n- **Cursor Pagination** — Iterate through large datasets efficiently\n\n## Quick Start\n\n### Prerequisites\n\n1. A [Carbon Copy](https://carboncopy.inc) account\n2. An API key (generate from the dashboard)\n\n### Usage with Claude Desktop\n\nAdd to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"carboncopy\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@carbon-copy/mcp\"],\n      \"env\": {\n        \"CARBONCOPY_API_KEY\": \"cc_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n### Usage with Cursor\n\nAdd to `.cursor/mcp.json` in your project:\n\n```json\n{\n  \"mcpServers\": {\n    \"carboncopy\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@carbon-copy/mcp\"],\n      \"env\": {\n        \"CARBONCOPY_API_KEY\": \"cc_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n## Available Tools\n\n### Portfolio\n\n| Tool | Description |\n|------|-------------|\n| `get_portfolio` | Portfolio summary: balance, positions value, unrealised P&L, win rate |\n| `get_portfolio_history` | Paginated trade history with optional date filtering |\n| `get_positions` | Open positions with pagination |\n\n### Trader Discovery\n\n| Tool | Description |\n|------|-------------|\n| `discover_traders` | Search/filter traders by profit, ROI, win rate, volume, followers |\n| `get_trader_performance` | Detailed performance analytics and P&L history for a trader |\n\n### Follow Management\n\n| Tool | Description |\n|------|-------------|\n| `list_traders` | All followed traders with copy settings and stats |\n| `follow_trader` | Start following a trader |\n| `get_trader` | Details for a single followed trader |\n| `update_trader` | Update copy trading settings for a followed trader |\n| `batch_update_traders` | Update up to 100 followed traders in one call |\n| `unfollow_trader` | Stop following a trader |\n| `pause_trader` | Pause copy trading for a trader (without unfollowing) |\n| `resume_trader` | Resume copy trading for a paused trader |\n\n### Orders & Account\n\n| Tool | Description |\n|------|-------------|\n| `list_orders` | Paginated orders with optional status/date filters |\n| `get_order` | Single order details |\n| `get_account` | Account information |\n| `health` | API health check |\n\n## Resources\n\n| URI | Description |\n|-----|-------------|\n| `carboncopy://portfolio` | Current portfolio snapshot |\n| `carboncopy://traders` | Followed traders list |\n\n## Development\n\n```bash\nnpm install\nnpm run build\nnpm run dev           # Watch mode\nnpm test              # Run tests\n```\n\n## Authentication\n\nAll tools authenticate via `CARBONCOPY_API_KEY` (format: `cc_<64 hex chars>`). Generate keys from the [Carbon Copy dashboard](https://carboncopy.inc).\n\nAPI keys carry **scoped permissions** (`portfolio`, `traders`, `orders`, `markets`, `account`). Tools return a `403` permission error if your key lacks the required scope.\n\nYou can override the default API origin with `CARBONCOPY_BASE_URL` (defaults to `https://carboncopy.inc`).\n\n## Rate Limits\n\nThe API enforces rate limits (60 reads/min, 20 writes/min). The MCP server surfaces rate limit errors transparently — retry after the indicated delay.\n\n## Links\n\n- [Carbon Copy](https://carboncopy.inc)\n- [API Reference](https://github.com/CarbonCopyInc/habakkuk/blob/main/docs/API_REFERENCE.md)\n- [OpenAPI Spec](https://docs.carboncopy.inc/api-reference/openapi.json)\n\n## License\n\nMIT\n","readmeFilename":"README.md"}