Add supported payment workflows to MCP.

@agentcredia/mcp సర్వర్ MCP హోస్ట్‌కు ఐదు ఏజెంట్-వాలెట్ సాధనాలను అందిస్తుంది: ఒక వాలెట్‌ను చదవండి, వాలెట్‌లను జాబితా చేయండి, ఒక లావాదేవీని తనిఖీ చేయండి, USDC చెల్లింపును పంపండి, మరియు x402 ఇన్వాయిస్‌ను కుదించండి. దీన్ని npx @agentcredia/mcp తో నడపండి (మీ కీ మీ యంత్రంలోనే ఉంటుంది) లేదా హోస్టెడ్ URL కు సూచించండి. వేరుగా, ప్యాకేజీ requirePayment ను ఎగుమతి చేస్తుంది కాబట్టి మీరు మీ స్వంత MCP సాధనాలపై x402 402 ఛాలెంజ్‌తో ధరను ఉంచవచ్చు.

దీనిని నడిపించడానికి రెండు మార్గాలు. హోస్టెడ్ కోసం ఇన్‌స్టాల్ లేదు.

దాన్ని స్థానికంగా stdio ద్వారా npx తో నడపండి (మీ కీ మీ యంత్రంలోనే ఉంటుంది), లేదా ఏ MCP హోస్ట్ను హోస్టెడ్ స్ట్రీమబుల్ HTTP URL కు సూచించండి మరియు కీని బేరర్ టోకెన్‌గా పంపండి. రెండూ హోస్ట్ యొక్క 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 అనేది మీ dashboard నుండి వచ్చిన sk_test_ testnet లేదా sk_live_ mainnet key; AGENTCREDIA_API_BASE_URL యొక్క default https://api.agentcredia.com. Server మీ key ను backend కు forward చేస్తుంది మరియు ఏమీ store చేయదు, కాబట్టి ఆ key పై scope మరియు caps agent చేయగల పనిని ఖచ్చితంగా నిర్ణయిస్తాయి. ఇది expose చేసే ఐదు tools: get_wallet, list_wallets, get_transaction, send_payment, మరియు settle_payment_request.

వెబ్‌హుక్ ల్యాండింగ్ అయినప్పుడు కాలర్ చెల్లించినట్లు గుర్తించండి.

ఒక చెల్లింపు స్థిరమైనప్పుడు, 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. 'ఈ పిలువువాడు చెల్లించాడు'ని మీరు నిలుపుకుంటే - డేటాబేస్ పంక్తి, రెడిస్ కీ, ఒకే ప్రక్రియ కోసం మెమరీలో మ్యాప్ - అది మీ పిలుపు.

గమనించాల్సిన ఐదు MCP-సంబంధిత చిక్కులు.

ఇవి ఉత్పత్తిలో చెల్లించిన MCP సర్వర్లను నడుపుతున్న ఆపరేటర్ల నుండి వస్తాయి. ఎక్కువగా కాష్ నిర్మాణం మరియు MCP ప్రోటోకాల్ యొక్క ప్రత్యేక దోష ఫార్మాట్‌కు సంబంధించి ఉన్నాయి.