RevClamp MCP Server

{
  "type": "object",
  "required": [
    "customerId",
    "subscriptions"
  ],
  "properties": {
    "customerId": {
      "type": "string",
      "description": "Required Stripe customer identifier to evaluate (format example: 'cus_9s6XKzkNRiz8i3', max 64 chars)."
    },
    "occurredAtSec": {
      "type": "integer",
      "description": "Optional alias for usageTimestampSec: Unix epoch timestamp in integer seconds (e.g. 1761264000) when the usage event occurred (used when usageTimestampSec is omitted)."
    },
    "subscriptions": {
      "description": "Required Stripe customer subscriptions payload: either a Stripe list object ({ data: [...], has_more: false }) or a raw array of up to 50 subscription objects containing id, status ('active', 'trialing', 'past_due', 'canceled', 'unpaid'), current_period_end, or items.data[].current_period_end in Unix seconds."
    },
    "usageTimestampSec": {
      "type": "integer",
      "description": "Optional Unix epoch timestamp in integer seconds (e.g. 1761264000) when the AI/API usage event occurred (defaults to current server Unix timestamp if omitted)."
    },
    "subscriptionsHasMore": {
      "type": "boolean",
      "description": "Pagination completeness flag (boolean). Must be explicitly set to false when passing a raw subscriptions array so RevClamp can verify no active subscription was truncated on a later page."
    },
    "dunningGracePeriodDays": {
      "type": "integer",
      "maximum": 14,
      "minimum": 0,
      "description": "Dunning grace window in integer days (valid range: 0 to 14, default: 3) after latest_invoice_failed_at during which past_due subscriptions remain entitled."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "preset": {
      "enum": [
        "valid_ce3_non_destructive",
        "utf16_overflow_19k",
        "missing_device_and_overwrite_risk",
        "custom"
      ],
      "type": "string",
      "description": "Scenario preset to evaluate when custom evidenceLogText is omitted (default: 'valid_ce3_non_destructive')."
    },
    "hasIpMatch": {
      "type": "boolean",
      "description": "Whether the disputed charge IPv4/IPv6 address matches the historical undisputed charges."
    },
    "hasDeviceMatch": {
      "type": "boolean",
      "description": "Whether the disputed charge device_id fingerprint matches the historical undisputed charges."
    },
    "evidenceLogText": {
      "type": "string",
      "maxLength": 30000,
      "description": "Merged or candidate Stripe dispute evidence[access_activity_log] payload evaluated against the 18,000 UTF-16 code unit ceiling and non-destructive delimiter markers."
    },
    "priorMatchedCount": {
      "type": "integer",
      "maximum": 50,
      "minimum": 0,
      "description": "Number of prior undisputed Stripe charges (120d-365d old) with matching customer_id and IP/device fingerprint (Visa CE 3.0 requires >= 2)."
    },
    "existingMerchantNotes": {
      "type": "string",
      "maxLength": 18000,
      "description": "Existing human AE/support notes inside evidence[access_activity_log] that must be preserved."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "orderId",
    "totalOrderCents",
    "paidAmountCents"
  ],
  "properties": {
    "orderId": {
      "type": "string",
      "description": "Required B2B wholesale order or invoice identifier (e.g. 'gid://shopify/Order/908812' or 'ORD-2026-9088', max 64 chars)."
    },
    "creditNoteCents": {
      "type": "integer",
      "description": "Optional post-invoice credit notes or return adjustments in integer cents (valid range: 0 to totalOrderCents, default: 0; singular alias for creditNotesCents)."
    },
    "paidAmountCents": {
      "type": "integer",
      "description": "Required cumulative amount collected from the buyer in non-negative integer cents (e.g. 75000 for 750.00 EUR; must be >= 0)."
    },
    "totalOrderCents": {
      "type": "integer",
      "description": "Required gross invoice total in positive integer minor currency units / cents (e.g. 250000 for 2,500.00 EUR; must be > 0)."
    },
    "creditNotesCents": {
      "type": "integer",
      "description": "Optional post-invoice credit notes or return adjustments in integer cents (valid range: 0 to totalOrderCents, default: 0; plural alias for creditNoteCents)."
    },
    "paymentTermsDays": {
      "type": "integer",
      "description": "Optional B2B net payment terms maturity window in integer days (allowed values: 15, 30, or 60 for Net-15, Net-30, or Net-60; default: 30)."
    },
    "requiredDepositCents": {
      "type": "integer",
      "description": "Optional explicit upfront deposit threshold in integer cents (valid range: 0 to totalOrderCents). Overrides requiredDepositPercent when provided."
    },
    "requiredDepositPercent": {
      "type": "integer",
      "description": "Optional upfront deposit percentage required before releasing warehouse fulfillment hold (valid range: 0 to 100, default: 30 i.e. 30% upfront deposit)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "disputeId": {
      "type": "string",
      "description": "Stripe dispute identifier being staged (format example: 'du_1QxyzEnterpriseDispute01', default: 'du_mcp_staged_01', max 64 chars)."
    },
    "customerId": {
      "type": "string",
      "description": "Stripe customer identifier associated with the disputed charge (format example: 'cus_enterprise_88', default: 'cus_mcp_enterprise_01', max 64 chars)."
    },
    "usageEvents": {
      "type": "array",
      "description": "Optional array of up to 200 customer product/API usage telemetry events (each with occurredAtSec Unix seconds, stripe_customer_id, and event_name) for append-only access_activity_log staging."
    },
    "disputeReason": {
      "type": "string",
      "description": "Stripe dispute reason code (e.g. 'fraudulent', 'unrecognized', 'subscription_canceled'; default: 'fraudulent'; Visa CE 3.0 applies to 'fraudulent' disputes)."
    },
    "priorTransactions": {
      "type": "array",
      "description": "Optional array of up to 50 historical Stripe charge objects (each with id, status: 'succeeded', disputed: false, refunded: false, occurredAtSec 120-365 days prior to disputedTransaction, email, ip_address, and device_id)."
    },
    "disputedTransaction": {
      "type": "object",
      "description": "Optional disputed charge snapshot object containing id (e.g. 'ch_disputed_01'), occurredAtSec (Unix seconds), customer_id, email, ip_address, and device_id."
    },
    "existingUncategorizedText": {
      "type": "string",
      "description": "Optional existing merchant evidence notes in Stripe evidence.uncategorized_text or access_activity_log (up to 18,000 chars) to preserve via append-only merge without overwriting."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "buyerVatId"
  ],
  "properties": {
    "viesMode": {
      "enum": [
        "VALID",
        "INVALID",
        "MS_UNAVAILABLE",
        "LIVE"
      ],
      "type": "string",
      "description": "VIES evaluation mode: 'VALID' (deterministic active VAT simulation, default), 'INVALID' (deterministic rejected VAT simulation), 'MS_UNAVAILABLE' (deterministic member-state outage circuit-breaker simulation), or 'LIVE' (real-time European Commission VIES lookup)."
    },
    "buyerVatId": {
      "type": "string",
      "description": "Required buyer EU or Northern Ireland VAT registration number to normalize and validate (e.g. 'DE123456789', 'GR123456789', 'NL123456789B01', 'XI123456789', max 40 chars)."
    },
    "sellerCountry": {
      "type": "string",
      "description": "Two-letter EU-27 or XI member state prefix of the merchant's dispatch warehouse (e.g. 'DE', 'NL', 'FR', 'EL', 'XI'; 'GR' is automatically normalized to 'EL'; default: 'DE')."
    },
    "consultationNumber": {
      "type": "string",
      "description": "Optional VIES requester consultation reference number (e.g. 'WAPIAAAAW998877', max 64 chars) to attach to deterministic 'VALID' mode tax audit records."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "secret": {
      "type": "string",
      "description": "Synthetic or test webhook signing secret (default: 'whsec_test_revclamp_sandbox_secret_2026', max 256 chars). Live production secrets (sk_live_, rk_live_, non-test whsec_..., shpss_..., shpat_..., rg_live_, rc_live_, AKIA..., and PEM private keys) are rejected."
    },
    "provider": {
      "enum": [
        "stripe",
        "shopify",
        "revclamp"
      ],
      "type": "string",
      "description": "Webhook signature provider scheme to evaluate: 'stripe' (Stripe-Signature t=<sec>,v1=<hex>, default), 'shopify' (X-Shopify-Hmac-Sha256 Base64 raw UTF-8 HMAC), or 'revclamp' (X-RevClamp-Signature t=<sec>,v1=<hex>)."
    },
    "rawPayload": {
      "type": "string",
      "description": "Exact unparsed UTF-8 webhook request body string (up to 16,384 chars) used to compute the canonical SHA-256 HMAC digest. Defaults to a provider-specific sample JSON event if omitted."
    },
    "timestampSec": {
      "type": "integer",
      "maximum": 9999999999,
      "minimum": 1,
      "description": "Optional Unix epoch timestamp in integer seconds (valid range: 1 to 9999999999; defaults to current server Unix timestamp) used when generating or verifying timestamped Stripe/RevClamp headers."
    },
    "signatureHeader": {
      "type": "string",
      "description": "Optional supplied HTTP signature header value to verify via crypto.timingSafeEqual (e.g. 't=1760000000,v1=...' or Base64 digest, max 512 chars). Omit to run in GENERATE_AND_SELF_VERIFY mode."
    }
  },
  "additionalProperties": false
}