Add supported payment workflows to MCP.

@agentcredia/mcp சர்வர் ஒரு MCP ஹோஸ்டுக்கு ஐந்து முகவர்-பணம் கருவிகளை வழங்குகிறது: ஒரு பணத்தைப் படிக்கவும், பணங்களைப் பட்டியலிடவும், ஒரு பரிவர்த்தனையைச் சரிபார்க்கவும், USDC கட்டணத்தை அனுப்பவும், மற்றும் x402 பில்லைக் கட்டுப்படுத்தவும். npx @agentcredia/mcp மூலம் அதை இயக்கவும் (உங்கள் விசை உங்கள் இயந்திரத்தில் இருக்கும்) அல்லது வழங்கப்பட்ட URL க்கு குறிக்கவும். தனியாக, தொகுப்பு requirePayment ஐ ஏற்றுகிறது, எனவே நீங்கள் உங்கள் சொந்த MCP கருவிகளில் x402 402 சவாலுடன் ஒரு விலை வைக்கலாம்.

இதை இயக்க இரண்டு வழிகள். ஹோஸ்ட் செய்யப்பட்ட ஒன்றுக்கு எந்த நிறுவலும் இல்லை.

நீங்கள் npx உடன் உள்ளூர் stdio இல் அதை இயக்குங்கள் (உங்கள் விசை உங்கள் இயந்திரத்தில் இருக்கும்), அல்லது எந்த 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_ testnet அல்லது sk_live_ mainnet விசை; AGENTCREDIA_API_BASE_URL https://api.agentcredia.com இல் இயல்பாக உள்ளது. சேவையகம் உங்கள் விசையை பின்னணி நோக்கி அனுப்புகிறது மற்றும் எதையும் சேமிக்கவில்லை, எனவே அந்த விசையின் வரம்பு மற்றும் கட்டுப்பாடுகள் முகவர் என்ன செய்யலாம் என்பதற்கேற்பவே இருக்கின்றன. இது வெளிப்படுத்தும் ஐந்து கருவிகள்: 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-ஐ constant time-இல் செய்கிறது மற்றும் ஒரு discriminated union-ஐ return செய்கிறது, ஆகவே try/catch இல்லாமல் result.ok-ஐ வைத்து branch செய்யலாம். parsed copy அல்ல, raw body-ஐ படிக்கவும், ஏனெனில் signature துல்லியமான bytes-ஐ காப்பாற்றுகிறது. வழங்கப்பட்ட events payment.received, payment.sent, wallet.deployed, மற்றும் webhook.test; உங்கள் wallet-க்கு வரும் payment என்பது payment.received. 'this caller paid' என்பதை எங்கு persist செய்வது - database row, Redis key, single process-க்கு in-memory map - என்பது உங்கள் முடிவு.

தவிர்க்க வேண்டிய ஐந்து MCP-சிறப்பு சிக்கல்கள்.

இவை உற்பத்தியில் கட்டண MCP சேவையகங்களை இயக்கும் இயக்குநர்களிடமிருந்து வருகின்றன. பெரும்பாலானவை கச்சா கட்டமைப்பு மற்றும் MCP நெறிமுறையின் குறிப்பிட்ட பிழை வடிவத்துடன் தொடர்புடையவை.