Il server @blockchain0x/mcp fornisce a un host MCP cinque strumenti per wallet di agenti: leggi un wallet, elenca i wallet, controlla una transazione, invia un pagamento USDC e regola una fattura x402. Eseguilo con npx @blockchain0x/mcp (la tua chiave rimane sul tuo computer) o punta all'URL ospitato. Separatamente, il pacchetto esporta requirePayment così puoi mettere un prezzo sui tuoi strumenti MCP con una sfida x402 402.

Due modi per eseguirlo. Nessuna installazione per quello ospitato.

Esegui localmente tramite stdio con npx (la tua chiave rimane sulla tua macchina), oppure punta qualsiasi host MCP all'URL HTTP Streamable ospitato e passa la chiave come token Bearer. Entrambi vanno direttamente nella configurazione MCP dell'host. Node 20+ per il percorso locale.

{
  "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 è una chiave sk_test_ testnet o sk_live_ mainnet dal tuo dashboard; BLOCKCHAIN0X_API_BASE_URL predefinito è https://api.blockchain0x.com. Il server inoltra la tua chiave al backend e non memorizza nulla, quindi l'ambito e i limiti su quella chiave sono esattamente ciò che l'agente può fare. I cinque strumenti che espone: get_wallet, list_wallets, get_transaction, send_payment e settle_payment_request.

Segna il chiamante come pagato quando il webhook arriva.

Quando un pagamento si stabilisce, Blockchain0x POSTa un evento firmato payment.received al tuo URL webhook. Verificalo con webhooks.verify dal Node SDK, poi registra che il chiamante ha pagato in qualsiasi store tu stia già utilizzando. Non c'è una cache di ricevute inclusa da configurare - possiedi quella parte, il che significa nessuna infrastruttura a 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 esegue HMAC-SHA256 in tempo costante e restituisce un'unione discriminata, quindi ramifichi su result.ok senza try/catch. Leggi il corpo grezzo, non una copia analizzata, perché la firma copre i byte esatti. Gli eventi inviati sono payment.received, payment.sent, wallet.deployed e webhook.test; un pagamento al tuo portafoglio è payment.received. Dove persisti 'questo chiamante ha pagato' - una riga nel tuo database, una chiave in Redis, una mappa in memoria per un singolo processo - è una tua scelta.

Cinque trappole specifiche di MCP da evitare.

Questi provengono da operatori che gestiscono server MCP a pagamento in produzione. La maggior parte riguarda l'architettura della cache e il formato di errore specifico del protocollo MCP.