English Français العربية

RevClamp MCP Server

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

Zero-take-rate Stripe 2025-03-31.basil, Visa CE 3.0 & EU/UK VIES VAT guardrails MCP server.

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

التثبيت

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

Remote (streamable-http)
Claude Code 
claude mcp add --transport http revclamp-mcp-server 'https://api.revclamp.com/api/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "revclamp-mcp-server": {
            "type": "http",
            "url": "https://api.revclamp.com/api/mcp"
        }
    }
}

التوثيق

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

المحتويات
  1. RevClamp MCP Server & CLI (revclamp-mcp)
  2. Exposed MCP Tools (9)
  3. Quick Start (Claude Desktop / Cursor / Windsurf)
  4. CLI Usage
  5. Architecture & Engineering Deep-Dives (7 Post-Mortems & 8 Interactive Browser Tools)
  6. Security & Resource Bounds
  7. License

RevClamp MCP Server & CLI (revclamp-mcp)

revclamp-mcp is the official Model Context Protocol (MCP) stdio bridge and CLI diagnostic client for **RevClamp Enterprise**. It connects Claude Desktop, Cursor, Windsurf, Cline, and CI pipelines to RevClamp's Streamable HTTP MCP endpoint (POST https://api.revclamp.com/api/mcp) with zero external npm dependencies.

Exposed MCP Tools (9)

Tool NameDomainPrimary CapabilityMode
revclamp_audit_revenue_leakageStripe Billing & UsageRuns a 90-day B2B revenue leakage and dispute readiness audit across subscriptions, usage events, and disputesStateless Sandbox or Workspace Key
revclamp_evaluate_ghost_usageStripe 2025-03-31.basilEvaluates multi-subscription customer snapshots (has_more: false enforced) and 0–14d dunning grace windows for unpaid API/LLM bleedStateless Sandbox or Workspace Key
revclamp_stage_stripe_dispute_ce3Visa 10.4 / CE 3.0Evaluates 120d–365d prior undisputed charges (ip_subnet/device_id overlap) and stages a submit: false draft (<= 18,000 UTF-16 code units)Stateless Sandbox or Workspace Key
revclamp_validate_eu_vat_viesEU & XI B2B VATNormalizes 27 EU member states + Northern Ireland (XI) VAT IDs (GR -> EL) and evaluates VIES HTTP 200 errorWrappers holdsStateless Sandbox or Workspace Key
revclamp_reconcile_b2b_net_termsB2B Wholesale Net-30Reconciles Net-15/30/60 upfront deposits and credit notes using integer EUR-cent accountingStateless Sandbox or Workspace Key
revclamp_verify_webhook_signatureWebhook HMAC-SHA256Generates and verifies Stripe-Signature, X-Shopify-Hmac-Sha256, and X-RevClamp-Signature over raw UTF-8 bytes with 300s replay checksStateless Sandbox or Workspace Key
revclamp_calculate_roi_and_plan_fit0% Take-Rate ROI & Plan FitCalculates monthly and annual B2B margin savings in integer USD cents vs. 25%–30% chargeback agencies and recommends the optimal tierStateless Sandbox or Workspace Key
revclamp_simulate_webhook_replayWebhook Replay & FSMSimulates 1–10 subscription lifecycle webhooks against a 72h deduplication Set and monotonic createdSec guard vs. naive arrival-order handlersStateless Sandbox or Workspace Key
revclamp_lint_dispute_evidenceDispute Evidence UTF-16 & CE 3.0Lints evidence[access_activity_log] payloads against the 18,000 UTF-16 code unit ceiling, non-destructive CE 3.0 markers, merchant note preservation, and CE 3.0 prior-charge qualificationStateless Sandbox or Workspace Key

Quick Start (Claude Desktop / Cursor / Windsurf)

Add revclamp-mcp to your claude_desktop_config.json or .cursor/mcp.json. Omit REVCLAMP_API_KEY to run in Stateless Sandbox Mode (zero database writes), or pass your rg_live_... workspace key from https://revclamp.com/dashboard:

{
  "mcpServers": {
    "revclamp": {
      "command": "npx",
      "args": ["-y", "github:revclamp/revclamp-mcp"],
      "env": {
        "REVCLAMP_API_KEY": "rg_live_YOUR_WORKSPACE_KEY"
      }
    }
  }
}

Or connect directly via Streamable HTTP (JSON-RPC 2.0) without installing a local binary:

curl -sS -X POST https://api.revclamp.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

CLI Usage

# List all 9 MCP tools and JSON schemas
node index.mjs --list-tools

# Validate an EU or Northern Ireland (XI) B2B VAT ID (auto-converts Greece GR -> EL)
node index.mjs --check-vat GR123456789 DE

# Calculate 0% take-rate ROI and optimal flat-rate plan fit
node index.mjs --calc-roi 10000 600 25 250000

# Simulate out-of-order webhook replay and 72-hour deduplication state machine
node index.mjs --sim-replay out_of_order_stale_update_after_cancel

# Lint Stripe dispute evidence UTF-16 code units and non-destructive CE 3.0 markers
node index.mjs --lint-evidence valid_ce3_non_destructive

# Verify webhook HMAC-SHA256 using REVCLAMP_WEBHOOK_SECRET from environment
REVCLAMP_WEBHOOK_SECRET="whsec_test_secret_revclamp_sandbox_2026" node index.mjs --verify-webhook stripe

# Invoke Visa CE 3.0 readiness staging in Stateless Sandbox mode
node index.mjs --call revclamp_stage_stripe_dispute_ce3 '{"disputeId":"du_1Qxyz01","customerId":"cus_ent_88","disputeReason":"fraudulent"}'

Architecture & Engineering Deep-Dives (7 Post-Mortems & 8 Interactive Browser Tools)

1. Stripe 2025-03-31.basil Entitlement Guard & Visa CE 3.0 Two-Tier Routing

2. EU VIES HTTP 200 OK Soft-Failure Circuit Breaker & B2B Net-Terms Reconciliation

3. Webhook HMAC-SHA256 Raw-Body Security, 72h Replay FSM & 0% Take-Rate ROI

Security & Resource Bounds

  • Strict Origin Pinning: Only connects to https://api.revclamp.com/api/mcp or https://revclamp.com/api/mcp over TLS (redirect: "error"). Rejects non-HTTPS protocols, embedded credentials, and untrusted origins.
  • Bounded Execution: Enforces a hard 10,000ms request timeout (AbortSignal.timeout) and a 32,768-byte request/response payload cap.
  • Full LLM Reference: https://revclamp.com/llms-full.txt

License

MIT © RevClamp Enterprise

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

ما هو RevClamp MCP Server؟

Zero-take-rate Stripe 2025-03-31.basil, Visa CE 3.0 & EU/UK VIES VAT guardrails MCP server.

كيف أثبّت RevClamp MCP Server؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http revclamp-mcp-server 'https://api.revclamp.com/api/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج RevClamp MCP Server إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل RevClamp MCP Server مفتوح المصدر؟

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

من يصون RevClamp MCP Server؟

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

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