Prima di iniziare.

• Un server MCP funzionante che utilizza l'SDK ufficiale Model Context Protocol in Node o Python. Se non ne hai ancora uno, creane uno con il template upstream prima.
• Un account Blockchain0x e un profilo agente (vedi la guida per aggiungere pagamenti all'agente per la configurazione di 5 minuti).
• Una chiave API (usa sk_test_ per questa guida).
• Un piccolo store per ricordare chi ha pagato (una riga di database o una chiave Redis) - il tuo codice possiede questo, aggiornato dal webhook di pagamento.
• Una chiara comprensione di quali strumenti vuoi addebitare e il prezzo per chiamata. Vedi l' voce del glossario degli strumenti MCP a pagamento per i modelli di design.

Limita uno strumento con 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 }));

Il corpo 402 requirePayment restituisce a un chiamante non pagato:

// 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"
}

Distribuisci e verifica.

Spedisci il server. Gli strumenti gratuiti dovrebbero comunque restituire immediatamente il loro risultato; gli strumenti a pagamento dovrebbero restituire il corpo 402 alla prima chiamata da un nuovo cliente, quindi funzionare una volta che quel chiamante è contrassegnato come pagato. Verifica entrambi i percorsi su una chiave sk_test_ contro Base Sepolia prima di andare in produzione.

Due segnali da monitorare il primo giorno: il conteggio dei 402 restituiti (il tuo top-of-funnel) e il conteggio delle esecuzioni degli strumenti riuscite dopo un 402 (la tua conversione). Se la conversione è molto più bassa del previsto, il prezzo è probabilmente errato. Controlla anche il tasso di accesso del tuo store a pagamento - se è vicino a zero, la tua finestra di accesso è troppo corta e i chiamanti paganti vengono invitati a pagare di nuovo.

Una volta che il traffico a pagamento è attivo.

Con la monetizzazione in atto, i seguiti più utili sono la gestione affidabile dei webhook (così non perdi eventi di pagamento), i controlli di spesa (così un server MCP che costruisci che paga anche altri agenti rimane limitato) e un flusso testnet-first (così puoi spedire modifiche ai prezzi senza bruciare denaro reale).

Riferimento completo dell'API su docs.blockchain0x.com. Superficie di prodotto correlata: Integrazione MCP.