RevClamp MCP Server
RevClamp MCP Server provides 9 local-first, deterministic B2B FinOps and compliance tools for Stripe, Shopify Plus, EU VAT, Visa CE 3.0, webhook security, and ROI analysis, with optional hosted Cloud workspace sync.
Audit Stripe revenue leakage and Visa CE 3.0 readiness across subscriptions, usage events, and disputes.
Detect ghost usage and post-cancellation billing under Stripe 2025-03-31.basil.
Stage non-destructive Visa CE 3.0 dispute evidence drafts with 18,000 UTF-16 code unit limits.
Validate and normalize EU/XI B2B VAT IDs, including Greece GR→EL, with optional live VIES mode.
Reconcile Shopify Plus B2B Net-15/30/60 invoices, deposits, and credit notes using integer-cent accounting.
Generate and verify Stripe, Shopify, and RevClamp webhook HMAC-SHA256 signatures with replay protection.
Calculate 0% take-rate ROI and recommend plan fit versus 25%–30% chargeback agencies.
Simulate webhook replay, deduplication, and out-of-order subscription state machines.
Lint Stripe dispute evidence for UTF-16 limits, CE 3.0 markers, and merchant note preservation.
Run fully locally with zero API keys/network by default, or optionally sync to RevClamp Cloud with REVCLAMP_API_KEY.
Provides tools for auditing Stripe Billing and usage data, evaluating multi-subscription customer snapshots and dunning grace periods, and assessing/staging Stripe dispute evidence aligned with Visa CE 3.0 readiness.
Provides Visa CE 3.0 dispute-readiness capabilities, including evaluating prior undisputed charges and staging a non-submitting draft for dispute evidence review.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@RevClamp MCP Server validate EU VAT ID GR123456789 in VIES"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
RevClamp MCP Server & CLI (revclamp-mcp)

revclamp-mcp is a standalone, zero-dependency Open-Source Model Context Protocol (MCP) Server & CLI (index.mjs + local_engine.mjs) implementing 9 deterministic B2B FinOps, Stripe 2025-03-31.basil, Visa CE 3.0, EU/XI VIES VAT, Shopify Plus B2B Net-15/30/60, and Webhook Security tools in pure Node.js.
100% Local In-Process Execution (Default — Zero Network / Zero API Key Required): All 9 MCP tools (
initialize,tools/list, andtools/call) execute locally in-process insidelocal_engine.mjsusing pure Node.js (node:cryptoHMAC-SHA256 verification, integer-cent double-entry accounting, 72-hour webhook replay state machines, and18,000UTF-16 code unit CE 3.0 linting). Zero network calls are ever made unlessREVCLAMP_API_KEYorREVCLAMP_MCP_URLis explicitly configured.Optional Hosted Cloud Workspace Sync (
REVCLAMP_API_KEY): WhenREVCLAMP_API_KEY(rg_live_...) is configured,revclamp-mcpconnects to RevClamp Enterprise (https://api.revclamp.com/api/mcp) to unlock the 90-day durable transactional usage & audit ledger, 24/7 autonomous Stripe dispute & entitlement webhook outbox, and real-time EU Commission VIES SOAP gateway consultation numbers.Flat-JSON REST, OpenAPI 3.0.3 & RapidAPI Hub Gateway (Clay.com / n8n / Make.com): In addition to MCP stdio/HTTP, all 9 deterministic tools plus B2B Domain Tech Stack & Payment Rail Intelligence (
POST /api/v1/b2b/domain-intelligence) are available as flat-JSON REST endpoints viahttps://revclamp.com/openapi.json,https://revclamp.com/api/v1/integrations/templates, and the RapidAPI Hub Gateway.
Local Open-Core (local_engine.mjs) vs. Hosted Cloud (REVCLAMP_API_KEY)
Capability | Local Open-Core Default (Zero API Key) | Hosted Cloud ( |
Execution & Network | 100% in-process ( | HTTPS JSON-RPC to |
Usage & Audit Storage | Stateless evaluation of caller-supplied JSON snapshots | Persistent 90-day durable transactional ledger + Stripe historical backfill |
Dispute & Entitlement Action | Returns non-destructive | 24/7 autonomous Stripe webhook outbox ( |
EU & | Deterministic syntax & | Live EU Commission VIES SOAP consultation IDs + circuit-breaker retry queue ( |
Monthly Event Tiers | Unlimited local in-process evaluations (0 network cost) | Free Sandbox ( |
Data Minimization & Privacy | Nothing ever leaves your machine | Only explicit |
Related MCP server: week7-mcp-server
Open-Source MCP Tools Implemented in local_engine.mjs (9)
Tool Name | Domain | Local In-Process Implementation ( | Execution Mode |
| Stripe Billing & Usage | Evaluates caller-supplied customer/usage arrays ( | Local In-Process (or Optional Cloud Key) |
| Stripe | Evaluates multi-subscription customer snapshots ( | Local In-Process (or Optional Cloud Key) |
| Visa 10.4 / CE 3.0 | Evaluates 120d–365d prior undisputed charges ( | Local In-Process (or Optional Cloud Key) |
| EU & | Normalizes 27 EU member states + Northern Ireland ( | Local In-Process (or Optional Live VIES) |
| B2B Wholesale Net-Terms | Reconciles Net-15/30/60 and custom 1–180d upfront deposits and credit notes using integer EUR-cent double-entry accounting | Local In-Process (or Optional Cloud Key) |
| Webhook HMAC-SHA256 | Generates and verifies | Local In-Process (or Optional Cloud Key) |
| 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 | Local In-Process (or Optional Cloud Key) |
| Webhook Replay & FSM | Simulates subscription lifecycle webhooks against a 72h deduplication | Local In-Process (or Optional Cloud Key) |
| Dispute Evidence UTF-16 & CE 3.0 | Lints | Local In-Process (or Optional Cloud Key) |
Quick Start (Claude Desktop / Cursor / Windsurf)
Add revclamp-mcp to your claude_desktop_config.json or .cursor/mcp.json. By default, revclamp-mcp runs 100% locally in-process with zero network calls and zero API keys required:
{
"mcpServers": {
"revclamp": {
"command": "npx",
"args": ["-y", "github:lhphong09t2/revclamp-mcp"]
}
}
}(Optional) To connect to a live workspace on https://revclamp.com/dashboard, pass REVCLAMP_API_KEY in env or use the hosted Streamable HTTP endpoint (POST https://api.revclamp.com/api/mcp):
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 & <60s Local Smoke Check (--self-test)
# Run a <60s local CLI smoke check (verifies all 9 tool schemas & executes a local_engine.mjs sample audit with zero API key)
npx -y github:lhphong09t2/revclamp-mcp#v1.20.34 --self-test
# Provision a free Cloud Workspace instantly (zero email required; saves to ~/.revclamp/credentials.json) or bind a work email via 6-digit OTP
npx -y revclamp-mcp@1.20.34 --init-workspace
npx -y revclamp-mcp@1.20.34 --init-workspace you@company.com
# Verify the 6-digit OTP using REVCLAMP_API_KEY from environment
REVCLAMP_API_KEY="rg_live_..." npx -y revclamp-mcp@1.20.34 --verify-otp you@company.com 123456
# List all 9 MCP tools and JSON schemas (runs locally in-process)
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 (runs locally in-process)
node index.mjs --calc-roi 10000 600 25 250000
# Simulate out-of-order webhook replay and 72-hour deduplication state machine (runs locally)
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 (runs locally)
node index.mjs --lint-evidence valid_ce3_non_destructive
# Verify webhook HMAC-SHA256 using REVCLAMP_WEBHOOK_SECRET from environment (runs locally)
REVCLAMP_WEBHOOK_SECRET="whsec_test_secret_revclamp_sandbox_2026" node index.mjs --verify-webhook stripe
# Invoke Visa CE 3.0 readiness staging locally (pass demo: true for synthetic sample or usageEvents for real logs)
node index.mjs --call revclamp_stage_stripe_dispute_ce3 '{"disputeId":"du_1Qxyz01","customerId":"cus_ent_88","disputeReason":"fraudulent","demo":true}'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 problemEngineering Post-Mortem #7: Visa CE 3.0
18,000UTF-16 Code Unit Evidence Truncation & Non-Destructive StagingInteractive 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 itEngineering 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%–30%) vs. Flat-Rate 0% Commission Automation
Engineering Post-Mortem #6: Webhook Idempotency & Out-of-Order Subscription State Machines
Interactive Tools (No Signup):
Golden Trio B2B Intelligence Companion MCP Suite
Companion MCP Server & Apify Actor | Primary B2B Intelligence Signal | Local MCP Stdio Command | Apify Store & npm |
RevClamp AdPulse ( | Zero-browser Google Ads Transparency Center ( |
| |
RevClamp TalentPulse ( | Zero-browser 5-in-1 B2B ATS Job & Hiring Signal Feed across Greenhouse, Workday CXS, Ashby, Lever, and SmartRecruiters |
| |
RevClamp ContactPulse ( | Zero-browser B2B Domain Contact, RFC 9116 |
|
Continuous Daily Hiring Diff Monitoring (search_ats_job_postings / resolve_company_ats_board + /api/v1/b2b/ats-watchlist + n8n-nodes-revclamp)
Point-in-Time Discovery (
search_ats_job_postings&resolve_company_ats_boardin@revclamp/unified-ats-jobs-mcp/POST /api/v1/b2b/ats-jobs): Resolves any company domain or career page URL across Greenhouse, Ashby, Lever, SmartRecruiters, and Workday into normalized job postings and hiring velocity metrics.Stateful Daily Diff Watchlist (
/api/v1/b2b/ats-watchlist): Pairs withsearch_ats_job_postingsandresolve_company_ats_boardto persist canonical board snapshots (50-to-1 deduplicated upstream polling) and emit structured dailyJOB_OPENED,COMPENSATION_UPDATED, andJOB_CLOSEDdiffs via/api/v1/b2b/ats-watchlist/preview-diff,/api/v1/b2b/ats-watchlist/sync, and/api/v1/b2b/ats-watchlist/events. Try the interactive browser sandbox athttps://revclamp.com/tools/ats-hiring-watchlist.Official n8n Community Nodes (
n8n-nodes-revclamp): Installn8n-nodes-revclamp(RevClampHiringWatchlistAction node +RevClampHiringWatchlistTriggerPolling Trigger node) to trigger automated outbound, recruiting, and CRM enrichment workflows whenever target accounts open new roles or raise salary bands.
Security & Resource Bounds
Local-First Deterministic Execution: Runs all 9 tools locally in-process inside
local_engine.mjswith zero external npm dependencies.Strict Origin Pinning (Cloud Mode): When
REVCLAMP_API_KEYis provided, only connects tohttps://api.revclamp.com/api/mcporhttps://revclamp.com/api/mcpover TLS (redirect: "error").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
Available Tools
9 toolsrevclamp_audit_revenue_leakageCInspect
Runs a deterministic 90-day B2B revenue leakage and Visa CE 3.0 readiness audit across caller-supplied Stripe subscriptions (2025-03-31.basil item-level periods), usage events, and disputes.
Inputs: demo, disputes, customers, usageEvents, +2 more.
revclamp_calculate_roi_and_plan_fitCInspect
Calculates monthly and annual B2B margin savings in integer USD cents comparing 0% take-rate flat pricing against 25%-30% chargeback contingency agencies and recommends the optimal tier.
Inputs: demo, monthlyUsageEvents, monthlyGhostBleedUsd, monthlyWonDisputeUsd, +1 more.
revclamp_evaluate_ghost_usageBInspect
Evaluates whether a metered API/SaaS usage event belongs to an entitled customer or represents post-cancellation / post-grace ghost usage under Stripe 2025-03-31.basil.
Inputs: demo, timestamp, customerId, occurredAt, +14 more.
revclamp_lint_dispute_evidenceBInspect
Lints Stripe dispute evidence[access_activity_log] payloads against the 18,000 UTF-16 code unit ceiling, non-destructive RevClamp CE 3.0 block markers, merchant note preservation, 17,922/17,920-char fixed wrapper capacity threshold (SKIP_POST_PRESERVE_DRAFT), and Visa CE 3.0 two-identifier overlap.
Inputs: demo, preset, hasIpMatch, hasDeviceMatch, +6 more.
revclamp_reconcile_b2b_net_termsCInspect
Reconciles Shopify Plus B2B Net-15/30/60 (and custom 1..180-day) wholesale invoices, upfront deposits, credit notes, and rounding tolerances using integer EUR-cent double-entry accounting.
Inputs: demo, orderId, toleranceCents, creditNoteCents, +9 more.
revclamp_simulate_webhook_replayBInspect
Simulates out-of-order and duplicate subscription lifecycle webhooks against a 72-hour deduplication Set and monotonic createdSec watermark vs. a naive arrival-order handler.
Inputs: demo, events, nowSec, scenarioPreset, +1 more.
revclamp_stage_stripe_dispute_ce3CInspect
Evaluates Visa Compelling Evidence 3.0 (CE 3.0) 120d-365d historical footprint overlap (IP / device_id) and builds a non-destructive access_activity_log draft (<= 18,000 UTF-16 code units, submit: false).
Inputs: demo, disputeId, customerId, usageEvents, +5 more.
revclamp_validate_eu_vat_viesBInspect
Normalizes 27 EU member states + Northern Ireland (XI) B2B VAT IDs (auto-converting Greece GR -> EL) and checks cross-border reverse-charge format eligibility locally (or simulates VIES states when demo: true).
Inputs: demo, viesMode, buyerVatId, supplyType, +2 more.
revclamp_verify_webhook_signatureBInspect
Generates and verifies raw-UTF8 HMAC-SHA256 webhook signatures for Stripe (Stripe-Signature t=,v1=), Shopify (X-Shopify-Hmac-Sha256 base64), and RevClamp (X-RevClamp-Signature) with 300s timestamp replay protection.
Inputs: demo, secret, secrets, provider, +4 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Most tools target clearly distinct operations: ghost-usage evaluation, 90-day leakage auditing, ROI comparison, VAT validation, net-terms reconciliation, webhook simulation, and signature verification. The main overlap is between lint_dispute_evidence and stage_stripe_dispute_ce3, which both deal with Stripe/Visa CE 3.0 access_activity_log evidence, though their lint-vs-build roles are described.
All tools use the revclamp_ prefix followed by a snake_case verb_noun pattern such as audit_revenue_leakage, validate_eu_vat_vies, and verify_webhook_signature. The convention is highly predictable despite some longer noun phrases.
Nine tools is a well-scoped count for a specialized revenue-assurance, dispute-evidence, webhook, VAT, and reconciliation toolkit. Each tool appears to earn its place by covering a distinct audit or validation operation.
The surface covers a broad set of RevClamp workflows: usage entitlement, revenue leakage audit, ROI planning, dispute evidence linting/staging, B2B net terms, webhook replay/signature checks, and EU VAT validation. Minor gaps remain around full dispute lifecycle submission and broader tax/evidence workflows, but core audit and validation paths are represented.
Maintenance
Related MCP Connectors
A paid remote MCP for CLI tool MCP, built to return verdicts, receipts, usage logs, and audit-ready
A paid remote MCP for Skybridge, built to return verdicts, receipts, usage logs, and audit-ready JSO
A paid remote MCP for hosted MCP server, built to return verdicts, receipts, usage logs, and audit-r
Remote MCP utilities for agents: structured data, commerce checks, and x402 paid API discovery.
Related MCP Servers
- AlicenseAqualityBmaintenanceZero-dependency stdio bridge to Moltline Studio's fleet of 14 hosted MCP servers covering code review, time operations, data transforms, business ops, education, research, outreach and more. Free tier requires no registration; premium tools unlock with a license. Independently audited, MCPize Verified A.10MIT
- FlicenseNot gradedqualityDmaintenanceEnables MCP-compatible clients to retrieve invoice and purchase order data live over stdio through tools for listing invoices, getting invoice details, and fetching purchase orders.-
- AlicenseNot gradedqualityCmaintenanceEnables MCP clients to run eight data tools over stdio for product search, ad transparency, company intent, job/ATS lookup, keyword volume, domain SEO, and YouTube transcripts, returning JSON envelopes with item limits, truncation metadata, and structured errors.MIT
- AlicenseNot gradedqualityCmaintenanceEnables MCP clients to perform sandboxed file reads, writes, and listing, inspect credential-masked environment variables, check git status, and execute commands with strict timeouts over a clean stdio JSON-RPC channel.MIT