Der @blockchain0x/mcp Server bietet einem MCP-Host fünf Agenten-Wallet-Tools: eine Wallet lesen, Wallets auflisten, eine Transaktion überprüfen, eine USDC-Zahlung senden und eine x402-Rechnung begleichen. Führen Sie es mit npx @blockchain0x/mcp aus (Ihr Schlüssel bleibt auf Ihrem Gerät) oder zeigen Sie auf die gehostete URL. Separat exportiert das Paket requirePayment, sodass Sie einen Preis für Ihre eigenen MCP-Tools mit einer x402 402-Herausforderung festlegen können.

Zwei Möglichkeiten, es auszuführen. Keine Installation für die gehostete Version.

Führen Sie es lokal über stdio mit npx aus (Ihr Schlüssel bleibt auf Ihrem Computer), oder richten Sie jeden MCP-Host auf die gehostete Streamable HTTP-URL und übergeben Sie den Schlüssel als Bearer-Token. Beide gehen direkt in die MCP-Konfiguration des Hosts. Node 20+ für den lokalen Pfad.

{
  "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 ist ein sk_test_ Testnet- oder sk_live_ Mainnet-Schlüssel von Ihrem Dashboard; BLOCKCHAIN0X_API_BASE_URL hat standardmäßig https://api.blockchain0x.com. Der Server leitet Ihren Schlüssel an das Backend weiter und speichert nichts, sodass der Umfang und die Obergrenzen dieses Schlüssels genau das sind, was der Agent tun kann. Die fünf Werkzeuge, die es bereitstellt: get_wallet, list_wallets, get_transaction, send_payment und settle_payment_request.

Markieren Sie den Anrufer als bezahlt, wenn der Webhook ankommt.

Wenn eine Zahlung abgeschlossen ist, POSTet Blockchain0x ein signiertes payment.received-Ereignis an Ihre Webhook-URL. Überprüfen Sie es mit webhooks.verify aus dem Node SDK und zeichnen Sie dann auf, dass der Anrufer in welchem Store auch immer, den Sie bereits betreiben, bezahlt hat. Es gibt keinen gelieferten Empfangs-Cache zu konfigurieren - Sie besitzen diesen Teil, was bedeutet, dass es keine Überraschungsinfrastruktur gibt.

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 führt HMAC-SHA256 in konstanter Zeit aus und gibt eine diskriminierte Vereinigung zurück, sodass Sie auf result.ok ohne try/catch verzweigen. Lesen Sie den rohen Body, nicht eine geparste Kopie, da die Signatur die genauen Bytes abdeckt. Die gelieferten Ereignisse sind payment.received, payment.sent, wallet.deployed und webhook.test; eine Zahlung an Ihre Wallet ist payment.received. Wo Sie 'dieser Anrufer hat bezahlt' speichern - eine Datenbankzeile, ein Redis-Schlüssel, eine In-Memory-Karte für einen einzelnen Prozess - liegt bei Ihnen.

Fünf MCP-spezifische Fallen, die zu vermeiden sind.

Diese stammen von Betreibern, die bezahlte MCP-Server in der Produktion betreiben. Die meisten beziehen sich auf die Cache-Architektur und das spezifische Fehlerformat des MCP-Protokolls.