Antes de você começar.

• Um servidor MCP funcional usando o SDK oficial Model Context Protocol em Node ou Python. Se você ainda não tiver um, crie um com o template upstream primeiro.
• Uma conta Blockchain0x e um perfil de agente (veja o guia de adicionar pagamentos ao agente para a configuração de 5 minutos).
• Uma chave de API (use sk_test_ para este guia).
• Uma pequena loja para lembrar quem pagou (uma linha de banco de dados ou uma chave Redis) - seu código possui isso, atualizado pelo webhook de pagamento.
• Uma noção clara de quais ferramentas você deseja cobrar e o preço por chamada. Veja a entrada do glossário de ferramentas MCP pagas para padrões de design.

Bloqueie uma ferramenta com 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 }));

O corpo 402 requirePayment retorna para um chamador não pago:

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

Implante e verifique.

Envie o servidor. Ferramentas gratuitas ainda devem retornar seu resultado imediatamente; ferramentas restritas devem retornar o corpo 402 na primeira chamada de um cliente novo, depois executar uma vez que esse chamador é marcado como pago. Verifique ambos os caminhos em uma chave sk_test_ contra a Base Sepolia antes de ir ao vivo.

Dois sinais para observar no primeiro dia: a contagem de 402s retornados (seu topo de funil) e a contagem de execuções bem-sucedidas de ferramentas após um 402 (sua conversão). Se a conversão for muito menor do que o esperado, o preço provavelmente está errado. Observe também a taxa de acertos do seu armazenamento de estado pago - se estiver perto de zero, sua janela de acesso é muito curta e os chamadores pagantes estão sendo solicitados a pagar novamente.

Uma vez que o tráfego pago esteja fluindo.

Com a monetização em vigor, os seguimentos mais úteis são a manipulação confiável de webhook (para que você não perca eventos de pagamento), controles de gastos (para que um servidor MCP que você constrói que também paga outros agentes permaneça limitado) e um fluxo primeiro para testnet (para que você possa enviar mudanças de preços sem queimar dinheiro real).

Referência completa da API em docs.blockchain0x.com. Superfície de produto relacionada: Integração MCP.