three.ws Copy Trading — Claude Code MCP server: setup and features
Manage three.ws leader follows through an AI agent: adjust copy sizing and guard rules, review pending intents, and check fees. The server leaves transaction execution to you.
claude mcp add --env THREE_WS_API_KEY=<THREE_WS_API_KEY> --env THREE_WS_BASE=<THREE_WS_BASE> --env THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> --transport stdio copy-mcp -- npx -y @three-ws/copy-mcpWhat three.ws Copy Trading does
Use the server to inspect follows, start one for a leader, or change its settings. Copy sizing can use a fixed amount, a multiplier, or a percentage of the wallet balance. You can also set trade and daily limits, apply guards, and review copy intents with their statuses and fee accruals.
An agent can mark an intent as acted or dismissed, but the server does not sign transactions or hold funds. You must act from your own wallet. Set THREE_WS_API_KEY to a three.ws API key or OAuth access token before connecting; account credentials are required to manage follows.
What it helps with
- follow a leader with a chosen copy size
- cap trade amounts and daily spending
- pause or revise a leader follow
- review pending copy intents and their status
- check fees accrued from copied leaders
Example prompts for the agent
- Follow this leader with a fixed copy size and a daily budget.
- Show my pending copy intents and explain their statuses.
- Pause this follow and check the fees accrued across my copied leaders.
How to install three.ws Copy Trading
Platform CLI
claude mcp add --env THREE_WS_API_KEY=<THREE_WS_API_KEY> --env THREE_WS_BASE=<THREE_WS_BASE> --env THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> --transport stdio copy-mcp -- npx -y @three-ws/copy-mcpReplace <…> with your own values
Platform CLI
codex mcp add copy-mcp --env THREE_WS_API_KEY=<THREE_WS_API_KEY> --env THREE_WS_BASE=<THREE_WS_BASE> --env THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> -- npx -y @three-ws/copy-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"copy-mcp": {
"command": "npx",
"args": [
"-y",
"@three-ws/copy-mcp"
],
"env": {
"THREE_WS_API_KEY": "<THREE_WS_API_KEY>",
"THREE_WS_BASE": "<THREE_WS_BASE>",
"THREE_WS_TIMEOUT_MS": "<THREE_WS_TIMEOUT_MS>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"copy-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@three-ws/copy-mcp"
],
"env": {
"THREE_WS_API_KEY": "<THREE_WS_API_KEY>",
"THREE_WS_BASE": "<THREE_WS_BASE>",
"THREE_WS_TIMEOUT_MS": "<THREE_WS_TIMEOUT_MS>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e THREE_WS_API_KEY=<THREE_WS_API_KEY> -e THREE_WS_BASE=<THREE_WS_BASE> -e THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> copy-mcp npx -y @three-ws/copy-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about three.ws Copy Trading
How do I install three.ws Copy Trading in Claude Code?
Add it with claude mcp add copy-mcp -e THREE_WS_API_KEY=<THREE_WS_API_KEY> -- npx -y @three-ws/copy-mcp. Replace the placeholder with a valid three.ws key.
What does three.ws Copy Trading do?
It manages your three.ws leader follows, copy sizing and guard settings, and lets you inspect intents and fees. It does not execute trades for you.
Does the server need an API key?
Yes. Set THREE_WS_API_KEY to a three.ws API key or an OAuth access token before connecting.
