$THREE Token

@three-ws/three-token-mcp

アクションによってトークンがバーンされる初の MCP サーバーです。あらゆる AI エージェントが Solana 上で $THREE の価格確認、保有、バーンを行えます。

インストール · クイックスタート · ツール · 必要条件 · three.ws

---

あらゆる AI アシスタントに stdio 経由で 3 つの $THREE プリミティブを提供する、Model Context Protocol サーバーです。USD のリアルタイム価格とウォレット残高を確認し、オンチェーンで $THREE をバーンできます。バーン分はインシネレーターと three.ws のトレジャリーに分配され、Jupiter 経由でリアルタイム価格が取得されます。エージェントのプリミティブとしてのデフレーションです。three_burn を呼び出すたびに、$THREE を供給量から永久に除去し、トレジャリーに資金を供給する、実際に検証可能な Solana トランザクションが実行されます。

このサーバーが扱うコインは $THREE のみです。コントラクトアドレス（メインネット SPL）：FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump。

これが他と異なる理由

ほとんどの有料 MCP サーバーは USDC で決済します。このサーバーはプロジェクト独自のトークンを移動し、送金先はハードコードされていません。three.ws の 公開トークンサーフェス（/api/token/config、/api/token/price）から実行時に読み込むため、ミント、デシマル、バーンアドレス、トレジャリー、分配比率は、three.ws の他の機能で使われる正規のオンチェーン設定に常に準拠します。署名の前に、解決されたミントが上記の正規の $THREE アドレスと一致することを検証します。そのため、エンドポイントの設定ミスや侵害があっても、バーン先を別のトークンに変更することはできません。

インストール

npm install @three-ws/three-token-mcp

npx で直接実行できます（インストール不要です）。

SOLANA_SECRET_KEY=<base58> npx @three-ws/three-token-mcp

または、グローバルにインストールして、PATH 上で three-token-mcp バイナリを利用できます。

npm install -g @three-ws/three-token-mcp

クイックスタート

Claude Code：1 行で設定できます。

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

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

{
	"mcpServers": {
		"three-token": {
			"command": "npx",
			"args": ["-y", "@three-ws/three-token-mcp"],
			"env": {
				"SOLANA_SECRET_KEY": "<base58 secret of the wallet that holds $THREE>",
				"SOLANA_RPC_URL": "https://your-rpc-provider"
			}
		}
	}
}

SOLANA_SECRET_KEY が必要なのは three_burn のみです。読み取り専用ツール（three_price、three_balance）は、これなしで動作します。MCP Inspector で機能を確認できます。

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

ツール

ツール	種類	機能
three_price	読み取り専用	$THREE のリアルタイム USD 価格（Jupiter を優先し、利用できない場合は Birdeye にフォールバックします）。トークン数量の見積もりも取得するには、usd を指定します。
three_balance	読み取り専用	任意の pubkey の $THREE と SOL の残高を取得します（デフォルトは設定済みの署名者です）。
three_burn	実行	1 回の Solana トランザクションで、USD 換算額の $THREE をバーンし、インシネレーターとトレジャリーに分配します。署名、内訳、Solscan のリンクを返します。

three_burn がバーンするのは、ウォレットがすでに保有している $THREE です。まず $THREE を取得するには、Solana DEX で SOL を $THREE にスワップしてからバーンしてください。

安全性

3 つのツールすべてに MCP ツールアノテーション が設定されています。three_price と three_balance は readOnlyHint: true を示し、安全に自動承認できます。three_burn には destructiveHint: true が設定されているため、アノテーションに対応した MCP クライアント（Claude Code、Claude Desktop、Cursor）は実行前に確認を求めます。これらのヒントは参考情報です。サーバー側では、すべてのバーンに MAX_BURN_USD（デフォルトは $100）の上限が適用され、REQUIRE_CONFIRM（デフォルトで有効：confirm: true を指定して再度呼び出すまで処理を拒否）による制御も行われます。また、署名の前に、解決された mint が正規の $THREE であることを確認します。これらはクライアントに関係なく適用されます。

入力パラメーター

three_price — usd（省略可能な正の数値：$THREE に換算する USD 額）。

three_balance — pubkey（省略可能な base58。32～64 文字。デフォルトは設定済みの署名者のアドレス）。

three_burn — usd（必須の正の数値：バーンする $THREE の USD 換算額）、burnBps（0～10000、デフォルトは 5000 = 50% をバーン／50% をトレジャリーに分配。10000 = 全額をバーン）、memo（省略可能。120 文字以下。オンチェーンのメモに追加されます）、secret（省略可能な base58 形式の署名者の上書き設定。デフォルトは SOLANA_SECRET_KEY）、confirm（REQUIRE_CONFIRM が有効な場合、取り消せないバーンを実行するには true が必要です）。

例

// three_price
> { "usd": 5 }
{ "price_usd": 0.0042, "quote": { "usd": 5, "token_amount": 1190.47, "atomics": "1190476190" } }

// three_burn — irreversible; confirm:true required by default
> { "usd": 5, "burnBps": 5000, "confirm": true }
{
  "ok": true,
  "signature": "5x...",
  "explorer": "https://solscan.io/tx/5x...",
  "usd": 5,
  "burned": 595.23,
  "legs": [
    { "role": "burn", "amount": 595.23 },
    { "role": "treasury", "amount": 595.23 }
  ]
}

バーンの構築方法

three_burn は、実績のある three.ws のブラウザー決済フローを踏襲しています。

1. GET /api/token/config → mint、decimals、バーンアドレス、トレジャリー。
2. GET /api/token/price?usd=<n> → Jupiter のリアルタイム価格と、正確な $THREE の最小単位数。
3. 1 つのトランザクションを構築します。各分配先（バーンとトレジャリー）ごとに、べき等性のある ATA 作成と SPL 転送を行い、バーンをオンチェーンで識別するメモを追加します。burnBps で均等に割り切れない額の場合、余った最小単位はバーン側に割り当てられるため、バーンされる額が割り当て分を下回ることはありません。burnBps: 10000 の場合（またはトレジャリーが設定されていない場合）は、分配先が 1 つになり、すべてが破棄されます。
4. ウォレットで署名し、送信して確定します。結果にはオンチェーンの署名と、分配先ごとの金額が表示されます。

サーバーは事前に $THREE の残高を確認し、バーンに必要な額を賄えない場合は、わかりやすいエラーを返して速やかに失敗します。内容のわからないオンチェーンエラーは発生しません。バーンには MAX_BURN_USD（デフォルトは $100）の上限が適用され、REQUIRE_CONFIRM（デフォルトで有効）による制御も行われます。

要件

• Node.js >= 20。
• Solana メインネットの RPC エンドポイント（読み取り専用ならパブリッククラスターを利用できます。バーン処理には、Helius／Quicknode／Triton などのエンドポイントを独自に用意してください）。エンドポイントは https である必要があります（ローカル開発用バリデーターでは http://localhost のみ使用できます）。
• バーンには、base58 形式の SOLANA_SECRET_KEY（または呼び出しごとの secret）で指定した、$THREE を保有するウォレットが必要です。

環境変数

変数	必須	デフォルト
SOLANA_SECRET_KEY	バーン時のみ	なし（フォールバックとして FUNDER_SECRET も使用できます）
SOLANA_RPC_URL	いいえ	https://api.mainnet-beta.solana.com
THREE_WS_BASE	いいえ	https://three.ws
MAX_BURN_USD	いいえ	100
REQUIRE_CONFIRM	いいえ	true（確認ゲートをスキップするには 0／false を設定）
THREE_BURN_ADDRESS	いいえ	Solana のインシネレーター

リンク

• ホームページ：https://three.ws
• 変更履歴：https://three.ws/changelog
• イシュー：https://github.com/nirholas/three.ws/issues
• ライセンス：Apache-2.0。詳しくは LICENSE をご覧ください。

---

_{three.ws SDK スイートの一部です — 3D AI エージェント、オンチェーンアイデンティティ、エージェント決済を提供します。
ウェブサイト · 変更履歴 · GitHub}