btcmatic-mcp-server

BTCMatic agent API 用のMCPサーバー。コール単位課金のBitcoin市場情報を自律エージェントのもとへ届けます — 自己保有セキュリティレーダー、手数料のパーセンタイル、価格変動ウインドウ、条件発生頻度 — 支払いはLightning上のsで行われます。アカウントもAPIキーもクレジットカードも不要です。インターネットは 402 と入金を含んだ状態で支払いを求めてきて、エージェントのウォレットが支払い、プリイメージが揃ったところでツール呼び出しが完了します。

BTCMaticはBitcoinのイベントエンジンです。このパッケージは、エージェントがその世界に入るための入口です。ここにあるものはすべて読み取り専用コンテキストであり、ルールの作成、注文の実行、他への通知、資金への接触は一切できません。

ツール

有料のツール呼び出しは1回につき約210 s（最新の料金は btcmatic_discover に表示されます）。

Related MCP server: x402-api

支払いの仕組み

1. 証明なしで有料ツールを呼びます。結果は、エラーではなくデータとしての402オファーです。
   { kind: "offer", price_sats, bolt11, payment_hash, next_step }

2. あなたのウォレットが bolt11 を支払い、プリイメージを表示します。

3. 同じツールを { payment_hash, preimage } 付きで再呼び出します。この証明は一度だけです。

プリペイド：btcmatic_topup → 支払 → btcmatic_topup_claim → トークン。サーバーを BTCMATIC_AGTT_TOKEN=agt_… 付きで起動すると、有料ツールの呼び出しごとにバランスから引落しされます。バランスがゼロになると、ツールは { kind: "topup_needed" } を返します。

このサーバーは鍵を決し保持せす、支払うこともあありません。証明を移動させるだけで、支払うかど姃かは常にあ孄のウォレット自【が決定します。証明の形シーは Authorization: L402 <payment_hash>:<preimage> です。ペイメントハッシュが CMatic が発行したインボイスを指し、 sha256(preimage) = payment_hash が証明になるため、マカロンは必要あません。

インストール

{
	"mcpServers": {
		"btcmatic": {
			"command": "npx",
			"args": ["-y", "btcmatic-mcp-server"],
			"env": { "BTCMATIC_AGENT_TOKEN": "agt_…" }
		}
	}
}

BTCMATIC_AGENT_TOKEN は任意です（これがなくても、都度の402フローで支払います）日本語 BTCMATIC_API_URL でAPIベースURLを変更できます（既定: https://api.btcmatic.com）。

数値の意味 — 数値でないもの

• ソースごとの精度は、BTCMaticが手動で設定し、btcmatic.com/radar に公開しているラベルから得られます。ラベルがないソースには、精度の表示は一切ありません。

• 手数料パーセンタイル、変動ウィンドウ、発生頻度は、過去の公開データに基づく記述統計です。これらは過去を説明するだけで、予測を行ったり、売買を推奨したりするものではありません。

• 有料のレスポンスには必ず meta ブロックが含まれ、支払金額、残高、免責事項、サインアップURLが載ります。同じデータはBTCMaticアカウントでも無料で得られます。このAPIが存在するのは、アカウントを持てないクライアントのためです。

開発

pnpm install
pnpm build && pnpm test && pnpm lint
BTCMATIC_API_URL=http://localhost:3000 node dist/cli.js   # stdio transport

リソース

• Agent API ドキュメント: https://btcmatic.com/integrations/agents

• OpenAPI（タグ httpt）: https://api.btcmatic.com/docs

• BTCMatic for automations（APIキー、n8n）: https://btcmatic.com/integrations/n8n

ライセンス

MIT