Trước khi bạn bắt đầu.

• Một máy chủ MCP hoạt động sử dụng SDK Giao thức Ngữ cảnh Mô hình chính thức trong Node hoặc Python. Nếu bạn chưa có, hãy tạo một cái với mẫu upstream trước.
• Một tài khoản Blockchain0x và một hồ sơ đại lý (xem hướng dẫn thêm thanh toán cho đại lý để biết cách thiết lập trong 5 phút).
• Một khóa API (sử dụng sk_test_ cho hướng dẫn này).
• Một cửa hàng nhỏ để nhớ ai đã thanh toán (một hàng cơ sở dữ liệu hoặc một khóa Redis) - mã của bạn sở hữu điều này, được cập nhật bởi webhook thanh toán.
• Có một cảm nhận rõ ràng về các công cụ mà bạn muốn tính phí và giá mỗi lần gọi. Xem mục từ điển công cụ MCP trả phí để biết các mẫu thiết kế.

Bảo vệ một công cụ bằng 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 }));

Thân 402 requirePayment trả về cho người gọi chưa thanh toán:

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

Triển khai và xác thực.

Gửi máy chủ. Các công cụ miễn phí vẫn nên trả về kết quả ngay lập tức; các công cụ có giới hạn nên trả về thân 402 trong cuộc gọi đầu tiên từ một khách hàng mới, sau đó chạy khi người gọi đó được đánh dấu là đã thanh toán. Xác minh cả hai đường dẫn trên khóa sk_test_ với Base Sepolia trước khi đi vào hoạt động.

Hai tín hiệu cần theo dõi vào ngày đầu tiên: số lượng 402s trả về (đầu phễu của bạn) và số lượng chạy công cụ thành công sau một 402 (tỷ lệ chuyển đổi của bạn). Nếu tỷ lệ chuyển đổi thấp hơn nhiều so với mong đợi, giá có thể sai. Cũng theo dõi tỷ lệ truy cập của cửa hàng trạng thái đã trả tiền của bạn - nếu gần bằng không, cửa sổ truy cập của bạn quá ngắn và những người gọi trả tiền đang được yêu cầu trả tiền lại.

Khi lưu lượng thanh toán bắt đầu chảy.

Khi đã có cơ chế kiếm tiền, các bước tiếp theo hữu ích nhất là xử lý webhook đáng tin cậy (để không bỏ lỡ sự kiện thanh toán), kiểm soát chi tiêu (để một MCP server bạn xây dựng mà cũng thanh toán cho các agent khác vẫn nằm trong giới hạn), và quy trình ưu tiên testnet (để bạn có thể triển khai thay đổi giá mà không tốn tiền thật).

Tài liệu API đầy đủ tại docs.blockchain0x.com. Bề mặt sản phẩm liên quan: Tích hợp MCP.