databroker

databroker-mcp-server

MCP 対応エージェント（Claude Desktop、Claude Code、Cursor など）に、MossForge DataBroker への従量課金アクセスを提供します。英国の車両 MOT 情報や、英国全域の信頼性分析を利用できます。Base メインネット上の x402 USDC マイクロペイメントは自動的に処理されます。API キーもサブスクリプションも不要です。ウォレットに資金を入れて、質問するだけです。

ツール

ツール	料金	目的
databroker_discover	無料	有効なデータセット、それぞれの kind、呼び出しごとの USDC 料金を一覧表示します
databroker_fetch	見積もりは無料、確定時に有料	データセットとキーを指定して、単一のデータポイントを取得します
databroker_meta	無料	料金を支払わずに、データポイントの古さ／TTL／ソース情報を確認します
databroker_health	無料	API の稼働状況を確認します
databroker_batch_create	見積もりは無料、確定時に有料	オンデマンドデータセット 1 つから最大 100 個のキーを 1 つのジョブで取得します。支払いは 1 回です
databroker_batch_status	無料	databroker_batch_create で作成したバッチジョブの状態を確認します

支払いが自動的に行われることはありません。 databroker_fetch と databroker_batch_create は必ず先に料金を見積もります。confirm: true を指定してツールを再度呼び出すまで、支払いは発生しません。さらに、すべての有料呼び出しには DATABROKER_MAX_USDC（既定値は 0.50）による上限が適用されます。上限を超える料金の呼び出しは、支払いが行われる前に拒否されます。

対応クライアントでは、支払いの承認は呼び出し元のモデルではなく、サーバーによって強制されます。 支払いの直前に、このサーバーは接続中のクライアントを通じて MCP elicitation リクエストを送信し、人間に正確な請求額の承認または拒否を直接求めます。これは、モデルが渡した confirm の値に左右されません。Claude Code（CLI）は v2.1.76 以降でこれをサポートしています。他のクライアント（Claude Desktop、Cursor など）は、まだサポートしていない可能性があります。

接続中のクライアントが elicitation のサポートを通知しない場合、サーバーはすべての有料呼び出しをブロックするのではなく、elicitation 前の保証にフォールバックします。つまり、呼び出し元のモデルが confirm: true を指定し、さらに DATABROKER_MAX_USDC による上限が適用されます。クライアントが elicitation をサポートしていることが分かっていて、より厳格な保証を希望する場合は、DATABROKER_REQUIRE_ELICITATION=true を設定すると、elicitation をサポートしないクライアントからの有料呼び出しを完全にブロックできます。サーバーは起動時と、elicitation をサポートしないクライアントが初めて接続したときに、現在有効なモードをログに記録します。

セットアップ

1. 新しい EOA ウォレットを作成し、Base メインネット上で数 USDC を入金します（ほかには何も必要ありません。支払側の EIP-3009 送金にはガス代がかからないため、ETH は不要です）。

2. Claude Desktop の設定ファイル（claude_desktop_config.json）に追加します。

{
  "mcpServers": {
    "databroker": {
      "command": "npx",
      "args": ["-y", "@mossforge/databroker-mcp"],
      "env": {
        "DATABROKER_BASE_URL": "https://api.databroker.mossforge.dev",
        "DATABROKER_WALLET_KEY": "0x...",
        "DATABROKER_MAX_USDC": "0.50"
      }
    }
  }
}

claude mcp add --transport stdio \
  --env DATABROKER_BASE_URL=https://api.databroker.mossforge.dev \
  --env DATABROKER_WALLET_KEY=0x... \
  databroker -- npx -y @mossforge/databroker-mcp

4. 次のように質問します。 「この 2018 年式 Golf は買うべきでしょうか？登録番号は AB18 CDE です。MOT の履歴と、走行距離が本当かどうかを確認してください。」

ウォレットの管理者

DATABROKER_SIGNER で設定できる署名プロバイダーを 2 つサポートしています。

• raw（既定）— DATABROKER_WALLET_KEY から読み込む、利用者自身が管理する秘密鍵です。資金を入れたウォレットがあれば、ほかのセットアップは不要です。ただし、鍵の安全性はこのプロセスの環境に依存し、支出上限はこのコードベースだけによって適用されます。
• cdp — Coinbase CDP が管理するウォレットから支払います。秘密鍵がこのプロセスに渡ることはありません。CDP がリモートで署名し、カストディアンのレイヤーで支出ポリシー（セッション上限、許可トークン）を適用できます。CDP アカウントと CDP_API_KEY_ID／CDP_API_KEY_SECRET／CDP_WALLET_SECRET に加えて、npm install @coinbase/cdp-sdk が必要です（任意の依存関係で、既定ではインストールされません）。

セキュリティに関する注意事項

• 専用の、残高の少ないウォレットを使用してください。raw モードでは秘密鍵がマシンの外に出ることはありません。支払いは @x402/* v2 プロトコルスタック（@x402/fetch + @x402/core/client + @x402/evm/exact/client）を通じてローカルで署名され、EIP-3009 transferWithAuthorization ペイロードが生成されます。
• 1 回の呼び出しあたりの上限（DATABROKER_MAX_USDC）は、単一の呼び出しで発生しうる最大損失額です。支払いが送信される前に確認され、上限を超える価格の呼び出しは拒否され、請求されません。それ以外の総エクスポージャーはウォレット残高となるため、残高は少額に保ってください。
• すべての有料呼び出しでは、まず見積もりを取得します。databroker_fetch と databroker_batch_create は、confirm: true を指定して再度呼び出さない限り、支払いを実行しません。
• さらに、接続中のクライアントが MCP elicitation のサポートを通知している場合、支払いには人間による明示的な承認も必要です。サーバー自体が送信するプロンプトで、正確な URL と USDC の金額が示されます。これは呼び出し元のモデルの判断に委ねず、コード（lib.ts の confirmWithHuman）によって強制されます。elicitation をサポートしていないクライアントでは、この追加確認は省略されます（代わりにフェイルクローズにしたい場合は、以下の DATABROKER_REQUIRE_ELICITATION を参照してください）。

環境変数

変数	必須	デフォルト	備考
DATABROKER_BASE_URL	はい	—	例：https://api.databroker.mossforge.dev
DATABROKER_SIGNER	いいえ	raw	raw または cdp。ウォレットを保持するのは誰かを参照
DATABROKER_WALLET_KEY	SIGNER=raw の場合ははい	—	0x で始まる秘密鍵
CDP_API_KEY_ID	SIGNER=cdp の場合ははい	—	Coinbase CDP API キー ID
CDP_API_KEY_SECRET	SIGNER=cdp の場合ははい	—	Coinbase CDP API キーシークレット
CDP_WALLET_SECRET	SIGNER=cdp の場合ははい	—	Coinbase CDP ウォレットシークレット
DATABROKER_MAX_USDC	いいえ	0.50	署名方式にかかわらず適用される、1 回あたりの支出上限
DATABROKER_REQUIRE_ELICITATION	いいえ	false	true の場合、MCP elicitation のサポートを通知しないクライアントでの有料呼び出しをブロックします。confirm: true のみで続行する代わりに、この動作を適用します