Le serveur @blockchain0x/mcp fournit à un hôte MCP cinq outils de portefeuille d'agent : lire un portefeuille, lister les portefeuilles, vérifier une transaction, envoyer un paiement USDC et régler une facture x402. Exécutez-le avec npx @blockchain0x/mcp (votre clé reste sur votre machine) ou pointez vers l'URL hébergée. Séparément, le paquet exporte requirePayment afin que vous puissiez mettre un prix sur vos propres outils MCP avec un défi x402 402.

Deux façons de l'exécuter. Pas d'installation pour celui hébergé.

Exécutez-le localement via stdio avec npx (votre clé reste sur votre machine), ou pointez n'importe quel hôte MCP vers l'URL HTTP Streamable hébergée et passez la clé en tant que token Bearer. Les deux s'intègrent directement dans la configuration MCP de l'hôte. Node 20+ pour le chemin 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 est une clé sk_test_ testnet ou sk_live_ mainnet de votre tableau de bord ; BLOCKCHAIN0X_API_BASE_URL par défaut est https://api.blockchain0x.com. Le serveur transmet votre clé au backend et ne stocke rien, donc la portée et les plafonds de cette clé sont exactement ce que l'agent peut faire. Les cinq outils qu'il expose : get_wallet, list_wallets, get_transaction, send_payment, et settle_payment_request.

Marquez l'appelant comme payé lorsque le webhook arrive.

Lorsque qu'un paiement est réglé, Blockchain0x envoie un événement signé payment.received à votre URL de webhook. Vérifiez-le avec webhooks.verify du SDK Node, puis enregistrez que l'appelant a payé dans le magasin que vous utilisez déjà. Il n'y a pas de cache de reçu expédié à configurer - vous possédez cette partie, ce qui signifie pas d'infrastructure surprise.

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 effectue HMAC-SHA256 en temps constant et renvoie une union discriminée, donc vous branchez sur result.ok sans try/catch. Lisez le corps brut, pas une copie analysée, car la signature couvre les octets exacts. Les événements expédiés sont payment.received, payment.sent, wallet.deployed, et webhook.test ; un paiement vers votre portefeuille est payment.received. Où vous persistez 'cet appelant a payé' - une ligne de base de données, une clé Redis, une carte en mémoire pour un seul processus - est votre choix.

Cinq pièges spécifiques à MCP à éviter.

Celles-ci proviennent d'opérateurs exécutant des serveurs MCP payants en production. La plupart concernent l'architecture de cache et le format d'erreur spécifique du protocole MCP.