ଆପଣ ଆରମ୍ଭ କରିବା ପୂର୍ବରୁ।

• ଏକ କାମ କରୁଥିବା MCP ସର୍ଭର୍ ଯାହା ନୋଡ୍ କିମ୍ବା ପାଇଥନ୍‌ରେ ଅଧିକାରୀ Model Context Protocol SDK ବ୍ୟବହାର କରେ। ଯଦି ତୁମର ଏକ ନାହିଁ, ତେବେ ପ୍ରଥମେ ଉପସ୍ଥାପନ ଟେମ୍ପଲେଟ୍ ସହିତ ଏକ ଗଢ଼।
• ଏକ Blockchain0x account ଏବଂ ଏକ agent profile (5-minute setup ପାଇଁ add-payments-to-agent guide ଦେଖନ୍ତୁ)।
• ଏକ API key (ଏହି ଗାଇଡ ପାଇଁ sk_test_ ବ୍ୟବହାର କରନ୍ତୁ)।
• କେଉଁଠି ଦେୟ ହୋଇଛି (ଏକ ଡାଟାବେସ୍ ରୋ ଅଥବା ଏକ Redis କୀ) ମନେ ରଖିବା ପାଇଁ ଏକ ଛୋଟ ଷ୍ଟୋର୍ - ଆପଣଙ୍କର କୋଡ୍ ଏହାକୁ ମାଲିକୀତ୍ୱ ଦେଇଛି, ଯାହା ଦେୟ webhook ଦ୍ୱାରା ଅଦ୍ୟତିତ।
• କେଉଁ tool ଗୁଡ଼ିକ ପାଇଁ ଆପଣ ଶୁଳ୍କ ନେବାକୁ ଚାହୁଁଛନ୍ତି ଏବଂ ପ୍ରତି call ଦର କେତେ, ସେଥିରେ ସ୍ପଷ୍ଟ ଧାରଣା। design patterns ପାଇଁ paid MCP tool glossary entry ଦେଖନ୍ତୁ।

requirePayment ସହିତ ଏକ ଟୁଲ୍ ଗେଟ୍ କରନ୍ତୁ।

Inside the tool, check your own paid-state for the caller. If they have not paid, call requirePayment and return the resulting 402 body; if they have, run the work. requirePayment is a pure builder - it does not wrap the handler and does not track payment, so the gating policy stays in your code.

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { requirePayment } from "@blockchain0x/mcp";
import { z } from "zod";

const server = new McpServer({ name: "premium-data-mcp", version: "1.0.0" });

server.tool(
  "get_quote_realtime",
  "Real-time quote (paid)",
  { ticker: z.string() },
  async ({ ticker }, extra) => {
    if (!hasPaid(extra)) {
      // Pure function: mint an x402 402 challenge and hand the body back.
      const { body } = requirePayment({
        amountUsdc: "0.005",
        payTo: "0xYourWallet",
        hostedUrl: "https://pay.blockchain0x.com/checkout/abc",
      });
      return { content: [{ type: "text", text: JSON.stringify(body) }], isError: true };
    }
    const quote = await fetchLiveQuote(ticker);
    return { content: [{ type: "text", text: JSON.stringify(quote) }] };
  },
);

import express from "express";
import { createX402Middleware } from "@blockchain0x/x402/server/express";
import { createClient } from "@blockchain0x/node";

const sdk = createClient({ apiKey: process.env.BLOCKCHAIN0X_API_KEY! });
const app = express();

// Not an MCP server? Gate a plain HTTP route the same way. The middleware
// answers unpaid requests with a 402 and lets paid ones through.
// Configure the price and recipient per the x402 docs.
app.use("/quote", createX402Middleware({ sdk }));

ଅଦାୟ caller କୁ requirePayment ଫେରାଇଥିବା 402 body:

// requirePayment returns { status: 402, body }. The body an unpaid caller sees:
{
  "error": "payment_required",
  "amountUsdc": "0.005",
  "payTo": "0xYourWallet",
  "hostedUrl": "https://pay.blockchain0x.com/checkout/abc",
  "network": "mainnet"
}

ଡିପ୍ଲୟ୍ କରନ୍ତୁ ଏବଂ ଭେରିଫାଇ କରନ୍ତୁ।

Server କୁ ship କରନ୍ତୁ। Free tools ତୁରନ୍ତ ତାଙ୍କର result ଫେରାଇବା ଉଚିତ୍; gated tools ନୂତନ client ର ପ୍ରଥମ call ରେ 402 body ଫେରାଇବା ଉଚିତ୍, ତାପରେ ସେ caller paid ଭାବେ ଚିହ୍ନଟ ହେଲେ run କରିବା ଉଚିତ୍। Live ହେବା ପୂର୍ବରୁ Base Sepolia ବିରୋଧରେ sk_test_ key ସହ ଦୁଇଟି ପଥ ଯାଞ୍ଚ କରନ୍ତୁ।

ପ୍ରଥମ ଦିନରେ ଦେଖିବାକୁ ଦୁଇଟି ସଙ୍କେତ: ଫେରାଇଥିବା 402 ଗଣନା (ଆପଣଙ୍କର ଟପ୍-ଓଫ୍-ଫନେଲ୍) ଏବଂ 402 ପରେ ସଫଳ ଟୁଲ୍ ଚଲାଇବାର ଗଣନା (ଆପଣଙ୍କର ପରିବର୍ତ୍ତନ)। ଯଦି ପରିବର୍ତ୍ତନ ଆଶା କରାଯାଇଥିବା ଠାରୁ ବହୁତ କମ୍ ଅଟକିଛି, ତେବେ ମୂଲ୍ୟ ସମ୍ଭବତଃ ଭୁଲ। ଆପଣଙ୍କର ପେଡ୍-ସ୍ଟେଟ୍ ସ୍ଟୋରର ହିଟ୍ ହାରକୁ ମଧ୍ୟ ଦେଖନ୍ତୁ - ଯଦି ଏହା ଶୂନ୍ୟକୁ ନିକଟ, ତେବେ ଆପଣଙ୍କର ଆକ୍ସେସ୍ ୱିଣ୍ଡୋ ଅତି କ୍ଷୁଦ୍ର ଏବଂ ପେଇଁ ଡାକୁଥିବା କଲରା ଆବାର ପେଇବାକୁ ଅନୁରୋଧ କରାଯାଉଛି।

ଏକଥର ପେଡ୍ ଟ୍ରାଫିକ୍ ବହୁଛି।

monetization ଥିବାବେଳେ, ସବୁଠୁ ଉପଯୋଗୀ follow-up ହେଲା dependable webhook handling (ଯାହାଦ୍ୱାରା payment events miss ନହୁଅନ୍ତି), spend controls (ଯାହାଦ୍ୱାରା ଆପଣ ତିଆରି କରୁଥିବା ଏବଂ ଅନ୍ୟ agents କୁ ମଧ୍ୟ ପେ କରୁଥିବା MCP server bounded ରହେ), ଏବଂ testnet-first flow (ଯାହାଦ୍ୱାରା ଆପଣ real money ଖର୍ଚ୍ଚ ନକରି pricing changes ship କରିପାରିବେ)।

docs.blockchain0x.com ରେ ପୂର୍ଣ୍ଣ API ସନ୍ଦର୍ଭ। ସମ୍ବନ୍ଧିତ ଉତ୍ପାଦ ସତହ: MCP ଇଣ୍ଟେଗ୍ରେସନ୍.