Solana Alpha x402

solana-alpha-x402-mcp

Solana Alpha API（x402 v2、Solana メインネット上の USDC）用の stdio MCP サーバーです。

有料の HTTP エンドポイントごとに 1 つのツールを用意し、無料の list_pricing ツールも備えています。各ツールは https://solana-x402-data.netlify.app のライブ API を呼び出します（API_BASE_URL で変更できます）。

ツール	エンドポイント	価格
list_pricing	—	無料
get_price	/api/price	0.005 USDC
get_news	/api/news	0.005 USDC
get_new	/api/new	0.005 USDC
get_trending	/api/trending	0.01 USDC
get_perps	/api/perps	0.01 USDC
get_rugcheck	/api/rugcheck	0.01 USDC
get_wallet	/api/wallet	0.02 USDC
get_token_report	/api/token-report	0.08 USDC

PayTo（絶対に変更しないでください）： 3WN7T7VMnRJzjRhKosbaT2oiwuMiBCe6KBfZGiZygv7n

動作

• SOLANA_PRIVATE_KEY がない場合： ツールは引き続きライブ API を呼び出します。402 は読みやすい JSON 結果（price、payTo、network、asset、feePayer）として返され、致命的なエラーにはなりません。そのため、エージェントは支払い要件を確認できます。
• SOLANA_PRIVATE_KEY がある場合： @x402/fetch と @x402/svm（ExactSvmScheme）を使用して署名し、USDC の支払いを自動的に決済します。オプションの MAX_PRICE_USDC を設定すると、上限を超える呼び出しを拒否します。
• このパッケージはスタンドアロンの Node MCP サーバーです。HTTPS 経由でライブ Solana Alpha API と通信し、Netlify Functions は内包しません。

インストール（ローカル／このリポジトリから）

npm install
npm run smoke          # initialize + tools/list + get_price → 402 info (no key, no payment)

公開時の npm パッケージ名：solana-alpha-x402-mcp
公開されるまでは、MCP ホストでローカルのエントリーポイントを指定してください：node /absolute/path/to/solana-alpha-x402-mcp/src/index.mjs

環境変数

変数	必須	意味
SOLANA_PRIVATE_KEY	いいえ	購入者の秘密鍵：base58（Phantom／Solana CLI のエクスポート形式）または JSON バイト配列 […]。絶対にコミットしないでください。
MAX_PRICE_USDC	いいえ	呼び出しごとの上限（例：0.02）。表示価格が上限を超える場合 → エラーとなり、支払いは発生しません。
API_BASE_URL	いいえ	デフォルトは https://solana-x402-data.netlify.app です。

Claude Desktop（claude_desktop_config.json）

{
  "mcpServers": {
    "solana-alpha-x402": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/solana-alpha-x402-mcp/src/index.mjs"],
      "env": {
        "API_BASE_URL": "https://solana-x402-data.netlify.app"
      }
    }
  }
}

自動支払いを有効にする場合（資金を入れた使い捨てウォレットのみ使用してください）：

{
  "mcpServers": {
    "solana-alpha-x402": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/solana-alpha-x402-mcp/src/index.mjs"],
      "env": {
        "SOLANA_PRIVATE_KEY": "YOUR_BASE58_SECRET",
        "MAX_PRICE_USDC": "0.08",
        "API_BASE_URL": "https://solana-x402-data.netlify.app"
      }
    }
  }
}

このパッケージの npm publish 後は、次を使用できます：

{
  "mcpServers": {
    "solana-alpha-x402": {
      "command": "npx",
      "args": ["-y", "solana-alpha-x402-mcp"],
      "env": {
        "MAX_PRICE_USDC": "0.08"
      }
    }
  }
}

Cursor（mcp.json）

プロジェクトまたはユーザーの MCP 設定：

{
  "mcpServers": {
    "solana-alpha-x402": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/solana-alpha-x402-mcp/src/index.mjs"],
      "env": {
        "API_BASE_URL": "https://solana-x402-data.netlify.app"
      }
    }
  }
}

または、公開後は npx 経由で使用できます：

{
  "mcpServers": {
    "solana-alpha-x402": {
      "command": "npx",
      "args": ["-y", "solana-alpha-x402-mcp"]
    }
  }
}

ディスカバリー（HTTP、無料）

ライブ API ホストで公開されているディスカバリー用ドキュメント：

• /.well-known/mcp.json — サーバーカード／インストールコマンド
• /tools.json — Claude／OpenAI 形式の関数スキーマ（価格を含む）
• /.well-known/agent.json
• /openapi.json
• /llms.txt

安全性

• 実際に資金が入った鍵を git、スクリーンショット、チャットログに含めないでください。
• スモークテストでは意図的に SOLANA_PRIVATE_KEY の設定を解除し、支払いが決済されることはありません。
• PayTo は API と一致するようハードコードされた受け取り専用の公開アドレスです。変更すると、ライブサービスとの決済ができなくなります。