three.ws Vanity

@three-ws/vanity-mcp

あらゆるAIエージェントから、three.wsのバニティアドレス探索バウンティ市場とレア度ギャラリーを閲覧できます。

---

あらゆるAIアシスタントに、stdio経由でthree.wsのバニティアドレス探索バウンティ市場の読み取り・検索機能を提供するModel Context Protocolサーバーです。Solanaのバニティパターンの探索難易度と必要なエスクロー額を見積もり、任意のアドレスのレア度を評価し、稼働中のバウンティボード、申請可能なキュー、統計、リーダーボード、設定、探索証明ギャラリーを閲覧できます。

この市場では、依頼者がパターンに対するUSDCバウンティをエスクローに預け、独立したワーカー群が並行して探索し、パターンに一致する検証済みキーを最初に提出したワーカーがオンチェーンで報酬を受け取ります。ただし、発見された秘密鍵は依頼者に対して暗号化されるため、ワーカーはウォレットを見ることなく報酬を得られます。バウンティの投稿と申請は、HTTP API上でx402による支払いが必要な書き込み操作です。このMCPが提供するのは、読み取り・検索機能とレア度関連機能です。APIキー、署名者、支払いは不要で、すべての呼び出しは公開 /api/vanity エンドポイントにアクセスします。

インストール

npm install @three-ws/vanity-mcp

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

npx @three-ws/vanity-mcp

クイックスタート

Claude Codeでは、次の1行を実行します。

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

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

{
	"mcpServers": {
		"vanity": {
			"command": "npx",
			"args": ["-y", "@three-ws/vanity-mcp"]
		}
	}
}

MCP Inspectorで機能を確認します。

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

ツール

ツール	種類	機能
vanity_quote	読み取り専用	パターンの価格を見積もります：予想試行回数、レア度ランク、妥当なUSDCバウンティ額を提示します。べき等です。
vanity_appraise	読み取り専用	任意のSolanaアドレスのレア度（パターン、スコア、ビット数、ランク、試行回数）を評価します。べき等です。
vanity_board	読み取り専用	探索バウンティボードを閲覧します。ステータスで絞り込み、更新日時・報酬・期限で並べ替え、ページ分割できます。
vanity_open	読み取り専用	ワーカーがポーリングする、申請可能なオープンバウンティのキューを一覧表示します。
vanity_stats	読み取り専用	市場の最新合計：オープン件数、エスクロー中のUSDC、支払済みUSDC。
vanity_leaderboard	読み取り専用	獲得したUSDCの合計額でランキングした、上位の探索者を表示します。
vanity_config	読み取り専用	支払い可否と、資産・ネットワークのメタデータ（決済資産、小数桁数、ネットワーク、価格帯）を表示します。
vanity_gallery	読み取り専用	探索証明のレア度ギャラリーを閲覧します。並べ替え、ランク・長さ・部分文字列での絞り込み、ページ分割ができます。

vanity_quote と vanity_appraise は入力に対する純粋関数です（同じパターン／アドレスには同じ結果を返す）ので、べき等としてマークされています。残りの6つは、稼働中の市場とギャラリーを読み取ります。

入力パラメーター

vanity_quote — prefix（任意の Base58 プレフィックス）、suffix（任意の Base58 サフィックス）、ignoreCase（ブール値、デフォルトは false）。prefix または suffix のいずれかが必須です。

vanity_appraise — address（必須、Base58 の 32～44 文字）、prefixLen（整数、任意）、suffixLen（整数、任意）。

vanity_board — status（open | all | settled、デフォルトは open）、sort（recency | reward | expiry、デフォルトは recency）、limit（1～100、デフォルトは 24）、offset（デフォルトは 0）。

vanity_open — limit（1～100、デフォルトは 30）。

vanity_stats — パラメーターなし。

vanity_leaderboard — limit（1～100、デフォルトは 10）。

vanity_config — パラメーターなし。

vanity_gallery — sort（score | recency、デフォルトは score）、tier（文字列）、minLength（整数）、contains（文字列）、limit（1～100、デフォルトは 24）、offset（デフォルトは 0）。

例

// vanity_quote
> { "prefix": "THREE" }
{
  "ok": true,
  "pattern": { "prefix": "THREE", "suffix": null, "ignoreCase": false },
  "difficulty": {
    "expectedAttempts": 11308763834,
    "rarityBits": 39,
    "tier": "mythic",
    "tierLabel": "Mythic",
    "accent": "#ff5db1",
    "expectedGrindSeconds": 7539
  },
  "oracle": {
    "floorAtomics": 50000,
    "suggestedAtomics": 2094216,
    "generousAtomics": 5235540,
    "maxAtomics": 5000000000,
    "expectedAttempts": 11308763834,
    "expectedGrindSeconds": 7539,
    "model": "58^effectiveLength @ refRate"
  },
  "band": { "floorAtomics": 50000, "maxAtomics": 5000000000, "decimals": 6, "asset": "USDC" }
}

使用例

実行可能な例は examples/ にあります。

node examples/list-tools.mjs           # every tool with its full input schema
node examples/quote-and-appraise.mjs   # config + quote + appraise + stats, live

どちらもこのサーバーを stdio 経由で起動し、ライブマーケットを読み取ります。ここにあるすべてのツールは読み取り専用のため、投稿、請求、支払いはできません。期待される出力については、examples/README.md を参照してください。

要件

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

環境変数

変数	必須	デフォルト
THREE_WS_BASE	いいえ	https://three.ws
THREE_WS_TIMEOUT_MS	いいえ	20000

リンク

• ホームページ：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}