De @blockchain0x/mcp server geeft een MCP-host vijf agent-wallettools: lees een wallet, lijst wallets, controleer een transactie, stuur een USDC-betaling en verwerk een x402-factuur. Voer het uit met npx @blockchain0x/mcp (je sleutel blijft op je machine) of wijs naar de gehoste URL. Afzonderlijk exporteert het pakket requirePayment zodat je een prijs kunt stellen op je eigen MCP-tools met een x402 402-uitdaging.

Twee manieren om het uit te voeren. Geen installatie voor de gehoste versie.

Draai het lokaal via stdio met npx (je sleutel blijft op je machine), of wijs een MCP-host aan de gehoste Streamable HTTP-URL en geef de sleutel door als een Bearer-token. Beide worden rechtstreeks in de MCP-configuratie van de host geplaatst. Node 20+ voor het lokale pad.

{
  "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 is een sk_test_ testnet of sk_live_ mainnet sleutel van je dashboard; BLOCKCHAIN0X_API_BASE_URL is standaard ingesteld op https://api.blockchain0x.com. De server stuurt je sleutel door naar de backend en slaat niets op, zodat de scope en limieten op die sleutel precies zijn wat de agent kan doen. De vijf tools die het blootstelt: get_wallet, list_wallets, get_transaction, send_payment en settle_payment_request.

Markeer de beller als betaald wanneer de webhook aankomt.

Wanneer een betaling wordt afgehandeld, POST Blockchain0x een ondertekende payment.received-gebeurtenis naar je webhook-URL. Verifieer het met webhooks.verify van de Node SDK, en registreer dan dat de beller betaald heeft in welke opslag je ook al gebruikt. Er is geen geleverde ontvangstcache om te configureren - jij bezit dat stuk, wat betekent dat er geen verrassende infrastructuur is.

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 doet HMAC-SHA256 in constante tijd en retourneert een gediscrimineerde unie, zodat je takken op result.ok zonder try/catch. Lees het ruwe lichaam, niet een geparsed exemplaar, omdat de handtekening de exacte bytes dekt. De verzonden gebeurtenissen zijn payment.received, payment.sent, wallet.deployed, en webhook.test; een betaling naar je wallet is payment.received. Waar je 'deze beller heeft betaald' vasthoudt - een database rij, een Redis sleutel, een in-memory kaart voor een enkel proces - is jouw keuze.

Vijf MCP-specifieke valkuilen om te vermijden.

Deze komen van operators die betaalde MCP-servers in productie draaien. De meeste hebben betrekking op de cache-architectuur en het specifieke foutformaat van het MCP-protocol.