# RevClamp MCP Server

> RevClamp MCP Server is a freemium MCP server for finance and payments. Deterministic checks for Stripe webhooks, Visa CE 3.0 disputes and EU VAT IDs. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $19 a month
- **Platforms:** API, CLI
- **Website:** https://revclamp.com/mcp
- **Repository:** https://github.com/lhphong09t2/revclamp-mcp
- **MCP Registry name:** com.revclamp/revclamp-mcp
- **Categories:** finance and payments, developer tools
- **Listing updated:** 2026-11-14

## About

RevClamp bundles nine billing checks that behave the same way on every call. They return both structured output and JSON text, and are annotated read-only and idempotent, so an agent can run them without side effects.

The tools audit 90 days of subscription and usage data for revenue leakage, test whether a customer's usage is a ghost-usage leak under Stripe's 2025-03-31.basil API, and stage a non-destructive Visa CE 3.0 dispute draft with submit forced to false. Others validate an EU or Northern Ireland VAT ID against VIES, reconcile Shopify Plus B2B net-terms deposits, verify webhook HMAC-SHA256 signatures with a 300-second replay window, and calculate ROI and plan fit.

Connect to the remote endpoint with no key for a stateless sandbox, or run the npm package over stdio. Without a workspace key the README says all nine tools run locally in-process.

## Features

- **Revenue leakage audit:** Scans 90 days of customers, usage and disputes for unpaid usage.
- **Ghost-usage check:** Evaluates entitlement against Stripe subscription and invoice state.
- **CE 3.0 dispute staging:** Builds a Visa CE 3.0 draft without submitting it.
- **VIES VAT validation:** Normalizes and validates EU and Northern Ireland B2B VAT IDs.
- **Net-terms reconciliation:** Checks Shopify Plus B2B deposits against Net-15/30/60 terms.
- **Webhook signature check:** Verifies Stripe, Shopify and RevClamp HMAC-SHA256 headers.

## Good for

- Find customers using a product after a failed invoice
- Prepare dispute evidence without filing it
- Check a buyer's VAT ID before applying reverse charge
- Hold fulfilment on unpaid wholesale orders
- Debug a webhook that fails signature verification

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http revclamp-mcp https://revclamp.com/api/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://revclamp.com/api/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "revclamp-mcp": {
      "url": "https://revclamp.com/api/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "revclamp-mcp": {
      "type": "http",
      "url": "https://revclamp.com/api/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "revclamp-mcp": {
      "serverUrl": "https://revclamp.com/api/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "revclamp-mcp": {
      "type": "http",
      "url": "https://revclamp.com/api/mcp"
    }
  }
}
```

## Tools

- `revclamp_audit_revenue_leakage`: Run a deterministic 90-day B2B revenue leakage and chargeback readiness audit across Stripe subscriptions, AI/API usage telemetry events, and open disputes. Executes as a 100% read-only, stateless diagnostic with zero external Stripe mutations. Returns structuredContent containing ok, mode, statelessEphemeralAudit, tenantId, dunningGracePeriodDays, costPerEventCents, and audit (scannedCustomers, s
- `revclamp_evaluate_ghost_usage`: Evaluate whether a specific customer's AI or API usage event constitutes unpaid ghost usage across multi-subscription Stripe 2025-03-31.basil state, enforcing fail-closed pagination (has_more must be explicitly false) and configurable 0-14 day dunning grace windows. Executes as a stateless, read-only entitlement evaluator with zero side effects. Returns structuredContent containing ok, mode, state
- `revclamp_stage_stripe_dispute_ce3`: Evaluate Visa Compelling Evidence 3.0 (CE 3.0) qualification across 120-to-365-day historical charges (requiring at least 2 settled, non-refunded, non-disputed prior transactions sharing IP address, device fingerprint, or billing email) and assemble a non-destructive Stripe dispute evidence draft with submit hardcoded to false. Executes as a pure read-only staging computation that never auto-submi
- `revclamp_validate_eu_vat_vies`: Normalize EU-27 and Northern Ireland (XI) B2B VAT identifiers (including mandatory Greece ISO-3166 GR to EL prefix normalization) and evaluate cross-border 0% VAT reverse-charge eligibility, VIES consultation evidence, or MS_UNAVAILABLE circuit-breaker fulfillment hold actions. Read-only and non-destructive; supports deterministic simulation modes ('VALID', 'INVALID', 'MS_UNAVAILABLE') or real-tim
- `revclamp_reconcile_b2b_net_terms`: Reconcile B2B wholesale Net-15, Net-30, and Net-60 invoice deposits, partial payments, and credit notes using exact integer minor-unit (EUR/USD cent) arithmetic with zero IEEE-754 floating-point drift. Executes as a pure, stateless, read-only financial reconciliation function. Returns structuredContent containing ok, mode, statelessEphemeralAudit, tenantId, and reconciliation (state, status, fulfi
- `revclamp_verify_webhook_signature`: Generate and verify canonical Stripe-Signature (t=<unix>,v1=<hex_sha256>), X-Shopify-Hmac-Sha256 (<base64_sha256>), and X-RevClamp-Signature (t=<unix>,v1=<hex_sha256>) headers over exact UTF-8 webhook payload bytes using crypto.timingSafeEqual and a 300-second replay window guard. Enforces a Zero-Trust guard that blocks known live/production credential patterns (sk_live_, rk_live_, non-test whsec_
- `revclamp_calculate_roi_and_plan_fit`: Deterministically calculate monthly and annual B2B margin savings using exact integer USD cents when replacing a 25%-30% contingency chargeback agency with RevClamp flat-rate 0% commission plans ($19 Starter, $59 Growth, $199 Scale). Evaluates monthlyWonDisputeUsd, monthlyGhostBleedUsd, contingencyTakeRatePercent, and monthlyUsageEvents to recommend the optimal tier. Returns structuredContent cont
- `revclamp_simulate_webhook_replay`: Deterministically evaluate an ordered or out-of-order sequence of 1-10 Stripe/Shopify/RevClamp subscription lifecycle webhooks against a 72-hour idempotency deduplication Set (eventId), a configurable idempotencyWindowSec (60s-2592000s, default: 259200s / 72h), and a monotonic transition timestamp guard (event.createdSec >= lastAppliedCreatedSec). Compares RevClamp's monotonic FSM against a naive 
- `revclamp_lint_dispute_evidence`: Deterministically lint a Stripe dispute evidence[access_activity_log] payload against Stripe's 18,000 UTF-16 code unit (String.prototype.length) ceiling, UTF-8 byte length, non-destructive --- BEGIN REVCLAMP CE3 EVIDENCE --- / --- END REVCLAMP CE3 EVIDENCE --- (or [RevClamp Verified Product Usage Log] / [/RevClamp Verified Product Usage Log]) delimiter markers, existing merchant note preservation,

## FAQ

### Do I need an API key?

No. The remote endpoint works without one as a stateless sandbox, and a free rg_live_ workspace key is optional.

### How do I run it locally?

Use npx -y revclamp-mcp over stdio; it needs Node.js 20 or newer.

### Does it submit disputes?

No. The dispute tool forces submit to false and only stages a draft.

### What do plans cost?

Free audit up to 5,000 events a month; Starter $19, Growth $59 and Scale $199 flat monthly, with no percentage overage.

### Is RevClamp MCP Server free?

RevClamp MCP Server has a free plan, with paid plans for more usage or features. Paid plans start at $19 a month.

### How do I add RevClamp MCP Server to Claude Code?

Run this command in your terminal: claude mcp add --transport http revclamp-mcp https://revclamp.com/api/mcp

### What are the best alternatives to RevClamp MCP Server?

The closest alternatives to RevClamp MCP Server are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/revclamp-mcp-server
