English Français العربية

io.github.Evozim/m2mcent

السجل الرسمي المالية والمدفوعات

x402 payment wrapper for AI Agents and MCP Servers. USDC settlements on Base L2.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package m2mcent-sdk
Claude Code 
claude mcp add m2mcent -e 'BASE_RPC_URL=<BASE_RPC_URL>' -e 'RELAYER_PRIVATE_KEY=<your relayer_private_key>' -e 'TREASURY_ADDRESS=<TREASURY_ADDRESS>' -- npx -y m2mcent-sdk@1.0.5
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "m2mcent": {
            "command": "npx",
            "args": [
                "-y",
                "m2mcent-sdk@1.0.5"
            ],
            "env": {
                "BASE_RPC_URL": "<BASE_RPC_URL>",
                "RELAYER_PRIVATE_KEY": "<your relayer_private_key>",
                "TREASURY_ADDRESS": "<TREASURY_ADDRESS>"
            }
        }
    }
}

متغيرات البيئة

  • BASE_RPC_URL إلزامي Base Mainnet RPC endpoint URL
  • RELAYER_PRIVATE_KEY إلزامي سري Relayer wallet private key for on-chain settlement
  • TREASURY_ADDRESS إلزامي Treasury wallet address to receive payments

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. 🛰️ M2MCent SDK — x402 Payment Wrapper for AI Agents
  2. 🚀 Quick Start
  3. 📐 How It Works
  4. ⚙️ Configuration
  5. 🔒 Security
  6. 🌐 Network Details
  7. 🧩 MCP Server Integration
  8. 📊 Ecosystem
  9. 📄 License

🛰️ M2MCent SDK — x402 Payment Wrapper for AI Agents

Ultra-lightweight x402 payment interceptor for AI Agents and MCP Servers. Monetize any API in 3 lines of code.

🚀 Quick Start

npm install m2mcent-sdk
import { X402Handler } from 'm2mcent-sdk';

const x402 = new X402Handler({
  rpcUrl: 'https://mainnet.base.org',
  privateKey: process.env.RELAYER_PRIVATE_KEY!,
  recipient: process.env.TREASURY_ADDRESS!
});

// Protect any Express endpoint with a USDC paywall
app.post('/api/analyze', x402.requirePayment("100000"), (req, res) => {
  res.json({ result: "Premium analysis complete", receipt: req.paymentTx });
});

📐 How It Works

M2MCent implements the x402 Payment Protocol — a machine-native payment standard inspired by HTTP 402:

  1. Agent requests a protected endpoint
  2. Server responds with 402 Payment Required + payment metadata (Base64 encoded)
  3. Agent signs an EIP-712 typed data authorization (gasless for the payer)
  4. Server settles atomically on-chain via the M2MCent Escrow contract
  5. Agent receives the premium response + transaction receipt
Agent ──► API Server ──► 402 + metadata
Agent ◄── signs EIP-712 authorization
Agent ──► API Server + Payment-Signature header
          └──► Escrow.settle() on Base L2
Agent ◄── Premium Response + tx hash

⚙️ Configuration

ParameterDescriptionRequired
rpcUrlBase Mainnet RPC endpoint✅
privateKeyRelayer wallet private key (for settlement)✅
recipientTreasury address to receive payments✅

🔒 Security

  • Non-custodial: Funds flow directly from payer → treasury via on-chain escrow
  • Gasless for payers: Uses EIP-3009 transferWithAuthorization (USDC native)
  • Zero-Leak: No agent data is retained after settlement
  • Atomic: Payment and service delivery happen in a single request cycle

🌐 Network Details

ParameterValue
NetworkBase Mainnet (Chain ID: 8453)
USDC Contract0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
Escrow Contract0xf3c3416A843d13C944554A54Ac274BB7fF264BcC
SettlementAtomic, sub-second finality

🧩 MCP Server Integration

Perfect for Model Context Protocol servers:

import express from 'express';
import { X402Handler } from 'm2mcent-sdk';

const app = express();
const x402 = new X402Handler({
  rpcUrl: process.env.BASE_RPC_URL!,
  privateKey: process.env.RELAYER_PRIVATE_KEY!,
  recipient: process.env.TREASURY_ADDRESS!
});

// Any MCP tool endpoint becomes monetizable
app.post('/api/tools/analyze', x402.requirePayment("50000"), async (req, res) => {
  const result = await runMCPTool(req.body);
  res.json({ ...result, paymentTx: req.paymentTx });
});

📊 Ecosystem

M2MCent powers 100+ production MCP servers on Base Mainnet, processing real USDC micro-payments for AI-to-AI commerce.

📄 License

MIT © M2MCent

الأسئلة الشائعة

ما هو io.github.Evozim/m2mcent؟

x402 payment wrapper for AI Agents and MCP Servers. USDC settlements on Base L2.

كيف أثبّت io.github.Evozim/m2mcent؟

يعمل على جهازك. في Claude Code: claude mcp add m2mcent -e 'BASE_RPC_URL=<BASE_RPC_URL>' -e 'RELAYER_PRIVATE_KEY=<your relayer_private_key>' -e 'TREASURY_ADDRESS=<TREASURY_ADDRESS>' -- npx -y m2mcent-sdk@1.0.5. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.Evozim/m2mcent إلى مفتاح API؟

نعم. يتطلب BASE_RPC_URL, RELAYER_PRIVATE_KEY, TREASURY_ADDRESS، وتضبطها في إعداداته.

هل io.github.Evozim/m2mcent مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.Evozim/m2mcent؟

ينشره Evozim. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.