# three.ws Copy Trading

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 249
- Author: nirholas
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/nirholas/three.ws/tree/HEAD/packages/copy-mcp
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/threews-copy-trading

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `THREE_WS_API_KEY`, `THREE_WS_BASE`, `THREE_WS_TIMEOUT_MS` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
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-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
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-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

**Platform CLI**
```bash
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-mcp
```
Replace <…> with your own values

## When to use it
- 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
- 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.

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44583
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5458
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2814
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2188
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

From the same set: [nirholas/three.ws](https://affpapa.org/en/nevibecode/by/nirholas/three.ws.md) — 43 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md