Package

three.ws Portfolio

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

io.github.nirholas/portfolio-mcpSource repository
Version0.1.2latest catalog version
ConnectionPackagenpm
PublishedOct 10, 2026catalog
UpdatedOct 10, 2026catalog
Overview

What this server provides

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

Install

Packages

1
Package 1npm
@three-ws/portfolio-mcp0.1.2
  • 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.

    Format: string · Default: https://three.ws
    Optional
  • THREE_WS_TIMEOUT_MS

    Per-request timeout in milliseconds for the live three.ws API reads.

    Format: number · Default: 20000
    Optional
  • 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.

    Format: string
    Optional
  • 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.

    Format: string · Default: https://api.mainnet-beta.solana.com
    Optional
  • 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.

    Format: string
    Required
  • 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.

    Format: number · Default: 0.5
    Optional
  • RECIPIENT_ALLOWLIST

    Optional comma-separated base58 pubkeys. When set, send_transfer refuses any recipient not in the list.

    Format: string
    Optional
  • REQUIRE_CONFIRM

    When on (default), send_transfer refuses until re-issued with confirm:true. Set 0/false to disable the gate.

    Format: boolean · Default: true
    Optional
View server metadata