bolthub

@bolthub/mcp

bolthub MCP サーバーです。MCP クライアントの設定に1 つ追加するだけで、1 つのウォレットと Lightning の予算を共有する 3 種類のツールソースを利用できます。

• bolthub マーケットプレイス — 掲載されているすべての API を検索、確認、呼び出せます（search_apis、get_api_details、preview_cost、call_api、buy_credit、mint_scoped_token、revoke_token、および Node Launcher のツール）。
• 自分の API を掲載 — OpenAPI／Postman の仕様から有料のドラフト掲載を作成し、販売者向け基準に照らして監査し、準備ができたら公開して、収益を追跡できます（list_api、analyze_listing、publish_listing、get_earnings、usage_summary）。これらはアカウントに対して実行されるため、トークンが必要です。「bolthub アカウントを接続して」と伝えると（connect_account がワンクリックのブラウザー連携を実行します。チャットに秘密情報が渡ることはありません）、または自分で BOLTHUB_ACCOUNT_TOKEN を設定してください。購入にアカウントは不要です。明示的に公開するまで、ドラフトは表示されません。
• 特定の L402 ゲートウェイ — ゲートウェイの OpenAPI エンドポイントが、それぞれの名前を持つツールとして直接利用できます。
• その他の MCP サーバー — ローカルまたはリモートのサーバーを透過的にプロキシします。無料のツールはそのまま通過し、L402 の支払いチャレンジを返すツールは予算内で支払いを済ませてから再試行します。

@bolthub/mcp-registry と @bolthub/mcp-bridge を置き換えます（どちらも非推奨です。移行方法は以下を参照してください）。

ソース：signaltech-org/bolthub-sdk · ドキュメント：docs.bolthub.ai

クイックスタート

MCP クライアントの設定に追加してください（Cursor、Claude Desktop、OpenClaw など）。

{
  "mcpServers": {
    "bolthub": {
      "command": "npx",
      "args": ["-y", "@bolthub/mcp"],
      "env": { "NWC_URI": "<your-nwc-connection-string>" }
    }
  }
}

設定ファイルがない場合はマーケットプレイスモードで実行され、掲載されているすべての bolthub API をメタツール経由でエージェントが利用できます。新しい掲載は自動的に表示されるため、設定を変更する必要はありません。

完全なセットアップ：設定ファイルを 1 つ用意

~/.bolthub/mcp.json — mcpServers ブロックは、MCP クライアントですでに使用しているものとまったく同じ形式なので、既存のエントリをそのまま貼り付けてください。

{
  "marketplace": true,
  "gateways": ["https://btc-intel.gw.bolthub.ai"],
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/me/notes"]
    },
    "remote-tools": {
      "url": "https://tools.example.com/mcp",
      "headers": { "Authorization": "Bearer …" }
    }
  },
  "budget":     { "sat": 10000 },   // lifetime ceiling for this run, ALL sources combined
  "maxPerCall": { "sat": 500 },     // per-call ceiling
  "namespace":  "prefix",           // "prefix" (default) or "flat"
  "telemetry":  false               // reserved; v1 sends nothing anywhere
}

次に、クライアントからこのファイルを指定します。

{
  "mcpServers": {
    "bolthub": {
      "command": "npx",
      "args": ["-y", "@bolthub/mcp", "--config", "~/.bolthub/mcp.json"],
      "env": { "LND_REST_HOST": "…", "LND_MACAROON": "…" }
    }
  }
}

エージェントに表示される内容

• プレフィックスなしのマーケットプレイスメタツール：search_apis、get_api_details、preview_cost、call_api、buy_credit、mint_scoped_token、revoke_token、deploy_node、node_status、list_api、analyze_listing、publish_listing、get_earnings、usage_summary、connect_account、connect_status、create_workspace、connect_wallet、get_onboarding_state、およびライブ SSE フィード用の open_stream／read_stream／close_stream。
• ウォレットを設定している場合は wallet_status：SPENDING ウォレット（残高、権限、接続状態）を確認できます。これは支払う側における node_status に相当し、支払いに失敗したときに最初に実行するツールです。
• ゲートウェイのエンドポイント：ゲートウェイのスラッグをプレフィックスとして付与します（btc-intel__get_v1_history_candles など）。
• 下流の MCP ツール：設定キーをプレフィックスとして付与します（filesystem__read_file など）。

2 つのサーバーがどちらも search ツールを公開していても、プレフィックスによって区別できます。namespace: "flat" を指定すると、プレフィックスなしの名前をそのまま使いますが、名前が衝突すると起動時に失敗します（ツールが黙って隠されることはありません）。

ウォレット（任意）

サーバーの env で、次のいずれか 1 つを設定してください。

LND_REST_HOST + LND_MACAROON         (recommended, fastest <200ms)
NWC_URI                              (easiest setup, slower 1-3s)
LNBITS_URL + LNBITS_ADMIN_KEY        (alternative, <300ms)
PHOENIXD_URL + PHOENIXD_PASSWORD     (alternative, <200ms)

ウォレットがなくてもエラーにはなりません。無料のツールとマーケットプレイスの検索は引き続き動作し、有料の呼び出しでは、セットアップ方法のヒントとともに支払いチャレンジが返されます。

1 つの予算による確実な上限

budget.sat は、サーバーが存続する間にゲートウェイの呼び出し、call_api、有料の下流 MCP ツールを合算して使用できる上限額です。予約は同期的に行われるため、異なるソースへの同時呼び出しによって合計額が上限を超えることはありません。budget.sat: 0 も有効で、「無料のツールのみ」を意味します。エージェントが上限を引き上げることはできません。支払いが拒否された場合は、明確な「Payment refused」結果が返されます。

支払いのたびに、1 行が stderr に記録されます（ローカルの監査記録です）。telemetry フラグは予約済みです。v1 では有効・無効にかかわらず、どこにもデータを送信しません。将来のバージョンでオプトイン方式のデータ受け入れ機能を追加する場合も、送信するのは { scheme, asset, amount } のみで、ツールの引数やリソースの識別情報は含まれません。

@bolthub/mcp-registry / @bolthub/mcp-bridge からの移行

移行前	移行後
npx @bolthub/mcp-registry	npx @bolthub/mcp（設定不要で同じ動作）
npx @bolthub/mcp-registry --api-url <url>	npx @bolthub/mcp --api-url <url>
npx @bolthub/mcp-bridge --gateway <url>	npx @bolthub/mcp --gateway <url>
--budget / BUDGET_SATS	変更なし（すべてのソースで単一のプールを共有するようになりました）
ゲートウェイツール btc-intel_get_v1_x	btc-intel__get_v1_x（アンダースコア2つの名前空間）

この設定と並べて追加するのではなく、クライアント設定から古いエントリを削除してください。mcpServers 内にネストされた bolthub の bin は、独自のウォレット環境変数から支払い、共有予算には反映されません（サーバーは起動時にこれを検出すると警告します）。

注意事項と制限（v1）

• MCP のツールのみをプロキシします。リソース、プロンプト、サンプリングのパススルーにはまだ対応していません。
• ダウンストリームのツール一覧は起動時にスナップショットされます。追加・削除を反映するには再起動が必要です。
• 起動に失敗したダウンストリームは stderr に警告を出してスキップされ、残りは引き続きサービスを提供します。
• すべてのログは stderr に出力され、stdout には出力されません（stdout は MCP チャネルです）。

ライセンス

MIT