AI Plugin Index
three.ws Portfolio
CommunityMCP server by nirholas · updated · ★ 241
An agent's trading state — portfolio value, PnL, live balances, trade feed, and signed transfers. three.ws Portfolio is a community project by nirholas, not verified by a company domain.
Last commit 3 days ago
Apache-2.0: permissive, fine for commercial use
Clear description, published package or server URL, 241 stars, original repository
Runs a script automatically when the package is installed
What you need
| Setting | Needed | What it is |
|---|---|---|
SOLANA_Environment variable, secret | Required | 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. |
THREE_Environment variable | Optional | Base URL of the three.ws API that serves the portfolio + trades endpoints. Override only when self-hosting or targeting a preview deployment. Default: https://three.ws |
THREE_Environment variable | Optional | Per-request timeout in milliseconds for the live three.ws API reads. Default: 20000 |
THREE_Environment variable, secret | Optional | 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 ow |
SOLANA_Environment variable | Optional | 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. Default: https://api.mainnet-beta.solana.com |
MAX_Environment variable | Optional | 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. Default: 0.5 |
RECIPIENT_Environment variable | Optional | Optional comma-separated base58 pubkeys. When set, send_transfer refuses any recipient not in the list. |
REQUIRE_Environment variable | Optional | When on (default), send_transfer refuses until re-issued with confirm:true. Set 0/false to disable the gate. Default: true |
From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.
Install three.ws Portfolio
Built from the published package, never by AIclaude mcp add three-ws-portfolio -e SOLANA_SECRET_KEY=YOUR_SOLANA_SECRET_KEY -- npx -y @three-ws/portfolio-mcpRun in your terminal. Add --scope user to use it in every project.
{
"mcpServers": {
"three-ws-portfolio": {
"command": "npx",
"args": [
"-y",
"@three-ws/portfolio-mcp"
],
"env": {
"SOLANA_SECRET_KEY": "YOUR_SOLANA_SECRET_KEY"
}
}
}
}Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.
{
"mcpServers": {
"three-ws-portfolio": {
"command": "npx",
"args": [
"-y",
"@three-ws/portfolio-mcp"
],
"env": {
"SOLANA_SECRET_KEY": "YOUR_SOLANA_SECRET_KEY"
}
}
}
}Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).
{
"servers": {
"three-ws-portfolio": {
"command": "npx",
"args": [
"-y",
"@three-ws/portfolio-mcp"
],
"env": {
"SOLANA_SECRET_KEY": "YOUR_SOLANA_SECRET_KEY"
}
}
}
}Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".
codex mcp add three-ws-portfolio --env SOLANA_SECRET_KEY=YOUR_SOLANA_SECRET_KEY -- npx -y @three-ws/portfolio-mcp{
"mcpServers": {
"three-ws-portfolio": {
"command": "npx",
"args": [
"-y",
"@three-ws/portfolio-mcp"
],
"env": {
"SOLANA_SECRET_KEY": "YOUR_SOLANA_SECRET_KEY"
}
}
}
}Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).
gemini mcp add three-ws-portfolio npx -y @three-ws/portfolio-mcpGemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.
MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the three-ws-portfolio block.
Weekly newsletter
Like three.ws Portfolio? Get the best new MCP servers every week
The best new tools, security warnings before you install something risky, and one practical tip. Free, three minute read.
Security check
B- Runs a script automatically when the package is installedIn
package.json:"postinstall":
Checked automatically: README.md, package.json. This looks for known risky patterns and is not a full audit. How grades work
Alternatives to three.ws Portfolio
All alternatives →
MCP server integrating with Stripe - tools for customers, products, payments, and more.
Official CCXT MCP server - Market data and trading across 100+ exchanges and prediction markets
200+ transparent financial metrics calculated from raw statements, not third-party endpoints.
JS API for Yahoo Finance
x402 Payment Protocol
x402 Payment Protocol
three.ws Portfolio: common questions
How do I install three.ws Portfolio?
In Claude Code run claude mcp add three-ws-portfolio -e SOLANA_SECRET_KEY=YOUR_SOLANA_SECRET_KEY -- npx -y @three-ws/portfolio-mcp. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.
Is three.ws Portfolio the official server?
three.ws Portfolio is a community project by nirholas, not verified by a company domain.
Is three.ws Portfolio free?
The code is published under the Apache-2.0 licence. The service it connects to may have its own pricing.
Is three.ws Portfolio safe to use?
It scores 82 of 100. Grades: maintenance A, licence A, quality B. Security check: grade B (runs a script automatically when the package is installed). Review the code before you install. How grades work.
What are alternatives to three.ws Portfolio?
Similar MCP servers: mcp, CCXT, Finance Toolkit, Yahoo Finance2.
Does three.ws Portfolio work with ChatGPT?
Not directly. It runs locally, and ChatGPT only connects to remote servers with a URL. Use it in Claude Code, Claude Desktop, Cursor, VS Code or Codex.