revclamp-mcp 1.20.12 → 1.20.13

package/README.md

@@ -59,13 +59,13 @@ curl -sS -X POST https://api.revclamp.com/api/mcp \
 
 ```bash
 # 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.12 --self-test
+npx -y github:lhphong09t2/revclamp-mcp#v1.20.13 --self-test
 
 # Provision a free Cloud Workspace (or reuse REVCLAMP_API_KEY) & send a 6-digit login OTP
-npx -y revclamp-mcp@1.20.12 --init-workspace you@company.com
+npx -y revclamp-mcp@1.20.13 --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.12 --verify-otp you@company.com 123456
+REVCLAMP_API_KEY="rg_live_..." npx -y revclamp-mcp@1.20.13 --verify-otp you@company.com 123456
 
 # List all 9 MCP tools and JSON schemas (runs locally in-process)
 node index.mjs --list-tools

package/index.mjs

@@ -33,7 +33,7 @@ export {
   executeLocalMcpJsonRpc,
 };
 
-export const PACKAGE_VERSION = "1.20.12";
+export const PACKAGE_VERSION = "1.20.13";
 export const DEFAULT_MCP_ENDPOINT = "https://api.revclamp.com/api/mcp";
 export const ALLOWED_MCP_ORIGINS = Object.freeze(
   new Set([

package/local_engine.mjs

@@ -1913,7 +1913,7 @@ export const LOCAL_STATELESS_CLOUD_UPGRADE_HINT = Object.freeze({
   message:
     "Running in stateless local mode. Provision a free or paid Cloud Workspace for 90-day event persistence, automated webhook revocation, and Slack/Email alerts.",
   command: "npx --yes revclamp-mcp --init-workspace <work_email>",
-  cliActivateCommand: "npx -y revclamp-mcp@1.20.12 --init-workspace you@company.com",
+  cliActivateCommand: "npx -y revclamp-mcp@1.20.13 --init-workspace you@company.com",
   upgradeUrl: "https://revclamp.com/pricing?source=mcp_cli",
 });
 
@@ -2954,15 +2954,34 @@ function executeLocalMcpToolCore(toolName, rawArgs = {}) {
     const norm = normalizeVatId(args.buyerVatId || "");
     const viesMode = String(args.viesMode || "FORMAT_ONLY").toUpperCase();
     const isDemo = args.demo === true;
+    const crossBorder = Boolean(norm.validFormat && sellerCountry !== norm.memberState);
+    const goodsOnlyProtocol = Boolean(
+      crossBorder && (sellerCountry === "XI" || norm.memberState === "XI")
+    );
+    const xiServicesNotice =
+      EU_VIES_STATUTORY_TERMINOLOGY_MAP.XI.statutoryReverseChargeClause;
+    const rawBuyerTerminology = norm.validFormat
+      ? getEuViesStatutoryTerminology(norm.memberState)
+      : null;
+    const rawSellerTerminology = getEuViesStatutoryTerminology(sellerCountry);
+    const statutoryTerminology = rawBuyerTerminology
+      ? goodsOnlyProtocol
+        ? {
+            ...rawBuyerTerminology,
+            statutoryReverseChargeClause:
+              norm.memberState === "XI"
+                ? xiServicesNotice
+                : `${rawBuyerTerminology.statutoryReverseChargeClause} [Windsor Framework XI: N/A for B2B services; VIES applies to goods only under Art. 138(1)]`,
+          }
+        : rawBuyerTerminology
+      : null;
+    const sellerStatutoryTerminology = rawSellerTerminology
+      ? goodsOnlyProtocol
+        ? { ...rawSellerTerminology, statutoryReverseChargeClause: xiServicesNotice }
+        : rawSellerTerminology
+      : null;
 
-    if (
-      norm.validFormat &&
-      sellerCountry !== norm.memberState &&
-      supplyType === "SERVICES" &&
-      (sellerCountry === "XI" || norm.memberState === "XI")
-    ) {
-      const statutoryTerminology = getEuViesStatutoryTerminology(norm.memberState);
-      const sellerStatutoryTerminology = getEuViesStatutoryTerminology(sellerCountry);
+    if (goodsOnlyProtocol && supplyType === "SERVICES") {
       return {
         ok: true,
         executionMode: "local_open_source_engine",
@@ -2970,6 +2989,7 @@ function executeLocalMcpToolCore(toolName, rawArgs = {}) {
         valid: null,
         formatValid: true,
         supplyType,
+        goodsOnlyProtocol: true,
         status: "HOLD_XI_SERVICES_OUTSIDE_EU_VIES",
         action: "APPLY_UK_OR_NON_EU_SERVICES_VAT_RULES",
         reason: "WINDSOR_FRAMEWORK_XI_B2B_SERVICES_EXCLUDED_FROM_VIES",
@@ -3016,6 +3036,7 @@ function executeLocalMcpToolCore(toolName, rawArgs = {}) {
         valid: false,
         formatValid: false,
         supplyType,
+        goodsOnlyProtocol: false,
         status: "HOLD_INVALID_VAT",
         reason: "INVALID_EU_VAT_FORMAT",
         sellerCountry,
@@ -3026,9 +3047,6 @@ function executeLocalMcpToolCore(toolName, rawArgs = {}) {
       };
     }
 
-    const crossBorder = sellerCountry !== norm.memberState;
-    const statutoryTerminology = getEuViesStatutoryTerminology(norm.memberState);
-    const sellerStatutoryTerminology = getEuViesStatutoryTerminology(sellerCountry);
     const callerConsultationId =
       typeof args.consultationNumber === "string" && args.consultationNumber.trim().length > 0
         ? args.consultationNumber.trim().slice(0, 64)
@@ -3041,6 +3059,7 @@ function executeLocalMcpToolCore(toolName, rawArgs = {}) {
         valid: null,
         formatValid: true,
         supplyType,
+        goodsOnlyProtocol,
         status: "FORMAT_VALID_UNVERIFIED",
         action: crossBorder ? "FORMAT_VALID_UNVERIFIED" : "APPLY_DOMESTIC_STANDARD_VAT",
         reason: "LOCAL_FORMAT_CHECK_ONLY_NO_LIVE_VIES_CONSULTATION",
@@ -3089,6 +3108,7 @@ function executeLocalMcpToolCore(toolName, rawArgs = {}) {
         valid: null,
         formatValid: true,
         supplyType,
+        goodsOnlyProtocol,
         status: "PENDING_ASYNC_RETRY",
         reason: `VIES_SOFT_FAULT_${viesMode}`,
         sellerCountry,
@@ -3112,6 +3132,7 @@ function executeLocalMcpToolCore(toolName, rawArgs = {}) {
         valid: null,
         formatValid: true,
         supplyType,
+        goodsOnlyProtocol,
         status: "HOLD_UNVERIFIED_VIES_FAULT",
         reason: `VIES_GATEWAY_FAULT_${viesMode}`,
         sellerCountry,
@@ -3135,6 +3156,7 @@ function executeLocalMcpToolCore(toolName, rawArgs = {}) {
         valid: false,
         formatValid: true,
         supplyType,
+        goodsOnlyProtocol,
         status: "HOLD_INVALID_VAT",
         reason: viesMode === "INVALID" ? "VIES_DEFINITE_INVALID" : `VIES_${viesMode}`,
         sellerCountry,
@@ -3158,6 +3180,7 @@ function executeLocalMcpToolCore(toolName, rawArgs = {}) {
         valid: null,
         formatValid: true,
         supplyType,
+        goodsOnlyProtocol,
         status: "HOLD_UNVERIFIED_VIES_FAULT",
         reason: "UNRECOGNIZED_VIES_SIMULATION_MODE",
         sellerCountry,
@@ -3191,6 +3214,7 @@ function executeLocalMcpToolCore(toolName, rawArgs = {}) {
       valid: true,
       formatValid: true,
       supplyType,
+      goodsOnlyProtocol,
       status: crossBorder ? "VERIFIED_ZERO_RATED" : "DOMESTIC_TAXABLE_SUPPLY",
       action: crossBorder ? "ALLOW_ZERO_RATED_REVERSE_CHARGE" : "APPLY_DOMESTIC_STANDARD_VAT",
       reason: crossBorder ? "VALID_CROSS_BORDER_REVERSE_CHARGE" : "SAME_MEMBER_STATE_DOMESTIC",
@@ -3985,7 +4009,7 @@ function toSafeLocalRpcId(rawId) {
 
 export function executeLocalMcpJsonRpc(
   rpcRequest,
-  packageVersion = "1.20.12",
+  packageVersion = "1.20.13",
   options = {}
 ) {
   if (!rpcRequest || typeof rpcRequest !== "object" || Array.isArray(rpcRequest)) {

package/mcp-config.json

@@ -26,7 +26,7 @@
   },
   "manifest": {
     "name": "revclamp-mcp",
-    "version": "1.20.12",
+    "version": "1.20.13",
     "tools": [
       "revclamp_audit_revenue_leakage",
       "revclamp_evaluate_ghost_usage",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "revclamp-mcp",
   "mcpName": "com.revclamp/revclamp-mcp",
-  "version": "1.20.12",
+  "version": "1.20.13",
   "description": "Model Context Protocol (MCP) server and CLI for Stripe 2025-03-31.basil entitlement checks, Visa CE 3.0 dispute staging (submit: false), EU/XI VIES VAT validation, Shopify Plus B2B Net-15/30/60 reconciliation, webhook HMAC-SHA256 verification, 0% take-rate ROI calculation, 72-hour webhook replay & out-of-order state-machine simulation, and Stripe dispute evidence 18,000 UTF-16 code unit & CE 3.0 completeness linting.",
   "type": "module",
   "main": "./index.mjs",
@@ -46,6 +46,6 @@
     "node": ">=20.0.0"
   },
   "revclamp": {
-    "engineSha256": "c67f214211284a479fbe10857dfef984b45e3c3403c37d5d834dcd5a5b326b60"
+    "engineSha256": "aacc34998abb464fc647d3029fecc0b6caf1f8638f7cdfdf12c09f35a2319323"
   }
 }

package/server.json

@@ -7,13 +7,13 @@
     "url": "https://github.com/lhphong09t2/revclamp-mcp",
     "source": "github"
   },
-  "version": "1.20.12",
+  "version": "1.20.13",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "revclamp-mcp",
-      "version": "1.20.12",
+      "version": "1.20.13",
       "transport": {
         "type": "stdio"
       },