three.ws Portfolio

@three-ws/portfolio-mcp

MCP を通じて AI エージェント自身の取引状況を確認できます。ポートフォリオ価値、PnL、リアルタイム残高、公開取引フィードに加え、署名付きオンチェーン Solana 送金という実際の書き込み操作を 1 つ提供します。

---

AI エージェントが stdio 経由で自身の取引状況にプログラムからアクセスできる Model Context Protocol サーバーです。保有資産、価値の推移、リアルタイム市場データを含む単一トークンのポジション、クローズ済み取引と実現損益のプラットフォーム全体のフィード、任意のウォレットのリアルタイムオンチェーン残高を確認できます。さらに、SOL または任意の SPL トークンを署名付きで送金する実際の書き込み操作を 1 つ提供します。

読み取りではライブの three.ws API と Solana RPC に接続し、モックは一切使用しません。アカウントに紐づく読み取りでは、three.ws のセッションから解決される、お客様が所有するエージェントウォレットにアクセスします。唯一の書き込み操作である send_transfer は、お客様自身のキーを使用してローカルで署名し、メインネット上の実際の資金を移動します。

インストール

npm install @three-ws/portfolio-mcp

または npx で実行できます（インストール不要）：

npx @three-ws/portfolio-mcp

クイックスタート

Claude Code の場合は 1 行です：

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

Claude Desktop / Cursor の場合（claude_desktop_config.json または mcp.json）：

{
	"mcpServers": {
		"portfolio": {
			"command": "npx",
			"args": ["-y", "@three-ws/portfolio-mcp"],
			"env": {
				"THREE_WS_SESSION": "<your __Host-sid cookie>",
				"SOLANA_SECRET_KEY": "<base58 secret of the sending wallet>"
			}
		}
	}
}

THREE_WS_SESSION はアカウントに紐づく読み取りにのみ必要です。SOLANA_SECRET_KEY は send_transfer にのみ必要です。取引フィードとオンチェーン残高の読み取りは、設定なしで利用できます。

MCP Inspector で機能を確認できます：

npx -y @modelcontextprotocol/inspector npx @three-ws/portfolio-mcp

ツール

ツール	種類	機能
get_portfolio_summary	読み取り · セッション	お客様が所有するすべてのエージェントウォレットのリアルタイム保有資産と米ドル価値を、ウォレットごとの内訳とともに表示します。任意でスナップショットも取得できます。
get_portfolio_history	読み取り · セッション	保存済みスナップショットに基づき、時間の経過に伴うポートフォリオ全体の米ドル価値を表示します。パフォーマンスチャートを確認できます。
get_portfolio_asset	読み取り · セッション	1 つのトークンを詳しく確認します。保有しているウォレット、合計数量と米ドル価値に加え、リアルタイム市場データと価格履歴チャートを表示します。
get_trades_feed	読み取り · パブリック	クローズ済みポジションと実現損益のプラットフォーム全体のフィードです。最新の決済が先に表示され、コインで絞り込めます。
get_wallet_balances	読み取り · パブリック	任意の Solana アドレスのリアルタイムオンチェーン SOL および SPL（Token-2022 を含む）残高を、RPC から直接取得します。
send_transfer	書き込み · 破壊的操作	お客様自身のウォレットから SOL または任意の SPL トークンを送金する、取り消し不可能な Solana メインネット上の実際の送金に署名し、ブロードキャストします。

すべての読み取りはライブ状態を参照します。残高、フィード、ブロードキャストの内容は呼び出しの間に変化するため、べき等なツールはありません。send_transfer のみが状態を変更します。

入力パラメーター

get_portfolio_summary — snapshot（bool、デフォルトは false — 履歴ポイントも保存します）。

get_portfolio_history — days（1～365、デフォルトは90）。

get_portfolio_asset：chain（solana | evm、必須）、id（native または base58 のミントアドレス／0x コントラクトアドレス、必須）、days（1～365、デフォルトは30）、chain_id（任意の EVM チェーン ID：8453 Base、1 Ethereum、42161 Arbitrum、10 Optimism、137 Polygon、56 BNB、およびプラットフォームがインデックスするその他のチェーン）。chain_id を省略すると、API はウォレットが保有する任意のチェーン上のコントラクトを価格付けします。デフォルトは Base です。同じアドレスが複数のチェーンに存在する場合は、chain_id を指定してください。

get_trades_feed — network（mainnet | devnet、デフォルトは mainnet）、window（1h | 6h | 24h | 7d | 30d | all、デフォルトは24h）、min_pnl_pct（デフォルトは10）、limit（1～80、デフォルトは40）、cursor（ページネーション用の ISO タイムスタンプ）、mint（1つのコインに絞り込むフィルター）。

get_wallet_balances — address（base58、必須）、include_tokens（bool、デフォルトは true）。

send_transfer — recipient（base58、必須）、amount（10進数文字列、必須）、mint（base58 の SPL ミントアドレス。SOL の場合は省略するか native を指定）、secret（base58。SOLANA_SECRET_KEY より優先）、priorityMicroLamports（0～50,000,000）、confirm（実行には true が必須）。

実現価値と現在価値

異なる質問には、それぞれ異なるツールを使います。

• 「今の資産価値はいくらですか？」 → get_portfolio_summary / get_portfolio_asset — 保有資産を現在の USD 価格で評価します。
• 「決済済みの取引実績はどうですか？」 → get_trades_feed — 決済済みポジションごとの実現 PnL（SOL でのエントリー／決済価格、利益率、倍率、保有時間）。

書き込みツール — send_transfer

send_transfer は、Solana mainnet 上で実際の取り消し不能なトランザクションをブロードキャストし、署名に使用するウォレットから資金を移動します。呼び出しごとの secret または SOLANA_SECRET_KEY を使ってローカルで署名するため、three.ws API が秘密鍵を保持することはありません。安全対策：

• REQUIRE_CONFIRM が有効な場合（デフォルト）、confirm: true が必須です。指定せずに最初の呼び出しを行うと、ブロードキャストではなく拒否が返されます。
• MAX_SOL_PER_TX は、ネイティブ SOL の送金上限を設定します（デフォルトは0.5 SOL）。
• RECIPIENT_ALLOWLIST を設定すると、送金先を既知の宛先に制限できます。
• mint は実行時の入力値です。$THREE のミントアドレスや、保有している任意の SPL トークンを渡せます。ミントアドレスはハードコードされていません。

SPL トークンの送金では、オンチェーンでミントの小数桁数を読み取り、残高を確認し、送金先の関連トークンアカウントが存在しない場合は自動で作成します。確認がタイムアウトすると、再試行を黙って行うのではなく、署名付きの tx_unconfirmed を返します。二重支払いを避けるため、再送信する前に Solscan を確認してください。

要件

• Node.js >= 20。
• https://three.ws（または独自の THREE_WS_BASE）と Solana RPC へのネットワークアクセス。

環境変数

変数	必須	デフォルト
THREE_WS_BASE	いいえ	https://three.ws
THREE_WS_TIMEOUT_MS	いいえ	20000
THREE_WS_SESSION	アカウント単位の読み取りに必要	—
SOLANA_RPC_URL	いいえ	https://api.mainnet-beta.solana.com
SOLANA_SECRET_KEY	send_transfer に必要	—
MAX_SOL_PER_TX	いいえ	0.5
RECIPIENT_ALLOWLIST	いいえ	—（有効な公開鍵ならすべて許可）
REQUIRE_CONFIRM	いいえ	true

THREE_WS_SESSION は、サインイン済みの three.ws ブラウザーセッションにある __Host-sid Cookie の値です。これと SOLANA_SECRET_KEY はパスワードと同様に取り扱ってください。

リンク

• ホームページ：https://three.ws
• 変更履歴：https://three.ws/changelog
• 課題：https://github.com/nirholas/three.ws/issues
• ライセンス：Apache-2.0。LICENSEを参照してください。

---

_{three.ws SDK スイートの一部です — 3D AI エージェント、オンチェーン ID、エージェント向け決済。
ウェブサイト · 変更履歴 · GitHub}