Voordat je begint.

• Een werkende MCP-server die de officiële Model Context Protocol SDK in Node of Python gebruikt. Als je er nog geen hebt, scaffold er dan eerst een met de upstream-sjabloon.
• Een Blockchain0x-account en een agentprofiel (zie de add-payments-to-agent guide voor de 5-minuten setup).
• Een API-sleutel (gebruik sk_test_ voor deze gids).
• Een kleine opslag om te onthouden wie heeft betaald (een database rij of een Redis sleutel) - jouw code bezit dit, bijgewerkt door de betalingswebhook.
• Een duidelijk gevoel van welke tools u wilt laten betalen en de prijs per oproep. Zie de betaalde MCP-toolglossaire-invoer voor ontwerppatronen.

Beperk een tool met requirePayment.

Inside the tool, check your own paid-state for the caller. If they have not paid, call requirePayment and return the resulting 402 body; if they have, run the work. requirePayment is a pure builder - it does not wrap the handler and does not track payment, so the gating policy stays in your code.

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { requirePayment } from "@blockchain0x/mcp";
import { z } from "zod";

const server = new McpServer({ name: "premium-data-mcp", version: "1.0.0" });

server.tool(
  "get_quote_realtime",
  "Real-time quote (paid)",
  { ticker: z.string() },
  async ({ ticker }, extra) => {
    if (!hasPaid(extra)) {
      // Pure function: mint an x402 402 challenge and hand the body back.
      const { body } = requirePayment({
        amountUsdc: "0.005",
        payTo: "0xYourWallet",
        hostedUrl: "https://pay.blockchain0x.com/checkout/abc",
      });
      return { content: [{ type: "text", text: JSON.stringify(body) }], isError: true };
    }
    const quote = await fetchLiveQuote(ticker);
    return { content: [{ type: "text", text: JSON.stringify(quote) }] };
  },
);

import express from "express";
import { createX402Middleware } from "@blockchain0x/x402/server/express";
import { createClient } from "@blockchain0x/node";

const sdk = createClient({ apiKey: process.env.BLOCKCHAIN0X_API_KEY! });
const app = express();

// Not an MCP server? Gate a plain HTTP route the same way. The middleware
// answers unpaid requests with a 402 and lets paid ones through.
// Configure the price and recipient per the x402 docs.
app.use("/quote", createX402Middleware({ sdk }));

Het 402-lichaam requirePayment retourneert naar een niet-betaalde oproeper:

// requirePayment returns { status: 402, body }. The body an unpaid caller sees:
{
  "error": "payment_required",
  "amountUsdc": "0.005",
  "payTo": "0xYourWallet",
  "hostedUrl": "https://pay.blockchain0x.com/checkout/abc",
  "network": "mainnet"
}

Implementeren en verifiëren.

Verzend de server. Gratis tools moeten nog steeds onmiddellijk hun resultaat teruggeven; afgeschermde tools moeten het 402-lichaam retourneren bij de eerste oproep van een nieuwe klant, en vervolgens draaien zodra die oproeper als betaald is gemarkeerd. Verifieer beide paden op een sk_test_ sleutel tegen Base Sepolia voordat je live gaat.

Twee signalen om op de eerste dag op te letten: het aantal 402's dat is teruggegeven (je top-of-funnel) en het aantal succesvolle toolruns na een 402 (je conversie). Als de conversie veel lager is dan verwacht, is de prijs waarschijnlijk verkeerd. Let ook op de hitrate van je betaalde-statusopslag - als deze dicht bij nul is, is je toegangvenster te kort en worden betalende oproepers gevraagd om opnieuw te betalen.

Zodra betaalde verkeer stroomt.

Met monetisatie op zijn plaats, zijn de meest nuttige vervolgacties betrouwbare webhook-afhandeling (zodat je geen betalingsgebeurtenissen mist), uitgavencontroles (zodat een MCP-server die je bouwt die ook andere agents betaalt binnen de grenzen blijft), en een testnet-eerst flow (zodat je prijswijzigingen kunt verzenden zonder echt geld te verbranden).

Volledige API-referentie op docs.blockchain0x.com. Gerelateerde productoppervlak: MCP-integratie.