Сервер @blockchain0x/mcp предоставляет хосту MCP пять инструментов для кошельков агентов: чтение кошелька, список кошельков, проверка транзакции, отправка платежа USDC и расчет счета x402. Запустите его с помощью npx @blockchain0x/mcp (ваш ключ остается на вашем компьютере) или укажите на хостинг URL. Отдельно пакет экспортирует requirePayment, чтобы вы могли установить цену на свои собственные инструменты MCP с помощью вызова x402 402.

Два способа запустить это. Нет установки для размещенного варианта.

Запустите его локально через stdio с помощью npx (ваш ключ остается на вашем компьютере) или укажите любой хост MCP на размещенном Streamable HTTP URL и передайте ключ в качестве токена Bearer. Оба варианта сразу попадают в конфигурацию MCP хоста. Node 20+ для локального пути.

{
  "mcpServers": {
    "blockchain0x": {
      "command": "npx",
      "args": ["-y", "@blockchain0x/mcp"],
      "env": {
        "BLOCKCHAIN0X_API_KEY": "sk_live_...",
        "BLOCKCHAIN0X_API_BASE_URL": "https://api.blockchain0x.com"
      }
    }
  }
}

{
  "mcpServers": {
    "blockchain0x": {
      "url": "https://mcp.blockchain0x.com/mcp",
      "headers": { "Authorization": "Bearer sk_live_..." }
    }
  }
}

BLOCKCHAIN0X_API_KEY - это ключ sk_test_ тестовой сети или sk_live_ основной сети из вашей панели управления; BLOCKCHAIN0X_API_BASE_URL по умолчанию равен https://api.blockchain0x.com. Сервер пересылает ваш ключ на бэкенд и ничего не хранит, поэтому область и лимиты на этот ключ точно соответствуют тому, что может делать агент. Пять инструментов, которые он предоставляет: get_wallet, list_wallets, get_transaction, send_payment и settle_payment_request.

Отметьте вызывающего как оплаченного, когда вебхук поступит.

Когда платеж завершается, Blockchain0x отправляет подписанное событие payment.received на ваш URL вебхука. Проверьте его с помощью webhooks.verify из Node SDK, затем запишите, что вызывающий оплатил в любом хранилище, которое вы уже используете. Нет поставляемого кэша квитанций для настройки - вы владеете этой частью, что означает отсутствие неожиданных инфраструктур.

import express from "express";
import { webhooks } from "@blockchain0x/node";

const app = express();
// Capture the RAW body. The HMAC is over the exact bytes on the wire.
app.use(express.raw({ type: "application/json" }));

app.post("/webhooks/payment", (req, res) => {
  const result = webhooks.verify({
    headers: req.headers,
    rawBody: req.body, // Buffer, raw bytes
    secret: process.env.BLOCKCHAIN0X_WEBHOOK_SECRET!,
  });
  if (!result.ok) return res.status(400).json({ code: result.code });

  if (result.eventType === "payment.received") {
    // Mark this payer paid however you like - a DB row, a Redis key, your call.
    markPaid(result.eventId);
  }
  res.status(200).send("ok");
});

webhooks.verify выполняет HMAC-SHA256 за постоянное время и возвращает дискриминированный союз, поэтому вы разделяете по result.ok без try/catch. Читайте сырое тело, а не разобранную копию, потому что подпись охватывает точные байты. Доставленные события: payment.received, payment.sent, wallet.deployed и webhook.test; платеж на ваш кошелек - это payment.received. Где вы сохраняете 'этот вызывающий оплатил' - строка в базе данных, ключ Redis, карта в памяти для одного процесса - это ваше решение.

Пять ловушек, специфичных для MCP, которых следует избегать.

Эти данные поступают от операторов, работающих с платными серверами MCP в производстве. Большинство из них связано с архитектурой кэша и конкретным форматом ошибок протокола MCP.