Skip to main content
Glama
deprecated-legacy-sandbox

deprecated-legacy-sandbox

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.

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), 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-30

Reconciles Net-15/30/60 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.19 --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.19 --init-workspace
npx -y revclamp-mcp@1.20.19 --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.19 --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

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

1 tool
legacy_sandbox_noopBInspect

No-op diagnostic stub for archived sandbox workspace.

NameRequiredDescriptionDefault

No parameters

TDQS

B3.1/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden, and "no-op" is a genuinely valuable disclosure: the agent learns the call has no side effects. Beyond that it is silent — whether the call always succeeds, errors on archived workspaces, or is itself deprecated is left unstated.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single short sentence with the most important fact (no-op) front-loaded and no waste. It could arguably use one more clause clarifying the diagnostic intent, but there is no padding to trim.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a zero-parameter, no-output tool the bar is low, and the description covers the essentials of what happens (nothing). It still leaves the agent unable to decide whether calling it is meaningful, which matters for a stub that may exist only for backward compatibility.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool takes zero parameters and the schema is closed with additionalProperties=false, so there is nothing for the description to disambiguate. The baseline of 4 applies: no parameter semantics are needed here.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

"No-op diagnostic stub" identifies the resource as a placeholder and explicitly states it performs no action, which is useful. However, "diagnostic" for an "archived sandbox workspace" is never explained — the agent cannot tell what is being diagnosed or verified, so the purpose stays vague beyond the no-op label.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no indication of when this tool should be called, when it should not, or what alternative exists if any. The word "diagnostic" weakly implies a health-check use case, but nothing confirms it or tells the agent whether the tool is deprecated and should be avoided.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 6 tool updatesv1.0.1
    • Addedlegacy_sandbox_noop
    • Removedrevclamp_audit_revenue_leakage
    • Removedrevclamp_evaluate_ghost_usage
    • Removedrevclamp_reconcile_b2b_net_terms
    • Removedrevclamp_stage_stripe_dispute_ce3
    • Removedrevclamp_validate_eu_vat_vies
  2. 5 tool updatesv1.0.0
    • First observedrevclamp_audit_revenue_leakage
    • First observedrevclamp_evaluate_ghost_usage
    • First observedrevclamp_reconcile_b2b_net_terms
    • First observedrevclamp_stage_stripe_dispute_ce3
    • First observedrevclamp_validate_eu_vat_vies

TDQS

B3.1/5.0

Scored across 1 tool

Disambiguation5/5

There is only one tool, so there is no possibility of selecting the wrong tool or confusing overlapping purposes. Its no-op diagnostic role is clearly distinguishable by default.

Naming Consistency5/5

The single tool name uses a clear snake_case pattern and is descriptive of its legacy sandbox no-op behavior. There is no mixed convention to penalize.

Tool Count1/5

A single trivial no-op tool is an extremely thin tool surface for an MCP server, even one framed as deprecated. The rubric treats a single trivial tool as an extreme mismatch.

Completeness1/5

The surface offers no meaningful lifecycle operations such as listing, inspecting, updating, or cleaning up sandbox workspaces. For the stated archived sandbox domain, a no-op diagnostic stub is severely incomplete.

Maintenance

ActivityMaintained
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    A
    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
    C
    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
    B
    maintenance
    Provides deterministic local development tools over stdio MCP, including repository mapping, code review, secret and dependency scanning, release checks, whitelisted checks, scaffolding, and workflow state tracking.
    16 npm
    MIT
  • A
    license
    Not graded
    quality
    B
    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.
    33 PyPI
    MIT