Agent Commerce
Star on GitHub

Commands

agent-commerce validate

Run exactly the checks the gateway runs at startup, and exit non-zero on any of them.

Usagebash
agent-commerce validate [--config <path>]

Options

--config <path>
Path to the config. Default: AGENT_COMMERCE_CONFIG, then config.yaml.

Runs exactly the checks the gateway runs at startup — the same function — and exits 1 on any of them. It needs no running gateway.

Output

$ agent-commerce validate --config config.yaml
PASS  Configuration is valid
      merchant: Demo Data Store (demo-store)
      resources: 2
      protocols: http=on mcp=on a2a=off acp=off
      payments: x402=on

What it checks

  • unknown keys, missing fields, unsupported version, unresolved ${VAR};
  • duplicate resource ids, pricing.type: dynamic, paid resources without payments;
  • exposure on disabled protocols, overlapping or conflicting mounts;
  • input bindings, ACP mappings, AP2 trust keys and replay paths;
  • addresses, networks and every mainnet guardrail.

It also warns about JSON Schema keywords the validator ignores, such as pattern and minLength.