Search / io.github.nirholas/portfolio-mcp
three.ws Portfolio
L0· runs locallyAn agent's trading state — portfolio value, PnL, live balances, trade feed, and signed transfers.
v0.1.2 · active · repository · website · descriptor JSON · versions
Search / io.github.nirholas/portfolio-mcp
L0· runs locallyAn agent's trading state — portfolio value, PnL, live balances, trade feed, and signed transfers.
v0.1.2 · active · repository · website · descriptor JSON · versions
{
"mcpServers": {
"portfolio-mcp": {
"command": "npx",
"args": [
"-y",
"@three-ws/[email protected]"
],
"env": {
"THREE_WS_BASE": "https://three.ws",
"THREE_WS_TIMEOUT_MS": "20000",
"THREE_WS_SESSION": "${THREE_WS_SESSION}",
"SOLANA_RPC_URL": "https://api.mainnet-beta.solana.com",
"SOLANA_SECRET_KEY": "${SOLANA_SECRET_KEY}",
"MAX_SOL_PER_TX": "0.5",
"REQUIRE_CONFIRM": "true"
}
}
}
}claude mcp add portfolio-mcp -e "THREE_WS_BASE=https://three.ws" -e "THREE_WS_TIMEOUT_MS=20000" -e "THREE_WS_SESSION=${THREE_WS_SESSION}" -e "SOLANA_RPC_URL=https://api.mainnet-beta.solana.com" -e "SOLANA_SECRET_KEY=${SOLANA_SECRET_KEY}" -e "MAX_SOL_PER_TX=0.5" -e "REQUIRE_CONFIRM=true" -- npx -y @three-ws/[email protected][mcp_servers.portfolio-mcp]
command = "npx"
args = ["-y", "@three-ws/[email protected]"]
env = { "THREE_WS_BASE" = "https://three.ws", "THREE_WS_TIMEOUT_MS" = "20000", "THREE_WS_SESSION" = "${THREE_WS_SESSION}", "SOLANA_RPC_URL" = "https://api.mainnet-beta.solana.com", "SOLANA_SECRET_KEY" = "${SOLANA_SECRET_KEY}", "MAX_SOL_PER_TX" = "0.5", "REQUIRE_CONFIRM" = "true" }
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"portfolio-mcp": {
"type": "local",
"command": [
"npx",
"-y",
"@three-ws/[email protected]"
],
"enabled": true,
"environment": {
"THREE_WS_BASE": "https://three.ws",
"THREE_WS_TIMEOUT_MS": "20000",
"THREE_WS_SESSION": "{env:THREE_WS_SESSION}",
"SOLANA_RPC_URL": "https://api.mainnet-beta.solana.com",
"SOLANA_SECRET_KEY": "{env:SOLANA_SECRET_KEY}",
"MAX_SOL_PER_TX": "0.5",
"REQUIRE_CONFIRM": "true"
}
}
}
}{
"mcpServers": {
"portfolio-mcp": {
"command": "npx",
"args": [
"-y",
"@three-ws/[email protected]"
],
"env": {
"THREE_WS_BASE": "https://three.ws",
"THREE_WS_TIMEOUT_MS": "20000",
"THREE_WS_SESSION": "${THREE_WS_SESSION}",
"SOLANA_RPC_URL": "https://api.mainnet-beta.solana.com",
"SOLANA_SECRET_KEY": "${SOLANA_SECRET_KEY}",
"MAX_SOL_PER_TX": "0.5",
"REQUIRE_CONFIRM": "true"
}
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=portfolio-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkB0aHJlZS13cy9wb3J0Zm9saW8tbWNwQDAuMS4yIl0sImVudiI6eyJUSFJFRV9XU19CQVNFIjoiaHR0cHM6Ly90aHJlZS53cyIsIlRIUkVFX1dTX1RJTUVPVVRfTVMiOiIyMDAwMCIsIlRIUkVFX1dTX1NFU1NJT04iOiIke1RIUkVFX1dTX1NFU1NJT059IiwiU09MQU5BX1JQQ19VUkwiOiJodHRwczovL2FwaS5tYWlubmV0LWJldGEuc29sYW5hLmNvbSIsIlNPTEFOQV9TRUNSRVRfS0VZIjoiJHtTT0xBTkFfU0VDUkVUX0tFWX0iLCJNQVhfU09MX1BFUl9UWCI6IjAuNSIsIlJFUVVJUkVfQ09ORklSTSI6InRydWUifX0%3D"
}{
"servers": {
"portfolio-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@three-ws/[email protected]"
],
"env": {
"THREE_WS_BASE": "https://three.ws",
"THREE_WS_TIMEOUT_MS": "20000",
"THREE_WS_SESSION": "${THREE_WS_SESSION}",
"SOLANA_RPC_URL": "https://api.mainnet-beta.solana.com",
"SOLANA_SECRET_KEY": "${SOLANA_SECRET_KEY}",
"MAX_SOL_PER_TX": "0.5",
"REQUIRE_CONFIRM": "true"
}
}
}
}{
"mcpServers": {
"portfolio-mcp": {
"command": "npx",
"args": [
"-y",
"@three-ws/[email protected]"
],
"env": {
"THREE_WS_BASE": "https://three.ws",
"THREE_WS_TIMEOUT_MS": "20000",
"THREE_WS_SESSION": "${THREE_WS_SESSION}",
"SOLANA_RPC_URL": "https://api.mainnet-beta.solana.com",
"SOLANA_SECRET_KEY": "${SOLANA_SECRET_KEY}",
"MAX_SOL_PER_TX": "0.5",
"REQUIRE_CONFIRM": "true"
}
}
}
}extensions:
"portfolio-mcp":
enabled: true
name: "portfolio-mcp"
type: stdio
cmd: "npx"
args:
- "-y"
- "@three-ws/[email protected]"
envs:
"THREE_WS_BASE": "https://three.ws"
"THREE_WS_TIMEOUT_MS": "20000"
"THREE_WS_SESSION": "${THREE_WS_SESSION}"
"SOLANA_RPC_URL": "https://api.mainnet-beta.solana.com"
"SOLANA_SECRET_KEY": "${SOLANA_SECRET_KEY}"
"MAX_SOL_PER_TX": "0.5"
"REQUIRE_CONFIRM": "true"
timeout: 300
Placeholders to fill from your own secret store: ${THREE_WS_SESSION}, ${SOLANA_SECRET_KEY}. The registry never accepts secret values.
This is a local package: the command runs on your machine.
Not scored: fewer than three checks apply, usually because no remote answered a credential-free probe or the server is a local package.
protocol.modern, protocol.stateless, protocol.transport, protocol.list_ttlno remote answered a protocol handshake (not probed yet, unreachable, or local-only)auth.prm, auth.as_metadata, auth.cimdno remote uses OAuthauth.secret_in_urlno templated URLtools.descriptions, tools.description_length, tools.schemas, tools.annotations, tools.directory_hints, tools.token_cost, tools.api_dumptool list unknown (behind auth, not probed, or empty)stability.changes, stability.rug_pulltool list unknowndeps.known_vulns5 advisories of lower severity or without a published fix: GHSA-3gc7-fjrx-p6mg in [email protected] (indirect, no fix yet), GHSA-528h-pc64-c93x in [email protected] (indirect, fixed in 3.5.0), GHSA-hqr4-qq8f-hg3x in [email protected] (indirect, fixed in 3.6.0), ...deps.mcp_sdk_version@modelcontextprotocol/sdk 1.32.1, no known advisorydeps.resolvable@three-ws/[email protected] resolved: 183 packagesNo tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+repository +namespace-matches-repo +website ~liveness-unmeasured +updated-9d-ago -duplicate-repo(51 names)
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
@three-ws/[email protected] npm182 dependencies, resolved · MCP SDK @modelcontextprotocol/sdk 1.32.1 · advisories checked 2026-10-19
| advisory | severity | package | fixed in |
|---|---|---|---|
| GHSA-3gc7-fjrx-p6mgbigint-buffer Vulnerable to Buffer Overflow via toBigIntLE() Function | high | [email protected]indirect | no fix yet |
| GHSA-528h-pc64-c93xstream-json: pick/ignore/filter/replace filters are O(depth²) on nested input — small crafted JSON blocks the event loop for seconds→minutes (DoS) | moderate | [email protected]indirect | fixed in 3.5.0 |
| GHSA-hqr4-qq8f-hg3xstream-json: JSONC parser and verifier re-scan the whole accumulated comment on every input chunk | moderate | [email protected]indirect | fixed in 3.6.0 |
| GHSA-mjw6-4jj6-33hcstream-json has a prototype pollution issue: Assembler writes this.current[this.key] on plain objects | moderate | [email protected]indirect | fixed in 3.6.0 |
| GHSA-w5hq-g745-h8pquuid: Missing buffer bounds check in v3/v5/v6 when buf is provided | moderate | [email protected]indirect | fixed in 11.1.1 |
Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.
| package | registry | version | runtime | secrets |
|---|---|---|---|---|
@three-ws/portfolio-mcp | npm | 0.1.2 | npx | THREE_WS_SESSION, SOLANA_SECRET_KEY |
No tools observed. Local packages are never executed by the registry.
Schemas: list_tools.
50 other active names share this repository (showing 10): io.github.nirholas/3d-agent-mcp, io.github.nirholas/3D-AI-Agent-Avatar, io.github.nirholas/activity-mcp, io.github.nirholas/agenc-mcp, io.github.nirholas/agentcore-payments-mcp, io.github.nirholas/agent-sniper, io.github.nirholas/agora-mcp, io.github.nirholas/alerts-mcp, io.github.nirholas/alibaba-cloud, io.github.nirholas/assistant-widget
And 73 more from this publisher.
{
"name": "io.github.nirholas/portfolio-mcp",
"icons": [
{
"src": "https://three.ws/three-ws-mcp-icon.svg",
"sizes": [
"any"
],
"mimeType": "image/svg+xml"
}
],
"title": "three.ws Portfolio",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"version": "0.1.2",
"packages": [
{
"version": "0.1.2",
"transport": {
"type": "stdio"
},
"identifier": "@three-ws/portfolio-mcp",
"runtimeHint": "npx",
"registryType": "npm",
"environmentVariables": [
{
"name": "THREE_WS_BASE",
"format": "string",
"default": "https://three.ws",
"description": "Base URL of the three.ws API that serves the portfolio + trades endpoints. Override only when self-hosting or targeting a preview deployment."
},
{
"name": "THREE_WS_TIMEOUT_MS",
"format": "number",
"default": "20000",
"description": "Per-request timeout in milliseconds for the live three.ws API reads."
},
{
"name": "THREE_WS_SESSION",
"format": "string",
"isSecret": true,
"description": "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."
},
{
"name": "SOLANA_RPC_URL",
"format": "string",
"default": "https://api.mainnet-beta.solana.com",
"description": "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."
},
{
"name": "SOLANA_SECRET_KEY",
"format": "string",
"isSecret": true,
"isRequired": true,
"description": "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."
},
{
"name": "MAX_SOL_PER_TX",
"format": "number",
"default": "0.5",
"description": "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."
},
{
"name": "RECIPIENT_ALLOWLIST",
"format": "string",
"description": "Optional comma-separated base58 pubkeys. When set, send_transfer refuses any recipient not in the list."
},
{
"name": "REQUIRE_CONFIRM",
"format": "boolean",
"default": "true",
"description": "When on (default), send_transfer refuses until re-issued with confirm:true. Set 0/false to disable the gate."
}
]
}
],
"repository": {
"url": "https://github.com/nirholas/three.ws",
"source": "github",
"subfolder": "packages/portfolio-mcp"
},
"websiteUrl": "https://three.ws",
"description": "An agent's trading state — portfolio value, PnL, live balances, trade feed, and signed transfers."
}