El servidor @blockchain0x/mcp proporciona a un anfitrión MCP cinco herramientas de billetera de agente: leer una billetera, listar billeteras, verificar una transacción, enviar un pago USDC y liquidar una factura x402. Ejecútalo con npx @blockchain0x/mcp (tu clave permanece en tu máquina) o apunta a la URL alojada. Por separado, el paquete exporta requirePayment para que puedas poner un precio en tus propias herramientas MCP con un desafío x402 402.

Dos formas de ejecutarlo. Sin instalación para el alojado.

Ejecutalo localmente a través de stdio con npx (tu clave permanece en tu máquina), o apunta cualquier host MCP a la URL HTTP Streamable alojada y pasa la clave como un token Bearer. Ambos se integran directamente en la configuración MCP del host. Node 20+ para la ruta local.

{
  "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 es una clave sk_test_ testnet o sk_live_ mainnet de tu panel; BLOCKCHAIN0X_API_BASE_URL predetermina a https://api.blockchain0x.com. El servidor reenvía tu clave al backend y no almacena nada, por lo que el alcance y los límites de esa clave son exactamente lo que el agente puede hacer. Las cinco herramientas que expone: get_wallet, list_wallets, get_transaction, send_payment y settle_payment_request.

Marca al llamador como pagado cuando el webhook llegue.

Cuando un pago se liquida, Blockchain0x envía un evento firmado payment.received a tu URL de webhook. Verifícalo con webhooks.verify del SDK de Node, luego registra que el llamador pagó en cualquier tienda que ya tengas. No hay caché de recibos enviado para configurar - tú posees esa parte, lo que significa que no hay infraestructura sorpresa.

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 realiza HMAC-SHA256 en tiempo constante y devuelve una unión discriminada, por lo que usted se ramifica en result.ok sin try/catch. Lea el cuerpo sin procesar, no una copia analizada, porque la firma cubre los bytes exactos. Los eventos enviados son payment.received, payment.sent, wallet.deployed y webhook.test; un pago a su billetera es payment.received. Donde persista 'este llamador pagó' - una fila de base de datos, una clave de Redis, un mapa en memoria para un solo proceso - es su decisión.

Cinco trampas específicas de MCP a evitar.

Estos provienen de operadores que ejecutan servidores MCP pagos en producción. La mayoría se relacionan con la arquitectura de caché y el formato de error específico del protocolo MCP.