Add supported payment workflows to MCP.
যিকোনো MCP হোস্ট - Claude Desktop, Cursor, VS Code - এজেণ্ট ৱালেট টুলসমূহ এক কনফিগ ব্লকৰে দিয়ক। আৰু যেতিয়া আপোনাৰ নিজৰ টুলসমূহৰ বাবে চাৰ্জ কৰিবলৈ বিচাৰিব, বাস্তৱ requirePayment x402 নিৰ্মাতাৰ ব্যৱহাৰ কৰক।
@agentcredia/mcp ছাৰ্ভাৰে MCP হোস্টক পাঁচটা এজেণ্ট-ৱালেট সঁজুলি দিয়ে: এটা ৱালেট পঢ়ক, ৱালেটৰ তালিকা কৰক, এটা লেনদেন পৰীক্ষা কৰক, এটা USDC পেমেন্ট পঠিয়াওক, আৰু এটা x402 বিল সমাধান কৰক। ইয়াক npx @agentcredia/mcpৰ সৈতে চলাও (আপোনাৰ কী আপোনাৰ মেচিনত থাকে) অথবা হোস্ট কৰা URLলৈ চিহ্নিত কৰক। পৃথকভাৱে, পেকেজে requirePayment ৰপ্তানি কৰে যাতে আপুনি নিজৰ MCP সঁজুলিৰ বাবে x402 402 চেলেঞ্জৰ সৈতে এটা মূল্য ৰাখিব পাৰে।
MCPৰ জৰিয়তে ব্যয় কৰক। MCPৰ জৰিয়তে চাৰ্জ কৰক।
কৰ্ম এক: এজন এজেণ্টক ইয়াৰ হোস্টৰ ভিতৰৰ পৰা এটা ৱালেট ব্যৱহাৰ কৰিবলৈ দিয়ক। @agentcredia/mcp ছাৰ্ভাৰ হৈছে @agentcredia/node SDKৰ ওপৰত এটা চিকণ, ষ্টেটলেছ প্ৰক্সি। ই Claude Desktop, Cursor, বা VS Codeলৈ পাঁচটা ৱালেট টুল প্ৰকাশ কৰে, আৰু আপোনাৰ API চাবিৰ পৰিসৰ, ভাত, আৰু প্ৰতি-সময়ৰ সীমাসমূহ পেছন দিশৰ দ্বাৰা ঠিক যিকোনো অন্য API কলৰ দৰে প্ৰয়োগ কৰা হয়। ছাৰ্ভাৰটোৱে কোনো চাবি ৰাখে আৰু কিছু সংৰক্ষণ নকৰে।
কৰ্ম দুই: এজেণ্টক আপোনাৰ টুলসমূহৰ বাবে চাৰ্জ কৰক। MCP টুল আহ্বানক বাধাহীন কৰি তোলে, যি ভাল যতক্ষণ আপোনাৰ ছাৰ্ভাৰ বিনামূল্যে ইগ্ৰেছ, টোকেন, আৰু তৃতীয়-পক্ষৰ API খৰচ খাইছে। 402 পেমেন্টৰ প্ৰয়োজনীয় পেটাৰ্ন ইয়াত সঠিকভাৱে মিলে। requirePayment এটা গঠনমূলক x402 চেলেঞ্জ মিণ্ট কৰে যাৰ সৈতে এটা হোস্ট কৰা চেকআউট URL থাকে; যেতিয়া এটা টুল পেমেন্ট নকৰে তেতিয়া আপুনি ইয়াক উভতি দিয়ে আৰু পেমেন্ট সমাধান হ'লে কলটো মাৰিবলৈ অনুমতি দিয়ে। যিসকল ক্লায়েন্ট x402 কথা কয় সিহঁতে স্বয়ংক্ৰিয়ভাৱে পেমেন্ট কৰে; বাকীসকল মানুহলৈ URL প্ৰদৰ্শন কৰে।
ই চলাবৰ বাবে দুটা উপায়। হোস্ট কৰা এজনৰ বাবে কোনো স্থাপন নাই।
স্থানীয়ভাৱে stdioৰ জৰিয়তে npxৰ সৈতে চলাও (আপোনাৰ কীৰ আপোনাৰ মেচিনত থাকে), অথবা যিকোনো MCP হোস্টক হোস্ট কৰা Streamable HTTP URLলৈ নির্দেশ কৰক আৰু কীৰটো Bearer টোকেন হিচাপে পঠিয়াওক। দুয়োটা সোজাকৈ হোস্টৰ MCP কনফিগৰেশ্যনত মাৰা। স্থানীয় পথৰ বাবে Node 20+।
{ "mcpServers": { "agentcredia": { "command": "npx", "args": ["-y", "@agentcredia/mcp"], "env": { "AGENTCREDIA_API_KEY": "sk_live_...", "AGENTCREDIA_API_BASE_URL": "https://api.agentcredia.com" } } } }
{ "mcpServers": { "agentcredia": { "url": "https://mcp.agentcredia.com/mcp", "headers": { "Authorization": "Bearer sk_live_..." } } } }
AGENTCREDIA_API_KEY হৈছে আপোনাৰ ডেছ্ব'ৰ্ডৰ পৰা sk_test_ টেষ্টনেট বা sk_live_ মেইননেট কী; AGENTCREDIA_API_BASE_URLৰ ডিফল্ট হৈছে https://api.agentcredia.com। ছাৰ্ভাৰে আপোনাৰ কীটো ব্যাকএণ্ডলৈ আগবঢ়ায় আৰু কিছু সংৰক্ষণ নকৰে, সেয়ে সেই কীটোৰ ওপৰত পৰিসৰ আৰু সীমাসমূহ ঠিক যি এজেন্টে কৰিব পাৰে। ইয়াৰ পৰা উন্মোচন কৰা পাঁচটা টুল: get_wallet, list_wallets, get_transaction, send_payment, আৰু settle_payment_request।
বাস্তৱ requirePayment নিৰ্মাতাৰ সৈতে এটা টুল গেট কৰক।
requirePayment হৈছে @agentcredia/mcpৰ পৰা এটা বিশুদ্ধ ফাংশন। আপুনি ইয়াক তেতিয়া কল কৰে যেতিয়া এটা টুল অব্যৱহৃত থাকে, ই এটা x402 402 চেলেঞ্জ (মূল্য, আপোনাৰ ৱালেট, এখন হোস্ট কৰা চেকআউট URL) সৃষ্টি কৰে, আৰু আপুনি সেই শৰীৰটো মানক MCP ত্ৰুটিৰ আকাৰত উলিয়ায়। ই আপোনাৰ হেণ্ডলাৰটো মুড়ি নকৰে আৰু কাক পেমেন্ট কৰিছে সেয়া পৰ্যবেক্ষণ নকৰে - সেই অংশটো আপোনাৰ, যিয়ে সহায়কটোক সৰু আৰু সৎ ৰাখে।
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js"; import { requirePayment } from "@agentcredia/mcp"; import { z } from "zod"; const server = new McpServer({ name: "docs-search-mcp", version: "1.0.0" }); server.tool( "search_docs", "Semantic search across our private docs", { query: z.string() }, async ({ query }, extra) => { if (!hasPaid(extra)) { // Mint an x402 402 challenge and hand it back to the caller. const { body } = requirePayment({ amountUsdc: "0.10", payTo: "0xYourWallet", hostedUrl: "https://pay.agentcredia.com/checkout/abc", }); return { content: [{ type: "text", text: JSON.stringify(body) }], isError: true }; } const results = await runVectorSearch(query); return { content: [{ type: "text", text: JSON.stringify(results) }] }; }, );
যেতিয়া এজেণ্টে search_docs unpaidক কল কৰে, ই 402 বডী পায়। যিসকল ক্লায়েন্ট x402ৰ সৈতে কথা কয় সি স্বয়ংক্ৰিয়ভাৱে পেমেন্ট কৰে; Claude Desktop আৰু Cursor মানুহৰ বাবে চেকআউট URL প্ৰদৰ্শন কৰে। যেতিয়া পেমেন্ট স্থিৰ হয় আপুনি সেই কলকাৰীক পেমেন্ট কৰা বুলি চিহ্নিত কৰে (পৰৱৰ্তী বিভাগ) আৰু কলটো পাৰ হৈ যায়। আপুনি MCPৰ সলনি এটা সাধাৰণ HTTP ছাৰ্ভাৰক প্ৰাধান্য দিয়ে? গ্ৰহণ-পক্ষ x402 এডাপ্টাৰ - createX402Middleware for Express, createX402Plugin for Fastify - ফ্ৰেমৱৰ্ক স্তৰত একে গেটিং কৰে।
যেতিয়া ৱেবহুকটো আহে, কলাৰক পইচা কৰা বুলি চিহ্নিত কৰক।
যেতিয়া এটা পেমেন্ট স্থিৰ হয়, AgentCredia আপোনাৰ ৱেবহুক URLলৈ এটা স্বাক্ষৰিত payment.received ঘটনা POST কৰে। ইয়াক Node SDKৰ পৰা webhooks.verifyৰ সৈতে পৰীক্ষা কৰক, তাৰ পাছত যিকোনো ষ্টোৰত কলকাৰীক পেমেন্ট কৰা বুলি ৰেকৰ্ড কৰক যি আপুনি ইতিমধ্যে চলাইছে। কনফিগাৰ কৰিবলৈ কোনো প্ৰেৰণ কৰা ৰিচিট কেচ নাই - আপুনি সেই অংশৰ মালিক, যাৰ অৰ্থ হৈছে কোনো আচৰিত অবকাঠামো নাই।
import express from "express"; import { webhooks } from "@agentcredia/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.AGENTCREDIA_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 HMAC-SHA256 নিৰন্তৰ সময়ত কৰে আৰু এটা বাচনি কৰা ইউনিয়ন উলিয়ায়, সেয়ে আপুনি result.ok ত কোনো চেষ্টা/ধৰা নকৰাকৈ শাখা কৰে। কাঁচা শৰীৰ পঢ়ক, এটা বিশ্লেষিত কপি নহয়, কাৰণ চিহ্নটোৱে সঠিক বাইটসমূহ আৱৰি ৰাখে। পঠোৱা ঘটনাসমূহ হৈছে payment.received, payment.sent, wallet.deployed, আৰু webhook.test; আপোনাৰ ৱালেটলৈ এখন পেমেন্ট হৈছে payment.received। 'এই কলাৰ পেমেন্ট কৰিছে' সেয়া আপুনি ক'ত স্থায়ী কৰে - এটা ডেটাবেছ ৰো, এটা Redis চাবি, এটা একক প্ৰক্ৰিয়াৰ বাবে মেমৰী মানচিত্র - সেয়া আপোনাৰ কল।
ছাৰ্ভাৰটো খোলা আৰু ষ্টেটলেছ। ইয়াক পঢ়ক।
MCP ছাৰ্ভাৰ আৰু requirePayment নিৰ্মাতাৰ Node SDKৰ ওপৰত এটা চিকন পাস-থ্ৰু, কোনো ডেটাবেছ আৰু কোনো ভলিউম নাথাকাকৈ, সেয়া অডিট কৰিবলৈ বিশেষকৈ কিছু নাই - যি হৈছে উদ্দেশ্য। নেটিভ MCP OAuth 2.1 হৈছে এটা পৰিকল্পিত অনুসৰণ; পেষ্ট কৰা চাবি পথ প্ৰথমে পঠিয়ায় কাৰণ ই বিদ্যমান API-চাবি বিশ্বাস মডেল পুনৰ ব্যৱহাৰ কৰে।
github.com/agentcredia/agentcredia-nodeসম্পূৰ্ণ টুল তালিকা, স্কোপসমূহ, আৰু আবাসিত পৰিবেশ URLসমূহ ডক্সসমূহত নথিভুক্ত কৰা হৈছে। পৰীক্ষা কৰাৰ বাবে staging আৰু dev আবাসিত এণ্ডপইণ্টসমূহ উৎপাদনৰ সৈতে একেলগে থাকে যাৰ আগতে আপুনি ইয়াৰ ওপৰত এটা বাস্তৱ চাবি নিৰ্দেশ কৰে।
পাঁচটা MCP-নির্দিষ্ট ফাঁদ যিবোৰ এৰাব লাগে।
এইবোৰ উৎপাদনত পেইড MCP ছাৰ্ভাৰ চলোৱা অপাৰেটৰসকলৰ পৰা আহে। অধিকাংশ কেচ আৰ্হি আৰু MCP প্ৰটোকলৰ নিৰ্দিষ্ট ত্ৰুটিৰ আকাৰৰ সৈতে সম্পর্কিত।
requirePayment হৈছে এটা নিৰ্মাতা, মিডলৱেৰ নহয়
requirePayment হৈছে এটা বিশুদ্ধ ফাংশন: আপুনি ইয়াক কল কৰে, ই { status: 402, body } উলিয়ায়, আৰু আপুনি টুল অব্যৱহৃত থাকোতে সেই শৰীৰটো উলিয়ায়। ই আপোনাৰ হেণ্ডলাৰটো মুড়ি নকৰে, ই কাক পেমেন্ট কৰিছে সেয়া পৰ্যবেক্ষণ নকৰে, আৰু ইয়াত কোনো কাৰণ বা কেচ-উইণ্ডো বিকল্প নাই - মাত্ৰ amountUsdc, payTo, hostedUrl, আৰু এটা ঐচ্ছিক নেটৱৰ্ক আৰু বৰ্ণনা। পেমেন্টৰ অৱস্থা পৰ্যবেক্ষণ কৰা আপোনাৰ কাম: আপোনাৰ ডেটাবেছত এটা ৰো, আপোনাৰ নিজৰ Redis ত এটা চাবি, যি কিছু উপযুক্ত। AgentCredia চেলেঞ্জ নিৰ্মাতা আৰু স্থিৰতা webhook প্ৰেৰণ কৰে, ৰিচিপ্ট কেচ নহয়।
stdio আপোনাৰ চাবি আপোনাৰ মেচিনত ৰাখে
npx আৰু AGENTCREDIA_API_KEYৰ সৈতে পৰিবেশত ছাৰ্ভাৰটো চলাও, আৰু কীৰটো আপোনাৰ বাক্সৰ পৰা কেতিয়াও নাযায় - ই স্থানীয়ভাৱে পঢ়া হয়, নেটৱৰ্ক হেডাৰ হিচাপে পঠিওৱা নহয়। হোস্ট কৰা URLটো বিপৰীত বাণিজ্য: শূন্য ইনষ্টল, কিন্তু আপুনি কীৰটো mcp.agentcredia.comলৈ Bearer টোকেন হিচাপে পেষ্ট কৰে। এজন বিকাশকৰ নিজৰ মেচিনৰ বাবে stdio বাচক, শ্বেয়াৰ কৰা স্থাপনাৰ বাবে হোস্ট কৰা।
ডেছব'ৰ্ড-মাত্ৰ পৃষ্ঠসমূহ প্ৰকাশিত নহয়
ছাৰ্ভাৰটো @agentcredia/node ত এটা চিকন, ষ্টেটলেছ প্ৰক্সি। ই ঠিক পাঁচটা টুল প্ৰকাশ কৰে: get_wallet, list_wallets, get_transaction, send_payment, settle_payment_request। পৰিচয় পৰিৱৰ্তন, API-কী আৰু ৱেবহুক CRUD, তোলনি, আৰু বিলিং API-কী প্ৰমাণীকৰণৰ অধীনত কঠোৰভাৱে ব্লক কৰা হৈছে আৰু ছাৰ্ভাৰটো কেতিয়াও SDKৰ পৰা সিহঁতৰ পৰা অতিক্ৰম নকৰে। সিহঁতৰ বাবে এটা টুলৰ আশা নকৰিব - সিহঁত ডিজাইন অনুসৰি ডেছব'ৰ্ডত থাকে।
send_payment idempotent আৰু পুনৰ চেষ্টা নকৰে
The send_payment tool wraps payments.create: it auto-mints an Idempotency-Key so a retried call collapses to one transfer, and it does not retry on its own. It can also answer 503 until the chain adapter is wired for your network. If the model gets a 503, do not let it hammer the tool - surface the state and move on. amountWei is USDC base units (6 decimals), so 0.01 USDC is the string "10000".
requirePayment ত amountUsdc হৈছে এটা 6-দশমিক ষ্ট্ৰিং
requirePayment validates amountUsdc as a USDC decimal with at most six fractional digits, so "0.10" is fine and "0.1234567" throws. payTo and hostedUrl are required; network defaults to mainnet. Keep the hostedUrl pointing at a real checkout you control (the pattern is https://pay.agentcredia.com/checkout/<id>). A malformed amount fails fast rather than minting a broken challenge.