CommerceGate MCP

Let your AI agent ask before it reprices, accepts, ships, refunds or returns.

CommerceGate MCP lets an agent check seven kinds of commerce action against your policy before acting: a price change, an inventory update, accepting an order, a fulfillment step, a promotion change, a refund, or a return authorization. Every check runs in Shadow Mode and answers with the margin, stock or authority math. A separate tool gives Dynamics 365 an enforced ALLOW or BLOCK for one complete transaction, within the agent's spend budget. The agent can read the signed Decision Dossier, proof packet or Shadow report; it can never perform the marketplace or ERP write itself.

Built for bounded operational work.

Marketplace operations, pricing, fulfillment, finance, and automation teams get one explicit decision vocabulary without giving the MCP direct execution power.

Check an action before it happens

Ask whether a price change, stock change, order acceptance, fulfillment step, promotion change, refund or return clears policy. The check runs in Shadow Mode and records the decision and dossier.

Inspect signed evidence

Retrieve a Decision Dossier or proof packet by identifier without reaching into a production database or marketplace account.

Review Shadow Mode

List and summarize recent advisory evaluations so an operator can understand patterns before enabling enforcement elsewhere.

Validate a Dynamics transaction

Send one complete bounded D365 transaction to the enforced binary policy and agent-budget guard without posting, releasing, or modifying it in the ERP.

What an operator can ask an agent that has it.

Plain questions map to seven Shadow action contracts and the enforced ERP guard through seven tools. The agent evaluates, validates, and reads evidence; a person or the connected platform still executes.

Would repricing DC-AFR-55 to $89 on Walmart still clear our margin floor after the referral fee?

The agent submits the proposed price and supplied cost facts in Shadow Mode, then receives a policy outcome and evidence reference. The response does not publish the price or call Walmart.

commercegate_evaluate_action

Would accepting this $4,000 order after a $300 discount clear policy with $2,900 in estimated cost?

The agent submits the supplied gross amount, discount, and estimated cost in Shadow Mode. HOLD means a person reviews the economics before any separate execution step.

commercegate_evaluate_action

Would this stock change leave only seven units and create oversell risk?

The agent sends the current and new quantity and gets a verdict against your inventory floor. Whether the platform can then stop the write depends on that platform; the verdict is recorded either way.

commercegate_evaluate_action

Should this $2,850 refund request be held for review?

The agent submits the refund request without issuing it. Any later refund requires a separately connected marketplace path with the required API, scope, lifecycle checks, and explicit authority.

commercegate_evaluate_action

What would Shadow Mode have held this month, and why?

The agent lists and summarizes recent Shadow evaluations: outcome counts and rates, near misses, reason breakdowns, and candidate enforcement paths.

commercegate_summarize_shadow_reports

Finance wants the signed evidence for dossier 8d4d…e201.

The agent fetches the Decision Dossier and proof packet by ID. Verification is evidence, never permission to execute.

commercegate_get_proof_packet

Does this complete Business Central sales document clear policy and the agent budget?

The agent calls the enforced ERP guard with the bounded transaction and ERP region. ALLOW or BLOCK applies to that exact request; the MCP does not release or post the document.

commercegate_validate_erp_transaction

Agent operating rule

Evaluate first. Preserve the stop condition.

  1. Describe

    Confirm the supported action shape and configuration readiness.

  2. Evaluate

    Submit one exact proposed action, or a complete D365 transaction when the ERP guard is the intended authority.

  3. Review

    Stop on HOLD, ESCALATE, BLOCK, errors, or ambiguity and surface the evidence.

Tool catalog

Seven tools, seven action contracts, one ERP guard.

  • commercegate_describe_capabilities
  • commercegate_validate_erp_transaction
  • commercegate_evaluate_action
  • commercegate_get_dossier
  • commercegate_get_proof_packet
  • commercegate_list_shadow_reports
  • commercegate_summarize_shadow_reports

Public npm transport

Public package, local STDIO.

Install and run the pinned @decionis/commerce@0.1.3 release with npx -y @decionis/commerce@0.1.3. The package runs as a local STDIO process. Authenticated calls use a least-privilege DECIONIS_API_KEY and Protocol calls also require an environment-bound DECIONIS_ORG_ID. The API origin defaults to https://api.decionis.com.

It is a commerce-operations adapter over the Decionis decision and evidence APIs. It does not expose a remote CommerceGate MCP endpoint. The broader hosted Protocol MCP remains a separate parent interface.

A verdict from the MCP says whether an action clears policy. Whether the platform can then enforce it depends on that platform: the marketplace has to offer the API, you have to grant the scope, and the connector has to support the action. Each platform page states what is enforced today.

View the package on npm Decionis Protocol MCP

Make CommerceGate the question your agent asks first.

Start with Shadow Mode, inspect the dossier, and keep marketplace execution outside the MCP boundary.