three.ws Portfolio
local MCP serverthree.ws Portfolio is a local MCP server: An agent's trading state — portfolio value, PnL, live balances, trade feed, and signed transfers. Install it from npm as @three-ws/portfolio-mcp.
Installation
Terminal
claude mcp add io-github-nirholas-portfolio-mcp -e THREE_WS_BASE=... -e THREE_WS_TIMEOUT_MS=... -e THREE_WS_SESSION=... -e SOLANA_RPC_URL=... -e SOLANA_SECRET_KEY=... -e MAX_SOL_PER_TX=... -e RECIPIENT_ALLOWLIST=... -e REQUIRE_CONFIRM=... -- npx -y @three-ws/portfolio-mcp
Run in your project folder. Add --scope user to use it everywhere.
Claude Desktop, Cursor & other clients
Add to claude_desktop_config.json or .cursor/mcp.json.
{
"mcpServers": {
"io-github-nirholas-portfolio-mcp": {
"command": "npx",
"args": [
"-y",
"@three-ws/portfolio-mcp"
],
"env": {
"THREE_WS_BASE": "...",
"THREE_WS_TIMEOUT_MS": "...",
"THREE_WS_SESSION": "...",
"SOLANA_RPC_URL": "...",
"SOLANA_SECRET_KEY": "...",
"MAX_SOL_PER_TX": "...",
"RECIPIENT_ALLOWLIST": "...",
"REQUIRE_CONFIRM": "..."
}
}
}
}Fill in the environment variables with your own credentials.
What you need
- Runtime: Node.js 18+ (runs with npx).
- MCP client: Claude Code, Codex, Antigravity, Claude Desktop, Cursor or any other client that speaks MCP over stdio.
- Environment variables:
THREE_WS_BASE,THREE_WS_TIMEOUT_MS,THREE_WS_SESSION,SOLANA_RPC_URL,SOLANA_SECRET_KEY,MAX_SOL_PER_TX,RECIPIENT_ALLOWLIST,REQUIRE_CONFIRM
Summary
An agent's trading state — portfolio value, PnL, live balances, trade feed, and signed transfers.
three.ws Portfolio vs similar servers
| Server | Stars | Type | API key | Runtime |
|---|---|---|---|---|
| three.ws Portfolio | 218 | Local | Yes | npm |
| Agent-Native Design | 6,874 | Hosted | No | None |
| Agent Swarm | 835 | Hosted | Yes | None |
| Emilia Protocol | 616 | Local | Yes | npm |
| Tetrees MCP | 304 | Hosted | Yes | None |
Questions
It reads 8 environment variables: THREE_WS_BASE, THREE_WS_TIMEOUT_MS, THREE_WS_SESSION, SOLANA_RPC_URL, SOLANA_SECRET_KEY, MAX_SOL_PER_TX, RECIPIENT_ALLOWLIST, REQUIRE_CONFIRM. Set them in your MCP config before starting the server.
Node.js 18+ (runs with npx), plus an MCP client such as Claude Code, Codex, Claude Desktop or Cursor.
three.ws Portfolio is a local MCP server distributed as the npm package @three-ws/portfolio-mcp.
Run: claude mcp add io-github-nirholas-portfolio-mcp -e THREE_WS_BASE=... -e THREE_WS_TIMEOUT_MS=... -e THREE_WS_SESSION=... -e SOLANA_RPC_URL=... -e SOLANA_SECRET_KEY=... -e MAX_SOL_PER_TX=... -e RECIPIENT_ALLOWLIST=... -e REQUIRE_CONFIRM=... -- npx -y @three-ws/portfolio-mcp
Run: codex mcp add io-github-nirholas-portfolio-mcp --env THREE_WS_BASE=... --env THREE_WS_TIMEOUT_MS=... --env THREE_WS_SESSION=... --env SOLANA_RPC_URL=... --env SOLANA_SECRET_KEY=... --env MAX_SOL_PER_TX=... --env RECIPIENT_ALLOWLIST=... --env REQUIRE_CONFIRM=... -- npx -y @three-ws/portfolio-mcp
Similar MCP servers
NameStars
- Agent-Native Designio.github.BuilderIO/agent-native-design6,874
- Agent Swarmio.github.desplega-ai/agent-swarm835
- Emilia Protocolio.github.emiliaprotocol/mcp-server616
- Tetrees MCPai.tetrees.ex/mcp304
- three.ws Provenanceio.github.nirholas/provenance-mcp218
- three.ws Avatars & Agentsio.github.nirholas/three.ws218
- Godot MCPio.github.satelliteoflove/godot-mcp171
- mcp-server-kalshiio.github.9crusher/mcp-server-kalshi28