10 నిమిషాల్లో మీ MCP సర్వర్ను మోనిటైజ్ చేయండి.
AI ఏజెంట్లు మీ MCP సర్వర్కు USDCలో ప్రతి కాల్కు చెల్లించడానికి అనుమతించండి, సంతకం చేసిన వెబ్హుక్లు మరియు ఆడిట్ లాగ్లతో. x402-అనుకూలం. డ్రాప్-ఇన్ మిడ్వేర్.
మీరు ఒక MCP సర్వర్ను నిర్మించారు. వేలాది క్లయింట్లు దీన్ని ఉచితంగా ఉపయోగిస్తున్నారు.
మీరు క్లాడ్ డెస్క్టాప్, కర్సర్ మరియు క్లైన్ క్లయింట్లకు సామర్థ్యం అవసరమైందని మీ MCP సర్వర్ను పంపించారు. పదాలు వ్యాపించాయి. మీరు ఇప్పుడు మీరు ఎప్పుడూ కలిసిన AI ఏజెంట్ల నుండి రోజుకు వేలాది చెల్లించిన టూల్ ఆహ్వానాలను అందిస్తున్నారు. మీ ఇగ్రెస్స్ బిల్ నిజం. మీ ఆధారిత సేవ కోసం API కీ నిజం. మీ నిర్వహణ సమయం నిజం. ఆదాయం సున్నా.
మీకు మూడు ఎంపికలు ఉన్నాయి. దీన్ని ఉచితంగా ఉంచండి మరియు మౌలిక వసతులపై డబ్బు కాల్చండి. దీనిని మాన్యువల్ API కీలు వెనుక గేటింగ్ చేయండి (మరియు సైన్అప్ ఫారమ్ల కష్టతకు 95% ఏజెంట్ ట్రాఫిక్ను కోల్పోండి). లేదా AI ఏజెంట్లు నిజంగా పూర్తి చేయగల చెల్లింపు పొరను జోడించండి - ఇది 402 చెల్లింపు అవసరం + USDC కోసం నిర్మించబడింది.
Blockchain0x ఎంపిక మూడు. మీ MCP సర్వర్ మా API వైపు చూపిస్తుంది. ఒక AI క్లయింట్ చెల్లించిన టూల్ను కాల్ చేసినప్పుడు, ప్రతిస్పందన 402 తో హోస్టెడ్ చెల్లింపు URL ఉంటుంది. క్లయింట్ (లేదా దాని మానవ పర్యవేక్షకుడు) USDC లో చెల్లిస్తాడు. మీ వెబ్హుక్ ఫైర్ అవుతుంది. ఆ క్లయింట్ నుండి వచ్చే తదుపరి కాల్ విజయవంతం అవుతుంది. మొత్తం ఆకారం x402 అని పిలువబడుతుంది, మరియు ఇది Coinbase ఈ ఖచ్చితమైన నమూనా కోసం ప్రచురించిన ప్రోటోకాల్.
402 చెల్లింపు అవసరం ఎలా ప్రోగ్రామాటిక్ చెక్అవుట్ అవుతుంది.
HTTP స్థితి కోడ్ 402 మొదట స్పెక్స్ రాసినప్పటి నుండి ఉంది కానీ ఎప్పుడూ ఒక ప్రమాణిత అమలు లేదు. Coinbase యొక్క x402 ప్రోటోకాల్ చివరకు దీనికి ఒకటి ఇస్తుంది. ఆకారం సరళమైనది: మీ సాధనం 402 ఛాలెంజ్ను తిరిగి ఇస్తుంది (ఎలా చెల్లించాలో వివరించే నిర్మిత JSON శరీరం); క్లయింట్ చెల్లించి పునరావృతం చేస్తుంది; కాల్ విజయవంతం అవుతుంది. @blockchain0x/mcp నుండి 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ని హోస్టెడ్ చెక్అవుట్కు అనుసరిస్తాడు మరియు బేస్పై USDC బదిలీని పూర్తి చేస్తాడు (x402-అవగాహన కలిగిన వాలెట్ ద్వారా ప్రోగ్రామాటికల్గా లేదా QR కోడ్ ద్వారా మాన్యువల్గా).
- Webhook: Blockchain0x చైన్ నిర్ధారణకు కొన్ని సెకన్లలో మీ ఎండ్ పాయింట్కు payment.receivedను పంపుతుంది. మీరు దీన్ని webhooks.verifyతో నిర్ధారించి, చెల్లింపుదారుని మీ స్వంత స్టోర్లో చెల్లించినట్లు నమోదు చేస్తారు.
- పునరావృతం: క్లయింట్ అసలు MCP సాధన కాల్ను పునరావృతం చేస్తుంది. మీ హ్యాండ్లర్ ఇప్పుడు చెల్లింపుదారుని చెల్లించినట్లు గుర్తించి, సాధనాన్ని నడుపుతుంది మరియు వాస్తవ ఫలితాన్ని తిరిగి ఇస్తుంది.
ప్రతి చెల్లింపు మీ Blockchain0x డాష్బోర్డ్లో నమోదు చేయబడుతుంది, మరియు ప్రతి payment.received వెబ్హుక్ మీ స్వంత లాగ్లలో పడుతుంది. మీరు చెల్లించిన రాష్ట్రాన్ని మరియు వెబ్హుక్ హ్యాండ్లర్ను కలిగి ఉండటంతో, ప్రతి సాధనం మరియు ప్రతి చెల్లింపుదారుడి ఆదాయ విశ్లేషణలు మీరు ఇప్పటికే నిల్వ చేసిన డేటా నుండి వస్తాయి.
ఒక పూర్తి పని ఉదాహరణ.
requirePayment @blockchain0x/mcp నుండి 402 సవాలు నిర్మిస్తుంది; webhooks.verify @blockchain0x/node నుండి ధృవీకరించబడుతుంది. మీరు మధ్యలో రెండు చిన్న భాగాలను కలిగి ఉన్నారు: టూల్లో చెల్లించిన రాష్ట్రాన్ని తనిఖీ చేయడం, మరియు చెల్లింపుదారుని చెల్లించినట్లు గుర్తించే వెబ్హుక్ హ్యాండ్లర్. క్రింద ఒక చెల్లించిన టూల్ మరియు దాని వెబ్హుక్ ఎండ్పాయింట్ను ప్రదర్శించే పూర్తి MCP సర్వర్ ఉంది.
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 server దీన్ని Authorization: Bearer గా పంపుతుంది) మరియు BLOCKCHAIN0X_WEBHOOK_SECRET (dashboard సైన్ చేసే సీక్రెట్, webhooks.verify దీన్ని తనిఖీ చేస్తుంది).
- 4మీ చెల్లించిన సాధనాలను గేట్ చేయండి మీ స్వంత చెల్లించిన రాష్ట్రాన్ని తనిఖీ చేసి, కాలర్ చెల్లించకపోతే requirePayment ఛాలెంజ్ శరీరాన్ని తిరిగి ఇవ్వండి. ఉచిత సాధనాలను అన్గేటెడ్గా ఉంచండి.
- 5Webhook ఎండ్ పాయింట్ను కాన్ఫిగర్ చేయండి Blockchain0x డాష్బోర్డులో (ఉదాహరణకు /webhooks/blockchain0x), తరువాత ప్రతి డెలివరీని webhooks.verifyతో నిర్ధారించండి మరియు చెల్లింపును అందించినప్పుడు చెల్లింపుదారుని చెల్లించినట్లు గుర్తించండి.
- 6తెరవండి. మీ చెల్లించిన టూల్ను తాకే మొదటి AI క్లయింట్ 402ని పొందుతుంది, చెల్లిస్తుంది, మరియు తదుపరి కాల్ విజయవంతమవుతుంది. మీరు 10 సెకన్లలో డాష్బోర్డులో చెల్లింపును చూడవచ్చు.
మీరు npx @blockchain0x/mcp (stdio) లేదా mcp.blockchain0x.com వద్ద హోస్టెడ్ స్ట్రీమబుల్ HTTP కంటైనర్తో Blockchain0x MCP సర్వర్ను కూడా నడుపవచ్చు. వెబ్హుక్ పేమెంట్ ఆకారాలను కలిగి ఉన్న పూర్తి సెటప్ డాక్యుమెంటేషన్లో ఉంది.
మీ హ్యాండ్లర్లో అత్యంత ముఖ్యమైన నిర్ణయం.
paid-state మీ సొంతం కాబట్టి, payment ఎంతకాలం చెల్లుబాటు అవుతుందో కూడా మీరు నిర్ణయిస్తారు. Client ఒక tool కోసం pay చేసిన తర్వాత, కొంత సమయం పాటు అతన్ని paid గా గుర్తించండి, మరియు ఆ window లో fresh payment లేకుండానే calls ను అనుమతించండి. Window ను చాలా చిన్నదిగా పెడితే ప్రతి call కు payment friction తో clients ను ఇబ్బంది పెడతారు; చాలా పెద్దదిగా పెడితే ఒక చౌక payment తర్వాత ఖరీదైన operations ను ఉచితంగా ఇచ్చినట్లవుతుంది. దీన్ని అమలు చేయడానికి Redis/Postgres key పై TTL పెట్టడం అత్యంత సులభమైన మార్గం.
మేము సిఫారసు చేసే విండోలు
| సాధనం రకం | విండో | ఎందుకు |
|---|---|---|
| చెప్పు lookup ($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 సర్వర్ ఆపరేటర్లు దాదాపు ఎప్పుడూ ప్రో నుండి ప్రారంభిస్తారు ఎందుకంటే API రాయడం యాక్సెస్ మరియు వెబ్హుక్స్ మొదటి రోజున అవసరం: ఉచితం చదవడానికి మాత్రమే, మరియు చెల్లించిన టూల్ చెల్లింపు.చెల్లించబడిన వెబ్హుక్స్ను స్వీకరించాలి మరియు వాటిని ధృవీకరించాలి. ఖచ్చితమైన ప్రతి-ఏజెంట్ ఖర్చు మరియు లావాదేవీ-ఫీజు స్థాయిలు ఎక్కడ ఉన్నాయో చూడడానికి ధర పేజీని చూడండి; సంక్షిప్త వెర్షన్ ఏదైనా సర్వర్ నిజమైన చెల్లింపుల పరిమాణం చేస్తే అది ప్రో తనకు తాను చెల్లించడానికి చాలా దాటించబడింది.
- Free: API మరియు dashboardతో experiment చేయడానికి ఉపయోగకరం. Production paid toolsకు సరిపోదు (read-only, no webhooks).
- Pro: live MCP servers కోసం default. Full API access, webhooks, exports.
- Business: compliance కోసం audit log అవసరమైనప్పుడు, లేదా మీరు multiple clients కోసం MCP servers నడిపి per-agent team-seat sharing కావాలనుకున్నప్పుడు.