three.ws Portfolio MCP Server

by nirholasio.github.nirholas/portfolio-mcpv0.1.1

An agent's trading state — portfolio value, PnL, live balances, trade feed, and signed transfers.

228Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active2d ago

Install three.ws Portfolio MCP server

claude mcp add portfolio-nirholas -e THREE_WS_SESSION='<three-ws-session>' -e SOLANA_SECRET_KEY='<solana-secret-key>' -- npx -y @three-ws/portfolio-mcp

{
  "mcpServers": {
    "portfolio-nirholas": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/portfolio-mcp"
      ],
      "env": {
        "THREE_WS_SESSION": "<three-ws-session>",
        "SOLANA_SECRET_KEY": "<solana-secret-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "portfolio-nirholas": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/portfolio-mcp"
      ],
      "env": {
        "THREE_WS_SESSION": "<three-ws-session>",
        "SOLANA_SECRET_KEY": "<solana-secret-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "portfolio-nirholas": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/portfolio-mcp"
      ],
      "env": {
        "THREE_WS_SESSION": "<three-ws-session>",
        "SOLANA_SECRET_KEY": "<solana-secret-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "portfolio-nirholas": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/portfolio-mcp"
      ],
      "env": {
        "THREE_WS_SESSION": "<three-ws-session>",
        "SOLANA_SECRET_KEY": "<solana-secret-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
THREE_WS_BASE	—	—	Base URL of the three.ws API that serves the portfolio + trades endpoints. Override only when self-hosting or targeting a preview deployment.
THREE_WS_TIMEOUT_MS	—	—	Per-request timeout in milliseconds for the live three.ws API reads.
THREE_WS_SESSION	—	yes	Your three.ws session token (the value of the `__Host-sid` cookie from a signed-in browser). Required for the account-scoped reads — get_portfolio_summary, get_portfolio_history, get_portfolio_asset — which return data for the agents YOU own. The public trade feed and on-chain balance reads do not need it. Treat like a password.
SOLANA_RPC_URL	—	—	Solana mainnet RPC endpoint used by get_wallet_balances and send_transfer. Defaults to https://api.mainnet-beta.solana.com — bring your own (Helius / Quicknode / Triton) for production traffic.
SOLANA_SECRET_KEY	yes	yes	Base58-encoded Solana secret key for the wallet that send_transfer signs from. REQUIRED for send_transfer (the only write tool); a per-call `secret` arg overrides it. Not needed for any read tool. Treat like cash.
MAX_SOL_PER_TX	—	—	Per-transaction spend cap in SOL for native SOL transfers via send_transfer. Bounds the blast radius of a leaked key or an injected argument.
RECIPIENT_ALLOWLIST	—	—	Optional comma-separated base58 pubkeys. When set, send_transfer refuses any recipient not in the list.
REQUIRE_CONFIRM	—	—	When on (default), send_transfer refuses until re-issued with confirm:true. Set 0/false to disable the gate.

Freshness

Active — last maintenance signal 2d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-08 · 2d ago · GitHub
Latest release
2026-09-30 · 10d ago · GitHub · v1.5.2
Package published
no data · npm/PyPI
Registry entry updated
2026-08-19 · 51d ago · official registry · v0.1.1

FAQ

›How do I install the three.ws Portfolio MCP server in Claude Code?

Run: claude mcp add portfolio-nirholas -e THREE_WS_SESSION='<three-ws-session>' -e SOLANA_SECRET_KEY='<solana-secret-key>' -- npx -y @three-ws/portfolio-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does three.ws Portfolio require an API key?

Yes. It expects SOLANA_SECRET_KEY, THREE_WS_SESSION, of which 2 are secrets.

›Can I use three.ws Portfolio as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is three.ws Portfolio in the official MCP registry?

Yes, as io.github.nirholas/portfolio-mcp.