O servidor @blockchain0x/mcp fornece a um host MCP cinco ferramentas de carteira de agente: ler uma carteira, listar carteiras, verificar uma transação, enviar um pagamento USDC e liquidar uma fatura x402. Execute com npx @blockchain0x/mcp (sua chave permanece na sua máquina) ou aponte para a URL hospedada. Separadamente, o pacote exporta requirePayment para que você possa colocar um preço em suas próprias ferramentas MCP com um desafio x402 402.

Duas maneiras de executá-lo. Sem instalação para o hospedado.

Execute localmente via stdio com npx (sua chave permanece em sua máquina), ou aponte qualquer host MCP para a URL HTTP hospedada Streamable e passe a chave como um token Bearer. Ambos se integram diretamente à configuração MCP do host. Node 20+ para o caminho 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 é uma chave sk_test_ testnet ou sk_live_ mainnet do seu painel; BLOCKCHAIN0X_API_BASE_URL é https://api.blockchain0x.com por padrão. O servidor encaminha sua chave para o backend e não armazena nada, então o escopo e os limites dessa chave são exatamente o que o agente pode fazer. As cinco ferramentas que ele expõe: get_wallet, list_wallets, get_transaction, send_payment e settle_payment_request.

Marque o chamador como pago quando o webhook chegar.

Quando um pagamento é liquidado, Blockchain0x POSTa um evento payment.received assinado para sua URL de webhook. Verifique-o com webhooks.verify do SDK do Node, então registre que o chamador pagou em qualquer armazenamento que você já utiliza. Não há cache de recibos enviado para configurar - você possui essa parte, o que significa que não há infraestrutura surpresa.

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 faz HMAC-SHA256 em tempo constante e retorna uma união discriminada, então você ramifica em result.ok sem try/catch. Leia o corpo bruto, não uma cópia analisada, porque a assinatura cobre os bytes exatos. Os eventos enviados são payment.received, payment.sent, wallet.deployed e webhook.test; um pagamento para sua carteira é payment.received. Onde você persiste 'este chamador pagou' - uma linha de banco de dados, uma chave Redis, um mapa em memória para um único processo - é sua decisão.

Cinco armadilhas específicas do MCP a evitar.

Estes vêm de operadores que executam servidores MCP pagos em produção. A maioria se relaciona com a arquitetura de cache e o formato de erro específico do protocolo MCP.