あなたはMCPサーバーを構築しました。何千人ものクライアントがそれを無料で使用しています。

あなたはClaude Desktop、Cursor、およびClineクライアントがその機能を必要としていたため、MCPサーバーを出荷しました。噂が広まりました。あなたは今、会ったことのないAIエージェントから1日あたり数千の有料ツールの呼び出しを提供しています。あなたの出口請求は現実です。基盤となるサービスのAPIキーは現実です。あなたのメンテナンスタイムは現実です。収益はゼロです。

あなたには3つの選択肢があります。無料のままにしてインフラにお金を燃やすか、手動のAPIキーの背後にゲートを設けるか（サインアップフォームの摩擦でエージェントトラフィックの95％を失います）。または、AIエージェントが実際に完了できる支払いレイヤーを追加します - これはまさに402 Payment Required + USDCが構築された目的です。

Blockchain0xはオプション3です。あなたのMCPサーバーは私たちのAPIを指しています。AIクライアントが有料ツールを呼び出すと、応答はホストされた支払いURLを持つ402です。クライアント（またはその人間の監督者）はUSDCで支払います。あなたのWebhookが発火します。そのクライアントからの次の呼び出しは成功します。全体の形はx402と呼ばれ、これはCoinbaseがこの正確なパターンのために公開したプロトコルです。

完全な動作例。

requirePaymentは@blockchain0x/mcpから402チャレンジを構築し、webhooks.verifyは@blockchain0x/nodeから確認を検証します。あなたはその間の2つの小さな部分を所有しています：ツール内の有料状態チェックと、支払者を支払い済みとしてマークするWebhookハンドラーです。以下は、1つの有料ツールとそのWebhookエンドポイントを公開する完全なMCPサーバーです。

import express from "express";
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { requirePayment } from "@blockchain0x/mcp";
import { webhooks } from "@blockchain0x/node";

const server = new McpServer({ name: "docs-search", version: "1.0.0" });

// You decide who counts as paid. Back this with Redis/Postgres in production.
const paid = new Set<string>();

server.tool(
  "search_docs",
  "Semantic search across our docs",
  { query: { type: "string" }, payer: { type: "string" } },
  async ({ query, payer }) => {
    if (!paid.has(`search_docs:${payer}`)) {
      // Not paid yet: build an x402-compatible 402 challenge and return its
      // body as a tool error. requirePayment is a challenge builder - it does
      // not gate the call for you; this check is yours.
      const { body } = requirePayment({
        amountUsdc: "0.02",
        payTo: "0xYourMcpAgentAddress",
        hostedUrl: "https://pay.blockchain0x.com/checkout/docs-search",
        description: "docs search",
      });
      return { content: [{ type: "text", text: JSON.stringify(body) }], isError: true };
    }
    const results = await runVectorSearch(query);
    return { content: [{ type: "text", text: JSON.stringify(results) }] };
  },
);

// Your webhook endpoint marks a payer as paid once the checkout settles.
const app = express();
app.post("/webhooks/blockchain0x", express.raw({ type: "*/*" }), (req, res) => {
  const r = webhooks.verify({ headers: req.headers, rawBody: req.body, secret: process.env.BLOCKCHAIN0X_WEBHOOK_SECRET! });
  if (!r.ok) return res.status(400).json({ code: r.code });
  if (r.eventType === "payment.received") {
    // Resolve (tool, payer) from the reference you encoded in hostedUrl, then:
    paid.add("search_docs:0xPayer");
  }
  res.json({ received: true });
});

セットアップ手順

1. 1Blockchain0xエージェントウォレットを作成する あなたのMCPサーバー用に、APIおよびWebhookアクセスを含むプランで。payToとして使用するウォレットアドレスをメモしてください。
2. 2パッケージをインストールする： npm install @blockchain0x/mcp @blockchain0x/node
3. 3環境変数を設定してください: BLOCKCHAIN0X_API_KEY (MCP server が Authorization: Bearer として送信します) と BLOCKCHAIN0X_WEBHOOK_SECRET (dashboard の署名用シークレットで、webhooks.verify が照合します)。
4. 4有料ツールをゲートする 自分の支払い状態を確認し、呼び出し元が支払っていない場合はrequirePaymentチャレンジボディを返します。無料ツールはゲートしないでください。
5. 5Webhookエンドポイントを設定する Blockchain0xダッシュボードで（例：/webhooks/blockchain0x）、次にwebhooks.verifyで各配信を確認し、payment.receivedで支払者を支払い済みとしてマークします。
6. 6デプロイ。 あなたの有料ツールに最初にアクセスしたAIクライアントは402を受け取り、支払い、次の呼び出しが成功します。支払いは10秒以内にダッシュボードに表示されます。

あなたはまた、npx @blockchain0x/mcp（stdio）またはmcp.blockchain0x.comのホストされたストリーミングHTTPコンテナでBlockchain0x MCPサーバーを実行できます。Webhookペイロードの形状を含む完全なセットアップは、ドキュメントにあります。

多くのオペレーターはパターンを混ぜます：呼び出しごとのマイクロ価格で安価なツール、呼び出しごとの高価格で高価なツール、さらに重いユーザーのための24時間のサブスクリプションウィンドウ。すべてのツールを同じMCPサーバーで実行することを妨げるものはありません。各ツールはrequirePayment内の独自のamountUsdcを設定し、ハンドラー内の独自の支払いウィンドウを設定します。