three.ws Portfolio MCP Server

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

claude mcp add portfolio-mcp -- npx -y @three-ws/portfolio-mcp

{
  "mcpServers": {
    "portfolio-mcp": {
      "args": [
        "-y",
        "@three-ws/portfolio-mcp"
      ],
      "command": "npx"
    }
  }
}

[mcp_servers.portfolio-mcp]
command = "npx"
args = ["-y", "@three-ws/portfolio-mcp"]

{
  "mcpServers": {
    "portfolio-mcp": {
      "args": [
        "-y",
        "@three-ws/portfolio-mcp"
      ],
      "command": "npx"
    }
  }
}

{
  "mcpServers": {
    "portfolio-mcp": {
      "args": [
        "-y",
        "@three-ws/portfolio-mcp"
      ],
      "command": "npx"
    }
  }
}

This one needs environment variables set before it will start: 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 (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 (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.). The author declared them in the registry entry; get the values from the project itself.