Skip to main content
Glama
RevClamp MCP Server

RevClamp MCP Server

RevClamp MCP Server & CLI (revclamp-mcp)

RevClamp Enterprise — B2B Revenue & Compliance Guardrails

mcptry

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, and tools/call) execute locally in-process inside local_engine.mjs using pure Node.js (node:crypto HMAC-SHA256 verification, integer-cent double-entry accounting, 72-hour webhook replay state machines, and 18,000 UTF-16 code unit CE 3.0 linting). Zero network calls are ever made unless REVCLAMP_API_KEY or REVCLAMP_MCP_URL is explicitly configured.

  • Optional Hosted Cloud Workspace Sync (REVCLAMP_API_KEY): When REVCLAMP_API_KEY (rg_live_...) is configured, revclamp-mcp connects 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 via https://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 (REVCLAMP_API_KEY)

Execution & Network

100% in-process (local_engine.mjs), zero network calls

HTTPS JSON-RPC to https://api.revclamp.com/api/mcp (redirect: "error")

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 submit: false draft & revoke_entitlement decision

24/7 autonomous Stripe webhook outbox (disputes.update & signed revoke webhooks)

EU & XI B2B VAT (VIES)

Deterministic syntax & GR -> EL normalization (FORMAT_ONLY default, valid: null)

Live EU Commission VIES SOAP consultation IDs + circuit-breaker retry queue (viesMode: "LIVE" + REVCLAMP_API_KEY)

Monthly Event Tiers

Unlimited local in-process evaluations (0 network cost)

Free Sandbox (5,000 events/mo) · Starter $19/mo (100k) · Growth $59/mo (1M) · Scale $199/mo (5M)

Data Minimization & Privacy

Nothing ever leaves your machine

Only explicit tools/call arguments are sent over TLS after local live-secret scrubbing (blocks sk_live_, non-test whsec_, and shpat_ locally before any network request)

Related MCP server: week7-mcp-server

Open-Source MCP Tools Implemented in local_engine.mjs (9)

Tool Name

Domain

Local In-Process Implementation (local_engine.mjs)

Execution Mode

revclamp_audit_revenue_leakage

Stripe Billing & Usage

Evaluates caller-supplied customer/usage arrays (demo: true for synthetic sample) and returns upgrade hooks when no workspace ledger is connected

Local In-Process (or Optional Cloud 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

Local In-Process (or Optional Cloud Key)

revclamp_stage_stripe_dispute_ce3

Visa 10.4 / CE 3.0

Evaluates 120d–365d prior undisputed charges (ip_subnet/device_id overlap) against caller-supplied usageEvents (demo: true for sample) and stages a non-destructive submit: false draft (<= 18,000 UTF-16 code units)

Local In-Process (or Optional Cloud Key)

revclamp_validate_eu_vat_vies

EU & XI B2B VAT

Normalizes 27 EU member states + Northern Ireland (XI) VAT IDs (GR -> EL), supports split (buyerCountryCode + vatNumber including numeric VAT IDs) or combined (buyerVatId / vatId) aliases with fail-closed CONFLICTING_PARAMETER_ALIASES guards, checks syntax locally (FORMAT_ONLY, valid: null), simulates errorWrappers (demo: true), or queries live EU VIES (viesMode: "LIVE" + REVCLAMP_API_KEY)

Local In-Process (or Optional Live VIES)

revclamp_reconcile_b2b_net_terms

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)

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 (node:crypto) with 300s replay checks

Local In-Process (or Optional Cloud 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

Local In-Process (or Optional Cloud Key)

revclamp_simulate_webhook_replay

Webhook Replay & FSM

Simulates subscription lifecycle webhooks against a 72h deduplication Set and monotonic createdSec guard vs. naive arrival-order handlers

Local In-Process (or Optional Cloud 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, and merchant note preservation

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

Stripe basil entitlement and CE 3.0 flowchart

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

EU VIES circuit breaker flowchart

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

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 (@revclamp/google-ads-transparency-mcp)

Zero-browser Google Ads Transparency Center (AR... entity disambiguation, CR... creatives, static content.js ad copy, regional disclosures)

npx -y @revclamp/google-ads-transparency-mcp --mcp-stdio

Apify Store · npm

RevClamp TalentPulse (@revclamp/unified-ats-jobs-mcp)

Zero-browser 5-in-1 B2B ATS Job & Hiring Signal Feed across Greenhouse, Workday CXS, Ashby, Lever, and SmartRecruiters

npx -y @revclamp/unified-ats-jobs-mcp --mcp-stdio

Apify Store · npm

RevClamp ContactPulse (@revclamp/b2b-domain-contact-enricher-mcp)

Zero-browser B2B Domain Contact, RFC 9116 /.well-known/security.txt, Schema.org ContactPoint, and DoH MX / SPF / _dmarc Enricher

npx -y @revclamp/b2b-domain-contact-enricher-mcp --mcp-stdio

Apify Store · npm

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_board in @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 with search_ats_job_postings and resolve_company_ats_board to persist canonical board snapshots (50-to-1 deduplicated upstream polling) and emit structured daily JOB_OPENED, COMPENSATION_UPDATED, and JOB_CLOSED diffs 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 at https://revclamp.com/tools/ats-hiring-watchlist.

  • Official n8n Community Nodes (n8n-nodes-revclamp): Install n8n-nodes-revclamp (RevClampHiringWatchlist Action node + RevClampHiringWatchlistTrigger Polling 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.mjs with zero external npm dependencies.

  • Strict Origin Pinning (Cloud Mode): When REVCLAMP_API_KEY is provided, only connects to https://api.revclamp.com/api/mcp or https://revclamp.com/api/mcp over TLS (redirect: "error").

  • 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

Available Tools

9 tools
revclamp_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

    B3.3/5.0

    Scored across 9 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Zero-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.
      10
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables 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.
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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