Перед тем как начать.

• Работающий сервер MCP, использующий официальный Протокол контекста модели SDK на Node или Python. Если у вас его еще нет, сначала создайте его с помощью шаблона upstream.
• Учетная запись Blockchain0x и профиль агента (см. добавить-платежи-к-агенту для настройки за 5 минут).
• Ключ API (используйте sk_test_ для этого руководства).
• Небольшой магазин для запоминания, кто оплатил (строка базы данных или ключ Redis) - ваш код владеет этим, обновляется вебхуком платежа.
• Ясное понимание того, за какие инструменты вы хотите взимать плату и цена за вызов. Смотрите глоссарий платных инструментов MCP для шаблонов дизайна.

Ограничьте инструмент с помощью 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 }));

Тело 402 requirePayment возвращается неплательщику:

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

Разверните и проверьте.

Отгрузите сервер. Бесплатные инструменты должны по-прежнему немедленно возвращать свои результаты; ограниченные инструменты должны возвращать тело 402 при первом вызове от нового клиента, а затем работать, как только этот клиент будет отмечен как оплаченный. Проверьте оба пути с помощью ключа sk_test_ на Base Sepolia перед запуском в живую.

Два сигнала, на которые стоит обратить внимание в первый день: количество возвращенных 402 (ваш верхний уровень воронки) и количество успешных запусков инструмента после 402 (ваша конверсия). Если конверсия значительно ниже ожидаемой, цена, вероятно, неверна. Также следите за коэффициентом попаданий вашего хранилища платного состояния - если он близок к нулю, ваше окно доступа слишком короткое, и платящие вызывающие снова просят заплатить.

Как только оплаченный трафик начнет поступать.

С внедрением монетизации наиболее полезные последующие действия - это надежная обработка вебхуков (чтобы вы не пропустили события платежей), контроль расходов (чтобы сервер MCP, который вы строите и который также оплачивает других агентов, оставался ограниченным) и поток с приоритетом тестовой сети (чтобы вы могли вносить изменения в ценообразование без потери реальных денег).

Полная справка по API на docs.blockchain0x.com. Связанная продуктовая поверхность: интеграция MCP.