# RevClamp Enterprise — B2B Revenue & EU VAT Assurance Firewall

> Automated Unpaid AI/API Usage Blocker, 2-Tier Visa CE 3.0 & First-Party Usage-Log Chargeback Evidence Autopilot (submit: false), and Fault-Tolerant Shopify Plus EU B2B VIES VAT & Net-30 Vault.

## Core Guarantees & Architecture
- **Zero False Lockouts (Entitlement & Agent Circuit Breaker):** Evaluates multi-subscription Stripe accounts (including 2025-03-31.basil item-level current_period_end, 24h incomplete grace, paid-through paused accounts, and 0-14 day custom dunning grace windows) before emitting HMAC-SHA256 signed `revclamp.entitlement.revoke` or `revclamp.entitlement.restore` webhooks (`x-revclamp-signature`).
- **2-Tier Stripe Chargeback Defense (`submit: false`):** Evaluates Visa Compelling Evidence 3.0 (CE 3.0) 120d-365d historical undisputed charges with 128-bit IPv6/IPv4-mapped & device overlap, and appends verified 90-day product usage logs into `evidence[access_activity_log]` within 18,000 UTF-16 code units without overwriting merchant notes.
- **Shopify Plus EU B2B VIES & Net-30 Vault:** Normalizes 28 EU member-state + Northern Ireland (`XI`) VAT prefixes (auto-converting Greece `GR -> EL`), places orders on safe fulfillment hold during EU VIES `MS_UNAVAILABLE` outages with bounded background retries, verifies integer EUR-cent Net-15/30/60 upfront deposits, and exports SHA-256 signed quarterly CSV audit bundles.
- **0% Commission Flat-Rate Pricing:** Free Audit ($0/mo, up to 5,000 events/mo), Starter ($19/mo, up to 100,000 events/mo), Growth ($59/mo, up to 1,000,000 events/mo), Scale ($199/mo, up to 5,000,000 events/mo). Supports Visa/Mastercard and instant on-chain USDC/USDT verification.

## Machine-Readable Endpoints & Model Context Protocol (MCP)
- **MCP Server (JSON-RPC 2.0 Streamable HTTP):** `POST https://revclamp.com/api/mcp`
- **Full LLM & Agent Technical Reference:** `GET https://revclamp.com/llms-full.txt`
- **Stripe & Next.js 12-Line Middleware Guide:** `GET https://revclamp.com/docs/stripe-setup`
- **2-Minute Onboarding Guide:** `GET https://revclamp.com/docs/onboarding`
- **Free Visa CE 3.0 Readiness Checker:** `GET https://revclamp.com/tools/stripe-ce3-checker`
- **Free 20-ID EU VIES VAT Batch Validator:** `GET https://revclamp.com/tools/vies-vat-validator`

## Model Context Protocol (MCP) JSON-RPC 2.0 Specification (`POST /api/mcp`)
- **Endpoint:** `POST https://revclamp.com/api/mcp`
- **Authentication:**
  - **Stateless Sandbox Mode:** Omit `Authorization` header to test all 5 deterministic tools with caller-supplied snapshots (`statelessEphemeralAudit: true`, zero database writes).
  - **Authenticated Workspace Mode:** Pass `Authorization: Bearer rg_live_<YOUR_WORKSPACE_KEY>` or `X-RevClamp-Tenant-Key: rg_live_<YOUR_WORKSPACE_KEY>`.
- **Supported JSON-RPC 2.0 Methods:** `initialize`, `notifications/initialized`, `ping`, `tools/list`, `tools/call`.
- **Exposed MCP Tools (5):**
  1. `revclamp_audit_revenue_leakage`: Runs a stateless or workspace 90-day readiness audit (`runHistoricalReadinessAudit`) across customers, usageEvents, and disputes.
  2. `revclamp_evaluate_ghost_usage`: Evaluates a customer's subscription snapshot (`subscriptionsHasMore: false` required) and dunning grace window (`0-14` days) for unpaid AI/API token bleed.
  3. `revclamp_stage_stripe_dispute_ce3`: Evaluates Visa CE 3.0 (`120d-365d` prior charges) vs Tier 1 First-Party Usage Log defense and builds a non-destructive `submit: false` Stripe Dispute draft (`<= 18,000` chars).
  4. `revclamp_validate_eu_vat_vies`: Normalizes EU/XI VAT IDs (`GR -> EL`) and evaluates VIES consultation certificates or `MS_UNAVAILABLE` retry holds.
  5. `revclamp_reconcile_b2b_net_terms`: Reconciles B2B wholesale Net-15/30/60 upfront deposits and credit notes using exact integer EUR-cent accounting.