{
  "schema_version": "1.0",
  "name": "com.decionis/commerce-gate",
  "version": "0.1.3",
  "title": "Decionis CommerceGate MCP",
  "description": "Operations-facing Shadow Mode preflight and signed-evidence reads for seven commerce action types, plus enforced binary Dynamics 365 transaction authorization. The server never executes marketplace or ERP writes.",
  "summary_for_operators": "Lets an AI agent ask, before it acts, whether a price change, stock change, order acceptance, fulfillment step, promotion change, refund or return clears your margin, stock and refund policy; authorize a Dynamics 365 transaction within the agent's budget with an enforced ALLOW or BLOCK; and read the signed evidence. It cannot perform any marketplace or ERP write.",
  "use_cases": [
    "Check whether a repricer's proposed price clears the margin floor after marketplace fees",
    "Check whether accepting an order still clears policy after the discount and the estimated cost",
    "Check a stock change, fulfillment step, promotion change, refund or return against policy before acting",
    "Authorize a complete Dynamics 365 transaction against policy and the agent budget without writing it",
    "Review what Shadow Mode would have held in the last 30 days and why",
    "Fetch the signed Decision Dossier or proof packet for an audit question"
  ],
  "keywords": [
    "CommerceGate MCP server",
    "MCP server for ecommerce operations",
    "AI agent check price change before publishing",
    "AI agent guardrails for ecommerce operations",
    "stop AI agent from repricing below cost",
    "AI agent refund limit policy check",
    "AI agent price change preflight",
    "MCP stock change check before publishing",
    "MCP oversell prevention check",
    "order acceptance economics evaluation",
    "MCP fulfillment action approval",
    "MCP promotion change review",
    "MCP refund request preflight",
    "MCP return authorization",
    "MCP Dynamics 365 transaction authorization",
    "repricer margin floor evaluation",
    "Shadow Mode commerce evaluation",
    "signed Decision Dossier",
    "commerce proof packet",
    "AI agent guardrails for price changes"
  ],
  "outcome_vocabulary": [
    {
      "operator": "PROCEED",
      "api": [
        "APPROVE"
      ],
      "meaning": "The action is inside the published policy. Your tool may go ahead. This is a policy result, not user consent and not an execution token."
    },
    {
      "operator": "HOLD",
      "api": [
        "REVIEW"
      ],
      "meaning": "Stop. Leave the marketplace as it is and put the action in front of an operator."
    },
    {
      "operator": "ESCALATE",
      "api": [
        "ESCALATE"
      ],
      "meaning": "Stop. A named approver with the right authority must decide before the action is re-evaluated. The CommerceGate MCP reports this as HOLD."
    },
    {
      "operator": "BLOCK",
      "api": [
        "REJECT"
      ],
      "meaning": "Stop. The action is outside policy and is not retried."
    },
    {
      "operator": "SHADOW",
      "api": [],
      "meaning": "Watch-only. Decisions are recorded with a signed dossier and nothing executes. Walmart, Adobe Commerce and the MCP start here; Shopify rules are off until you turn them on."
    }
  ],
  "canonical_url": "https://commerce.decionis.com/.well-known/mcp.json",
  "documentation_url": "https://commerce.decionis.com/llms-full.txt",
  "relationship": {
    "kind": "commerce_operations_adapter",
    "parent_platform": "Decionis",
    "parent_mcp": "https://protocol.decionis.com/mcp"
  },
  "distribution": {
    "status": "public",
    "publicly_installable": true,
    "npm": {
      "identifier": "@decionis/commerce",
      "version": "0.1.3",
      "url": "https://www.npmjs.com/package/@decionis/commerce",
      "install": "npx -y @decionis/commerce@0.1.3"
    },
    "note": "The public npm package runs as a local STDIO process. No remote CommerceGate MCP endpoint is published.",
    "directories": [
      {
        "id": "npm",
        "name": "npm",
        "operator": "npm, Inc.",
        "status": "listed",
        "url": "https://www.npmjs.com/package/@decionis/commerce"
      },
      {
        "id": "claude-desktop-extensions",
        "name": "Claude Connectors Directory (desktop extension)",
        "operator": "Anthropic",
        "status": "submitted"
      },
      {
        "id": "claude-connectors-remote",
        "name": "Claude Connectors Directory (remote connector)",
        "operator": "Anthropic",
        "status": "planned"
      },
      {
        "id": "chatgpt-apps",
        "name": "ChatGPT and Codex Plugins Directory",
        "operator": "OpenAI",
        "status": "planned"
      },
      {
        "id": "github-mcp-registry",
        "name": "GitHub MCP Registry (Copilot and VS Code)",
        "operator": "GitHub",
        "status": "submitted"
      },
      {
        "id": "clawhub",
        "name": "ClawHub",
        "operator": "OpenClaw",
        "status": "listed",
        "url": "https://clawhub.ai/ocularminds/skills/decionis-commercegate"
      },
      {
        "id": "smithery",
        "name": "Smithery",
        "operator": "Smithery",
        "status": "planned"
      },
      {
        "id": "glama",
        "name": "Glama MCP Directory",
        "operator": "Glama",
        "status": "planned"
      },
      {
        "id": "pulsemcp",
        "name": "PulseMCP",
        "operator": "PulseMCP",
        "status": "planned"
      }
    ]
  },
  "transports": [
    {
      "type": "stdio",
      "availability": "public_npm",
      "command": "npx",
      "args": [
        "-y",
        "@decionis/commerce@0.1.3"
      ]
    }
  ],
  "authentication": {
    "credential": {
      "environment_variable": "DECIONIS_API_KEY",
      "secret": true
    },
    "api_origin": {
      "environment_variable": "DECIONIS_API_BASE",
      "required": false,
      "secret": false,
      "default": "https://api.decionis.com"
    },
    "protocol": {
      "type": "environment_bound_bearer",
      "request_header": "Authorization: Bearer <DECIONIS_API_KEY>",
      "tenant_binding": {
        "environment_variable": "DECIONIS_ORG_ID",
        "secret": false,
        "format": "uuid"
      }
    },
    "erp_guard": {
      "type": "api_key_bound_erp_tenant",
      "request_headers": [
        "X-Decionis-API-Key: <DECIONIS_API_KEY>",
        "X-ERP-Region: <erp_region>"
      ],
      "tenant_argument": "request.tenant_id",
      "region_argument": "erp_region"
    },
    "requirements": {
      "unauthenticated_tools": [
        "commercegate_describe_capabilities"
      ],
      "protocol_tenant_tools": [
        "commercegate_evaluate_action",
        "commercegate_get_dossier",
        "commercegate_get_proof_packet",
        "commercegate_list_shadow_reports",
        "commercegate_summarize_shadow_reports"
      ],
      "protocol_calls_require_all": [
        "DECIONIS_API_KEY",
        "DECIONIS_ORG_ID"
      ],
      "erp_guard_requires": [
        "DECIONIS_API_KEY",
        "erp_region",
        "request.tenant_id"
      ]
    },
    "credential_or_origin_overrides_allowed": false
  },
  "upstream_api": {
    "base_url": "https://api.decionis.com",
    "contract_url": "https://commerce.decionis.com/.well-known/openapi.json",
    "operations": [
      {
        "operation_id": "validateErpTransaction",
        "method": "POST",
        "path": "/v1/guard/validate",
        "tools": [
          "commercegate_validate_erp_transaction"
        ]
      },
      {
        "operation_id": "evaluateCommerceDecision",
        "method": "POST",
        "path": "/v1/protocol/evaluate-decision",
        "tools": [
          "commercegate_evaluate_action"
        ]
      },
      {
        "operation_id": "getDecisionDossier",
        "method": "GET",
        "path": "/v1/protocol/dossiers/{dossierId}",
        "tools": [
          "commercegate_get_dossier"
        ]
      },
      {
        "operation_id": "getDecisionProofPacket",
        "method": "GET",
        "path": "/v1/protocol/dossiers/{dossierId}/proof-packet",
        "tools": [
          "commercegate_get_proof_packet"
        ]
      },
      {
        "operation_id": "listCommerceShadowReports",
        "method": "GET",
        "path": "/v1/protocol/shadow-reports",
        "tools": [
          "commercegate_list_shadow_reports",
          "commercegate_summarize_shadow_reports"
        ]
      }
    ]
  },
  "tools": [
    {
      "name": "commercegate_describe_capabilities"
    },
    {
      "name": "commercegate_validate_erp_transaction"
    },
    {
      "name": "commercegate_evaluate_action"
    },
    {
      "name": "commercegate_get_dossier"
    },
    {
      "name": "commercegate_get_proof_packet"
    },
    {
      "name": "commercegate_list_shadow_reports"
    },
    {
      "name": "commercegate_summarize_shadow_reports"
    }
  ],
  "supported_action_types": [
    "PRICE_CHANGE",
    "INVENTORY_MUTATION",
    "ORDER_ACCEPTANCE",
    "FULFILLMENT_ACTION",
    "PROMOTION_CHANGE",
    "REFUND_REQUEST",
    "RETURN_AUTHORIZATION"
  ],
  "action_support": {
    "native_margin_mapping": [
      "ORDER_ACCEPTANCE",
      "PRICE_CHANGE"
    ],
    "generic_protocol_shadow": [
      "INVENTORY_MUTATION",
      "FULFILLMENT_ACTION",
      "PROMOTION_CHANGE",
      "REFUND_REQUEST",
      "RETURN_AUTHORIZATION"
    ],
    "connector_execution": {
      "exposed_by_this_mcp": false,
      "connected_status_alone_is_sufficient": false,
      "required_evidence": [
        "marketplace_api_support",
        "merchant_granted_scope",
        "implemented_connector_path",
        "enabled_connector_path",
        "explicit_execution_authority"
      ]
    }
  },
  "safety": {
    "protocol_default_mode": "SHADOW",
    "erp_guard_mode": "ENFORCED",
    "marketplace_writes": false,
    "erp_writes": false,
    "protocol_tenant_binding": "DECIONIS_ORG_ID environment variable",
    "erp_tenant_binding": "request.tenant_id authenticated by API key",
    "stop_outcomes": [
      "HOLD",
      "ESCALATE",
      "BLOCK",
      "ERROR",
      "AMBIGUOUS"
    ],
    "note": "A decision never substitutes for explicit user intent or downstream execution authority."
  }
}