व्यक्तिमत्व 2 - MCP सर्व्हर ऑपरेटर

10 मिनिटांत तुमचा MCP सर्व्हर मनीटायझ करा.

Q: मी कोणत्या क्लायंटने पैसे दिले आहेत आणि त्यांनी किती खर्च केला आहे ते कसे पाहू?

प्रत्येक पेमेंट तुमच्या Blockchain0x डॅशबोर्डमध्ये भरणार्याचा वॉलेट पत्ता, टाइमस्टॅम्प, आणि रक्कम यासह नोंदवला जातो, आणि त्याच डेटा तुमच्या payment.received वेबहुकवर येतो जेणेकरून तुम्ही ते तुमच्या आवडीनुसार संग्रहित करू शकता. कारण तुम्ही हँडलर नियंत्रित करता, तुम्ही त्या गोष्टींची लॉग देखील करू शकता ज्या लायब्ररी कधीच पाहत नाही: कोणते टूल कॉल केले गेले, प्रत्येक 402 आव्हान तुम्ही परत केले, आणि तुम्ही विद्यमान पेमेंटमधून सर्व्ह केलेले प्रत्येक कॉल. त्या पेमेंट्सच्या विरुद्ध त्यांना जोडा आणि तुम्हाला प्रति-भरणार्याचे आणि प्रति-टूल महसूल विश्लेषण मिळेल.

AI एजंटना तुमच्या MCP सर्व्हरला प्रति कॉल, USDC मध्ये, साइन केलेले वेबहुक आणि ऑडिट लॉगसह पैसे द्या. x402-संगत. ड्रॉप-इन मिडलवेअर.

दुख

तुम्ही एक MCP सर्व्हर तयार केला. हजारो ग्राहक ते मोफत वापरत आहेत.

तुम्ही तुमचा MCP सर्व्हर पाठवला कारण Claude Desktop, Cursor, आणि Cline ग्राहकांना क्षमता आवश्यक होती. शब्द पसरला. तुम्ही आता तुम्ही कधीही भेटलेले नसलेले AI एजंट्सकडून दररोज हजारो सशुल्क टूल आवाहन सेवा देत आहात. तुमचा ईग्रेस बिल वास्तविक आहे. तुमचा आधारभूत सेवेसाठी API की वास्तविक आहे. तुमचा देखभाल वेळ वास्तविक आहे. महसूल शून्य आहे.

तुमच्याकडे तीन पर्याय आहेत. ते मोफत ठेवा आणि पायाभूत सुविधांवर पैसे जाळा. ते मॅन्युअल API कीज मागे गेट करा (आणि साइनअप फॉर्मच्या ताणामुळे एजंट ट्रॅफिकचा 95% गमवा). किंवा एक पेमेंट लेयर जो AI एजंट प्रत्यक्षात पूर्ण करू शकतात, जो 402 पेमेंट आवश्यक + USDC साठी तयार केले आहे, जोडा.

Blockchain0x हा तिसरा पर्याय आहे. तुमचा MCP सर्व्हर आमच्या API कडे निर्देशित करतो. जेव्हा एक AI क्लायंट एक सशुल्क साधन कॉल करतो, तेव्हा प्रतिसाद 402 असतो ज्यामध्ये एक होस्ट केलेला पेमेंट URL असतो. क्लायंट (किंवा त्याचा मानव पर्यवेक्षक) USDC मध्ये पैसे देतो. तुमचा वेबहुक कार्यरत होतो. त्या क्लायंटकडून पुढील कॉल यशस्वी होतो. संपूर्ण आकाराला x402 असे म्हणतात, आणि हे Coinbase ने या अचूक पॅटर्नसाठी प्रकाशित केलेले प्रोटोकॉल आहे.

X402 पॅटर्न

कसे 402 पेमेंट आवश्यक प्रोग्रामेटिक चेकआउट बनते.

HTTP स्थिती कोड 402 पहिल्यांदा लिहिल्यापासून अस्तित्वात आहे, परंतु कधीही मानक अंमलबजावणी नाही. Coinbase चा x402 प्रोटोकॉल अखेर एक देते. आकार साधा आहे: तुमचे साधन 402 चॅलेंज परत करते (कसे पैसे द्यायचे हे वर्णन करणारी संरचित JSON बॉडी); क्लायंट पैसे भरतो आणि पुन्हा प्रयत्न करतो; कॉल यशस्वी होतो. @blockchain0x/mcp कडून requirePayment तुमच्यासाठी त्या चॅलेंज बॉडीचे निर्माण करते.

402 चॅलेंज बॉडी requirePayment तयार करते, एक साधन त्रुटी म्हणून परत केली

{
  "error": "payment_required",
  "amountUsdc": "0.02",
  "payTo": "0xYourMcpAgentAddress",
  "hostedUrl": "https://pay.blockchain0x.com/checkout/docs-search",
  "network": "mainnet",
  "description": "docs search"
}

चार राज्ये

अवेतन कॉल: AI क्लायंट एक पेड टूल कॉल करतो. तुमचा हँडलर तुमच्या स्वतःच्या पेड-स्टेटची तपासणी करतो, पेअरला पैसे दिले म्हणून चिन्हांकित केलेले आढळत नाही, आणि requirePayment मधून 402 आव्हान शरीर टूल त्रुटी म्हणून परत करतो.
भुगतान: क्लायंट होस्टेडUrl वर होस्टेड चेकआउटवर जातो आणि Base वर USDC ट्रान्सफर पूर्ण करतो (किंवा x402-जानकार वॉलेटद्वारे प्रोग्रामेटिकली किंवा QR कोडद्वारे मॅन्युअली).
वेबहुक: Blockchain0x चेन पुष्टीकरणाच्या काही सेकंदात payment.received तुमच्या एंडपॉइंटवर फायर करतो. तुम्ही ते webhooks.verify सह सत्यापित करता आणि तुमच्या स्वतःच्या स्टोअरमध्ये पेअरला पैसे दिले म्हणून नोंद करता.
पुन्हा प्रयत्न करा: क्लायंट मूळ MCP टूल कॉल पुन्हा करतो. तुमचा हँडलर आता पैसे दिलेल्या पेअरला चिन्हांकित केलेले पाहतो, टूल चालवतो, आणि वास्तविक परिणाम परत करतो.

प्रत्येक पेमेंट तुमच्या Blockchain0x डॅशबोर्डमध्ये नोंदवला जातो, आणि प्रत्येक payment.received वेबहुक तुमच्या स्वतःच्या लॉगमध्ये येतो. कारण तुम्ही भरणा-राज्य आणि वेबहुक हँडलरचे मालक आहात, प्रति-टूल आणि प्रति-भरणार्‍याचे महसूल विश्लेषण तुम्ही आधीच संग्रहित केलेल्या डेटावरून बाहेर पडते.

मध्यवर्ती सॉफ्टवेअर सेटअप

एक संपूर्ण कार्यरत उदाहरण.

requirePayment @blockchain0x/mcp कडून 402 आव्हान तयार करते; webhooks.verify @blockchain0x/node कडून पुष्टीकरणाची पडताळणी करते. तुम्ही दोन्ही लहान तुकडे मालकीचे आहात: टूलच्या आत भरणा-राज्य तपासणी, आणि एक वेबहुक हँडलर जो भरणा करणाऱ्याला भरणा केले म्हणून चिन्हांकित करतो. खाली एक संपूर्ण MCP सर्व्हर आहे जो एक भरणा केलेले टूल आणि त्याचा वेबहुक एंडपॉइंट उघडतो.

INDEX.TS - एक paid tool आणि त्याच्या webhook सह MCP server

import express from "express";
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { requirePayment } from "@blockchain0x/mcp";
import { webhooks } from "@blockchain0x/node";

const server = new McpServer({ name: "docs-search", version: "1.0.0" });

// You decide who counts as paid. Back this with Redis/Postgres in production.
const paid = new Set<string>();

server.tool(
  "search_docs",
  "Semantic search across our docs",
  { query: { type: "string" }, payer: { type: "string" } },
  async ({ query, payer }) => {
    if (!paid.has(`search_docs:${payer}`)) {
      // Not paid yet: build an x402-compatible 402 challenge and return its
      // body as a tool error. requirePayment is a challenge builder - it does
      // not gate the call for you; this check is yours.
      const { body } = requirePayment({
        amountUsdc: "0.02",
        payTo: "0xYourMcpAgentAddress",
        hostedUrl: "https://pay.blockchain0x.com/checkout/docs-search",
        description: "docs search",
      });
      return { content: [{ type: "text", text: JSON.stringify(body) }], isError: true };
    }
    const results = await runVectorSearch(query);
    return { content: [{ type: "text", text: JSON.stringify(results) }] };
  },
);

// Your webhook endpoint marks a payer as paid once the checkout settles.
const app = express();
app.post("/webhooks/blockchain0x", express.raw({ type: "*/*" }), (req, res) => {
  const r = webhooks.verify({ headers: req.headers, rawBody: req.body, secret: process.env.BLOCKCHAIN0X_WEBHOOK_SECRET! });
  if (!r.ok) return res.status(400).json({ code: r.code });
  if (r.eventType === "payment.received") {
    // Resolve (tool, payer) from the reference you encoded in hostedUrl, then:
    paid.add("search_docs:0xPayer");
  }
  res.json({ received: true });
});

सेटअप चरण

1तुमच्या MCP सर्व्हरसाठी Blockchain0x एजंट वॉलेट तयार करा, ज्यामध्ये API आणि वेबहुक प्रवेश समाविष्ट आहे. तुम्ही payTo म्हणून वापरणार असलेला वॉलेट पत्ता लक्षात ठेवा.
2पॅकेजेस स्थापित करा: npm install @blockchain0x/mcp @blockchain0x/node
3पर्यावरण चल सेट करा: BLOCKCHAIN0X_API_KEY (MCP सर्व्हर ते Authorization: Bearer म्हणून पाठवतो) आणि BLOCKCHAIN0X_WEBHOOK_SECRET (webhooks.verify ज्याच्याशी तपासते तो डॅशबोर्ड साइनिंग सीक्रेट).
4तुमच्या पेड टूल्स गेट करा तुमच्या स्वतःच्या पेड-स्टेटची तपासणी करून आणि कॉलरने पैसे दिले नसल्यास requirePayment आव्हान शरीर परत करून. मोफत टूल्स अनगेटेड ठेवा.
5Webhook एंडपॉइंट कॉन्फिगर करा Blockchain0x डॅशबोर्डमध्ये (उदाहरणार्थ /webhooks/blockchain0x), नंतर प्रत्येक डिलिव्हरीची पुष्टी करा webhooks.verify सह आणि पेमेंटवर पेअरला पैसे दिले म्हणून चिन्हांकित करा. received.
6तैनात करा. तुमच्या सशुल्क साधनावर पहिला AI क्लायंट 402 प्राप्त करतो, पैसे भरतो, आणि पुढील कॉल यशस्वी होतो. तुम्ही 10 सेकंदांच्या आत डॅशबोर्डमध्ये पेमेंट पाहता.

तुम्ही Blockchain0x MCP server स्वतःही npx @blockchain0x/mcp (stdio) किंवा mcp.blockchain0x.com वरील hosted Streamable HTTP container सोबत चालवू शकता. webhook payload shapes सहित पूर्ण setup documentation मध्ये आहे.

तुमचा paid window

तुमच्या हँडलरमधील एकट्या सर्वात महत्त्वाचा निर्णय.

कारण तुम्ही पैसे दिलेल्या स्थितीचे मालक आहात, तुम्ही देखील ठरवता की एक पेमेंट किती काळ मोजला जातो. ग्राहकाने एका टूलसाठी पैसे दिल्यानंतर, त्यांना काही काळासाठी पैसे दिलेले म्हणून चिन्हांकित ठेवा, आणि त्या विंडोच्या आत ताज्या पेमेंटशिवाय कॉल्सला परवानगी द्या. विंडो खूप लहान सेट करा आणि तुम्ही प्रत्येक कॉलवर पेमेंट ताणाने ग्राहकांना शिक्षा करता; खूप लांब सेट करा आणि तुम्ही एक स्वस्त पेमेंट केल्यानंतर महागड्या ऑपरेशन्सचा त्याग करता. तुमच्या Redis/Postgres कीवर TTL लागू करणे हे लागू करण्याचा सर्वात सोपा मार्ग आहे.

आम्ही शिफारस केलेले कालावधी

साधन प्रकार	विंडो	का
स्वस्त लुकअप ($0.01-$0.05)	60 सेकंद	सत्र न सोडता नैसर्गिक पुनर्प्रयत्न आणि फॉलो-अप कॉल्स शोषून घेतो.
मध्यम किंमतीचे अनुमान ($0.10-$1)	30 सेकंद	प्रति कॉल भरणे योग्य आकार आहे; संक्षिप्त कॅश तात्पुरत्या त्रुटींवर पुन्हा प्रयत्न करते.
महाग दीर्घ-संदर्भ ($1-$10)	0 सेकंद (कोणताही कॅश नाही)	प्रत्येक कॉल स्वतःचा सशुल्क इव्हेंट आहे; कॅशिंग नाही.
सदस्यता-शैली साधने	24 तास	विंडोच्या आत अमर्याद कॉलसाठी दररोज एकदा भरा. कमी घर्षणात प्रति ग्राहक अधिक महसूल.

तुमच्या पैसे दिलेल्या स्थितीला (भरणा करणारा वॉलेट, साधन) जोडणी करा, जसे उदाहरण search_docs:0xPayer सह करते. दोन भिन्न क्लायंट एकाच साधनावर हिट करतात, प्रत्येक स्वतंत्रपणे पैसे देतो. एकाच क्लायंटने दोन भिन्न साधनांवर हिट केले, दोन स्वतंत्र पेमेंट आवश्यक आहेत. तुम्ही ते अधिक व्यापकपणे (सर्व साधनांवर प्रति भरणा करणारा) स्कोप करू शकता; प्रति भरणा करणारा प्रति साधनाची तपशीलता म्हणजे किंमत न्याय्य वाटते.

किंमत पॅटर्न

MCP सर्व्हर्ससाठी कार्यरत चार किंमत आकार.

किंमत निर्धारण हे तुमचे आहे - आपण मिडलवेअरमध्ये प्रति टूल रक्कम सेट करता. खाली चार नमुने आहेत जे आम्ही सर्वाधिक पाहतो आणि जे टूल आकार त्यात बसतात.

प्रति-कॉल सूक्ष्म किंमत

$0.01 - $0.05 प्रति कॉल

शोध, लुकअप, वर्गीकरण, फॉरमॅट रूपांतरण - उच्च प्रमाणात स्वस्त ऑपरेशन्स.

फायदे

ग्राहकांसाठी सर्वात कमी घर्षण; खर्च वापरास अचूकपणे संरेखित करतो.

विरुद्ध

सर्वाधिक व्यवहार ओव्हरहेड; फक्त उच्च कॉल व्हॉल्यूमवर कार्य करते.

प्रति-कॉल मध्यम किंमत

$0.10 - $1.00 प्रति कॉल

LLM अनुमान, उत्पादन, सामग्री निर्मिती, जिथे प्रत्येक कॉल वास्तविक काम करते.

फायदे

संतुलित - प्रत्येक कॉलसाठी स्पष्ट मूल्य, व्यवस्थापित व्यवहार संख्या.

विरुद्ध

प्रत्येक कॉलसाठी उच्च घर्षण; ग्राहक कधी कधी या किंमतीच्या बिंदूवर सदस्यता घेणे पसंत करतात.

प्रति-कॉल उच्च किंमत

$1 - $10 प्रति कॉल

दीर्घ-संदर्भ उत्पादन, दस्तऐवज प्रक्रिया, बहु-चरण समन्वय, महाग तिसऱ्या पक्षाच्या API लपवणे.

फायदे

प्रति कॉल मार्जिन महत्त्वाचा आहे; अपयशी पेमेंट सहनशील तोटा आहेत.

विरुद्ध

ग्राहक या किंमतीवर कठोर वाटाघाटी करतात; परताव्याच्या विनंत्या अपेक्षित आहेत.

सदस्यता विंडो

$5 - $50 प्रति 24 तास विंडो (किंवा $X प्रति महिना)

ग्राहक जे एका सत्रात अनेक कॉल करतात आणि प्रति-कॉल पेमेंट घर्षण सहन करणार नाहीत.

फायदे

प्रत्येक ग्राहकासाठी उच्च महसूल; प्रत्येक कॉलवर कमी ओव्हरहेड.

विरुद्ध

कमी शोधण्यायोग्यता; ग्राहकांनी आधीच वचनबद्ध असावे. सहसा हायब्रीड किंमतीसाठी प्रति-कॉलसह एकत्रित केले जाते.

अनेक ऑपरेटर पॅटर्न मिश्रण करतात: प्रति-कॉल मायक्रो-प्रायसिंगवर स्वस्त साधने, प्रति-कॉल उच्च-प्रायसिंगवर महागडी साधने, तसेच भारी वापरकर्त्यांसाठी 24-तासांची सदस्यता विंडो. तुम्हाला एकाच MCP सर्व्हरवर सर्व तीन चालवण्यापासून काहीही थांबवत नाही; प्रत्येक साधन requirePayment मध्ये त्याची स्वतःची amountUsdc सेट करते आणि तुमच्या हँडलरमध्ये त्याची स्वतःची पेड-विंडो सेट करते.

कौनता योजना योग्य आहे

प्रो जवळजवळ प्रत्येक MCP सर्व्हरसाठी योग्य योजना आहे.

MCP सर्व्हर ऑपरेटर सहसा Pro वर सुरू करतात कारण API लेखन प्रवेश आणि वेबहुक्स पहिल्या दिवशी आवश्यक आहेत: मोफत वाचन-केवळ आहे, आणि पेड साधनाला payment.received वेबहुक प्राप्त करणे आणि त्यांची पडताळणी करणे आवश्यक आहे. प्रति-एजंट खर्चासाठी अचूक किंमत पृष्ठ पहा आणि व्यवहार-फी स्तर कुठे आहेत ते पहा; संक्षिप्त आवृत्ती म्हणजे कोणताही सर्व्हर जो वास्तविक पेड व्हॉल्यूम करतो तो Pro स्वतःसाठी पैसे देण्याच्या बिंदूपर्यंत चांगला आहे.

Free: API आणि dashboard सह प्रयोग करण्यासाठी उपयुक्त. production paid tools साठी योग्य नाही (read-only, no webhooks).
Pro: live MCP servers साठी default. Full API access, webhooks, exports.
Business: जेव्हा compliance साठी audit log आवश्यक असतो, किंवा जेव्हा तुम्ही अनेक clients साठी MCP servers चालवता आणि per-agent team-seat sharing हवे असते.

पूर्ण किंमत पहा

वारंवार विचारले जाते

पाच MCP-विशिष्ट प्रश्न.

माझा MCP सर्व्हर Blockchain0x वर होस्ट करणे आवश्यक आहे का? किंवा विशिष्ट क्लाउडवर चालवणे आवश्यक आहे का?

नाही. तुमचा MCP सर्व्हर जिथे सामान्यतः चालतो तिथे चालू शकतो: तुमचा लॅपटॉप, AWS, Fly.io, Cloudflare Workers, एक Raspberry Pi. मिडलवेअर फक्त एक नोड मॉड्यूल आहे जे तुमच्या टूल हँडलर्सला लपवते. तुमचा सर्व्हर api.blockchain0x.com वर बाह्य HTTPS कॉल करू शकतो आणि तुम्ही नियंत्रित केलेल्या URL वर येणारे वेबहुक प्राप्त करू शकतो, तर एकत्रीकरण कार्य करते. आम्ही तुमचा MCP सर्व्हर होस्ट करत नाही; आम्ही पेमेंट पृष्ठ होस्ट करतो.

जेव्हा एक AI क्लायंट x402 समजत नाही आणि फक्त 402 प्रतिसाद मिळवतो तेव्हा काय होते?

चॅलेंज बॉडी अशी रचना केलेली आहे की एक नॉन-x402-जानकारी असलेला क्लायंट एक अर्थपूर्ण त्रुटी पाहतो: एक त्रुटी कोड, amountUsdc, आणि पैसे भरण्यासाठी एक hostedUrl. साधन त्रुटी वापरकर्त्यास समोर आणणारे क्लायंट (Claude Desktop किंवा Cursor सारखे बहुतेक चॅट-आधारित क्लायंट) वापरकर्त्यास क्लिक करून पैसे भरण्यासाठी URL दर्शवतील; क्लायंट जे कॉल पूर्णपणे प्रोग्रामेटिकली हाताळतात आणि त्रुटीला दुर्लक्ष करतात ते साधारणपणे परिणाम मिळवणार नाहीत, जे योग्य परिणाम आहे (कॉल भरला गेला नाही). x402-जानकारी असलेले क्लायंट चॅलेंज वाचतात, पूर्व-अधिकृत वॉलेट वापरून स्वयंचलितपणे पैसे भरतात, आणि पुन्हा प्रयत्न करतात.

पैसे दिलेल्या विंडोचा कालावधी किती आहे? ग्राहक एकदा पैसे देऊ शकतो आणि कायम कॉल करू शकतो का?

हे पूर्णपणे तुमचे निर्णय आहे, कारण तुम्ही भाडे-राज्याचे मालक आहात. भाडे कीवर 60-सेकंद TTL असणे एक सामान्य पर्याय आहे: हे नैसर्गिक पुनःप्रयत्न आणि फॉलो-अप पॅटर्न शोषून घेतो, एकाच देयकाने संपूर्ण सत्र व्यापण्याची परवानगी न देता. तुम्ही सदस्यता-शैलीच्या किंमतीसाठी ते लांब करू शकता, किंवा शून्य (प्रत्येक कॉलसाठी ताजे देयक आवश्यक आहे) महाग प्रति-कॉल साधनांसाठी. लायब्ररी एक विंडो लादत नाही; तुमचा स्टोअर आणि त्याचा TTL करतो.

मी एकाच MCP सर्व्हरवर सशुल्क साधने आणि मोफत साधने चालवू शकतो का?

हो. paid-state check (आणि miss झाल्यावर requirePayment challenge) फक्त paid tools मध्ये जोडा; free tools साधे handlers म्हणून ठेवा. Free tools कोणत्याही client साठी चालतात; paid tools ला पैसे भरलेपर्यंत 402 challenge मिळतो. अनेक operators स्वस्त tools free ठेवून (adoption वाढवण्यासाठी) आणि high-value tools (inference, generation, long-context work) साठी payment राखून सुरुवात करतात.

मी कोणत्या क्लायंटने पैसे दिले आहेत आणि त्यांनी किती खर्च केला आहे ते कसे पाहू?

प्रत्येक पेमेंट तुमच्या Blockchain0x डॅशबोर्डमध्ये भरणार्‍याचा वॉलेट पत्ता, टाइमस्टॅम्प, आणि रक्कम यासह नोंदवला जातो, आणि त्याच डेटा तुमच्या payment.received वेबहुकवर येतो जेणेकरून तुम्ही ते तुमच्या आवडीनुसार संग्रहित करू शकता. कारण तुम्ही हँडलर नियंत्रित करता, तुम्ही त्या गोष्टींची लॉग देखील करू शकता ज्या लायब्ररी कधीच पाहत नाही: कोणते टूल कॉल केले गेले, प्रत्येक 402 आव्हान तुम्ही परत केले, आणि तुम्ही विद्यमान पेमेंटमधून सर्व्ह केलेले प्रत्येक कॉल. त्या पेमेंट्सच्या विरुद्ध त्यांना जोडा आणि तुम्हाला प्रति-भरणार्‍याचे आणि प्रति-टूल महसूल विश्लेषण मिळेल.

तुमचा MCP सर्व्हर महसूलात रूपांतरित करा.

Pro वर प्रारंभ करा, npx @blockchain0x/mcp चालवा किंवा requirePayment आपल्या स्वतःच्या साधनांमध्ये वायर करा. इन्स्टॉलेशनपासून पहिल्या भाडे कॉलपर्यंत दहा मिनिटे.