@blockchain0x/mcp server ଗୋଟିଏ MCP host କୁ ପାଞ୍ଚଟି agent-wallet tool ଦିଏ: wallet ପଢ଼ନ୍ତୁ, wallets ତାଲିକା କରନ୍ତୁ, transaction ଯାଞ୍ଚ କରନ୍ତୁ, USDC payment ପଠାନ୍ତୁ, ଏବଂ x402 invoice settle କରନ୍ତୁ। ଏହାକୁ npx @blockchain0x/mcp ସହ ଚଳାନ୍ତୁ (ଆପଣଙ୍କ key ଆପଣଙ୍କ machine ରେ ରହେ) କିମ୍ବା hosted URL କୁ point କରନ୍ତୁ। ଅଲଗା ଭାବରେ, package requirePayment export କରେ ଯାହାଦ୍ୱାରା ଆପଣ x402 402 challenge ସହ ଆପଣଙ୍କ ନିଜ MCP tools ପାଇଁ ମୂଲ୍ୟ ଧାର୍ଯ୍ୟ କରିପାରିବେ।

ଏହାକୁ ଚାଲାଇବାରେ ଦୁଇଟି ଉପାୟ। ହୋଷ୍ଟ କରାଯାଇଥିବା ଏକ ପାଇଁ କୌଣସି ସ୍ଥାପନ ନାହିଁ।

npx ସହ stdio ମାଧ୍ୟମରେ ଏହାକୁ ସ୍ଥାନୀୟଭାବେ ଚଳାନ୍ତୁ (ଆପଣଙ୍କ key ଆପଣଙ୍କ machine ରେ ରହେ), କିମ୍ବା ଯେକୌଣସି MCP host କୁ hosted Streamable HTTP URL ଉପରେ point କରନ୍ତୁ ଏବଂ key କୁ Bearer token ଭାବେ ପାସ୍ କରନ୍ତୁ। ଦୁଇଟି ମଧ୍ୟ host ର MCP config ଭିତରେ ସିଧାସଳଖ ଯାଇପଡ଼େ। ସ୍ଥାନୀୟ path ପାଇଁ Node 20+ ଆବଶ୍ୟକ।

{
  "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 ହେଉଛି ଆପଣଙ୍କ dashboard ରୁ ମିଳୁଥିବା sk_test_ testnet କିମ୍ବା sk_live_ mainnet key; BLOCKCHAIN0X_API_BASE_URL ର default https://api.blockchain0x.com। server ଆପଣଙ୍କ key କୁ backend କୁ ପଠାଏ ଏବଂ କିଛି ସଞ୍ଚୟ କରେନାହିଁ, ସେଥିପାଇଁ ସେଇ key ର scope ଏବଂ caps ହିଁ agent କ’ଣ କରିପାରିବ ତାହା ନିର୍ଦ୍ଧାରଣ କରେ। ଏହା ପ୍ରଦର୍ଶନ କରୁଥିବା ପାଞ୍ଚଟି tools: get_wallet, list_wallets, get_transaction, send_payment, ଏବଂ settle_payment_request।

Webhook ଆସିଲେ caller କୁ paid ଭାବରେ ଚିହ୍ନଟ କରନ୍ତୁ।

ପେମେଣ୍ଟ ସେଟଲ୍ ହେଲେ, Blockchain0x ଆପଣଙ୍କ webhook URL କୁ signed payment.received event POST କରେ। Node SDK ର webhooks.verify ସହିତ ଏହାକୁ verify କରନ୍ତୁ, ତାପରେ caller paid ବୋଲି ଆପଣ ଯେଉଁ store ପୂର୍ବରୁ ଚଳାଉଛନ୍ତି ସେଠାରେ record କରନ୍ତୁ। କନଫିଗର୍ କରିବାକୁ shipped receipt cache କିଛି ନାହିଁ - ସେ ଅଂଶଟି ଆପଣଙ୍କ, ଯାହାର ଅର୍ଥ surprise infrastructure ନାହିଁ।

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 constant time ରେ HMAC-SHA256 କରେ ଏବଂ discriminated union ଫେରାଏ, ସେଥିପାଇଁ ଆପଣ try/catch ବିନା result.ok ଉପରେ branch କରନ୍ତୁ। raw body ପଢ଼ନ୍ତୁ, parsed copy ନୁହେଁ, କାରଣ signature ସଠିକ bytes କୁ ଆବରଣ କରେ। shipped events ହେଉଛି payment.received, payment.sent, wallet.deployed, ଏବଂ webhook.test; ଆପଣଙ୍କ wallet କୁ ହେଉଥିବା payment ହେଉଛି payment.received। 'this caller paid' କୁ କେଉଁଠି persist କରିବେ - database row, Redis key, single process ପାଇଁ in-memory map - ସେଟି ଆପଣଙ୍କ ଇଚ୍ଛା।

MCP-ନିର୍ଦ୍ଦିଷ୍ଟ ଜାଲକୁ ଏଡାଇବାକୁ ପାଞ୍ଚ ଜାଲ।

ଏହାଗୁଡିକ ଦେଖାଯାଇଛି ଯେଉଁଥିରେ ପ୍ରଯୋଜନାରେ ପ୍ରଦାନ କରାଯାଇଥିବା MCP ସର୍ଭର ଚାଳନା କରୁଥିବା ଓପରେଟରଙ୍କରୁ ଆସିଛି। ଅଧିକାଂଶ କ୍ୟାସ୍ ଆର୍କିଟେକ୍ଚର ଏବଂ MCP ପ୍ରୋଟୋକଲର ବିଶେଷ ତ୍ରୁଟି ଫର୍ମାଟ ସହିତ ସମ୍ପର୍କିତ।