RevClamp MCP Server
Zero-take-rate Stripe 2025-03-31.basil, Visa CE 3.0 & EU/UK VIES VAT guardrails MCP server.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http revclamp-mcp-server 'https://api.revclamp.com/api/mcp'
{
"mcpServers": {
"revclamp-mcp-server": {
"type": "http",
"url": "https://api.revclamp.com/api/mcp"
}
}
}
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
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 Name | Domain | Primary Capability | Mode |
|---|---|---|---|
revclamp_audit_revenue_leakage | Stripe Billing & Usage | Runs a 90-day B2B revenue leakage and dispute readiness audit across subscriptions, usage events, and disputes | Stateless Sandbox or Workspace Key |
revclamp_evaluate_ghost_usage | Stripe 2025-03-31.basil | Evaluates multi-subscription customer snapshots (has_more: false enforced) and 0–14d dunning grace windows for unpaid API/LLM bleed | Stateless Sandbox or Workspace Key |
revclamp_stage_stripe_dispute_ce3 | Visa 10.4 / CE 3.0 | Evaluates 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_vies | EU & XI B2B VAT | Normalizes 27 EU member states + Northern Ireland (XI) VAT IDs (GR -> EL) and evaluates VIES HTTP 200 errorWrappers holds | Stateless Sandbox or Workspace Key |
revclamp_reconcile_b2b_net_terms | B2B Wholesale Net-30 | Reconciles Net-15/30/60 upfront deposits and credit notes using integer EUR-cent accounting | Stateless Sandbox or Workspace Key |
revclamp_verify_webhook_signature | Webhook HMAC-SHA256 | Generates and verifies Stripe-Signature, X-Shopify-Hmac-Sha256, and X-RevClamp-Signature over raw UTF-8 bytes with 300s replay checks | Stateless Sandbox or Workspace Key |
revclamp_calculate_roi_and_plan_fit | 0% Take-Rate ROI & Plan Fit | Calculates monthly and annual B2B margin savings in integer USD cents vs. 25%–30% chargeback agencies and recommends the optimal tier | Stateless Sandbox or Workspace Key |
revclamp_simulate_webhook_replay | Webhook Replay & FSM | Simulates 1–10 subscription lifecycle webhooks against a 72h deduplication Set and monotonic createdSec guard vs. naive arrival-order handlers | Stateless Sandbox or Workspace Key |
revclamp_lint_dispute_evidence | Dispute Evidence UTF-16 & CE 3.0 | Lints 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 qualification | Stateless 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
- Engineering Post-Mortem #1: Stripe's
basilAPI broke my grace-period logic, and CE 3.0 turned out to be a routing problem - Engineering Post-Mortem #7: Visa CE 3.0
18,000UTF-16 Code Unit Evidence Truncation & Non-Destructive Staging - Interactive Tools (No Signup):
2. EU VIES HTTP 200 OK Soft-Failure Circuit Breaker & B2B Net-Terms Reconciliation
- Engineering Post-Mortem #2: VIES returns
HTTP 200when it's down, and I charged the wrong VAT because of it - Engineering Post-Mortem #3: Shopify Plus B2B Net-15/30/60 Integer-Cent Deposit & Credit-Note Reconciliation
- Interactive Tools (No Signup):
3. Webhook HMAC-SHA256 Raw-Body Security, 72h Replay FSM & 0% Take-Rate ROI
- Engineering Post-Mortem #4: Why Stripe and Shopify Webhook HMAC-SHA256 Verification Fails on Parsed JSON Bodies
- Engineering Post-Mortem #5: Chargeback Contingency Fees (25%) vs. Flat-Rate 0% Commission Automation
- Engineering Post-Mortem #6: Webhook Idempotency & Out-of-Order Subscription State Machines
- Interactive Tools (No Signup):
Security & Resource Bounds
- Strict Origin Pinning: Only connects to
https://api.revclamp.com/api/mcporhttps://revclamp.com/api/mcpover TLS (redirect: "error"). Rejects non-HTTPS protocols, embedded credentials, and untrusted origins. - Bounded Execution: Enforces a hard
10,000msrequest timeout (AbortSignal.timeout) and a32,768-byte request/response payload cap. - Full LLM Reference:
https://revclamp.com/llms-full.txt
License
MIT © RevClamp Enterprise
Frequently asked questions
What is RevClamp MCP Server?
Zero-take-rate Stripe 2025-03-31.basil, Visa CE 3.0 & EU/UK VIES VAT guardrails MCP server.
How do I install RevClamp MCP Server?
It runs as a remote server. In Claude Code: claude mcp add --transport http revclamp-mcp-server 'https://api.revclamp.com/api/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does RevClamp MCP Server need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is RevClamp MCP Server open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains RevClamp MCP Server?
It is published by revclamp. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.