Keyflow

Search Keyflow

Find a shortcut, workflow, MCP server or skill

three.ws Portfolio

local MCP server

three.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

ServerStarsTypeAPI keyRuntime
three.ws Portfolio218LocalYesnpm
Agent-Native Design6,874HostedNoNone
Agent Swarm835HostedYesNone
Emilia Protocol616LocalYesnpm
Tetrees MCP304HostedYesNone

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
  1. Agent-Native Designio.github.BuilderIO/agent-native-design6,874
  2. Agent Swarmio.github.desplega-ai/agent-swarm835
  3. Emilia Protocolio.github.emiliaprotocol/mcp-server616
  4. Tetrees MCPai.tetrees.ex/mcp304
  5. three.ws Provenanceio.github.nirholas/provenance-mcp218
  6. three.ws Avatars & Agentsio.github.nirholas/three.ws218
  7. Godot MCPio.github.satelliteoflove/godot-mcp171
  8. mcp-server-kalshiio.github.9crusher/mcp-server-kalshi28