ACP discovery document exists

low

agent_commerce_acp

Checks if Agentic Commerce Protocol (ACP) discovery document is published.

What does this rule check?

ACP enables AI agents to discover your commerce API via /.well-known/acp.json. The discovery document declares protocol name, version, API base URL, supported transports, and available service capabilities.

Why is this important?

Without ACP discovery, agents cannot find your commerce API for automated purchasing, inventory checks, or order management. ACP standardizes commerce interactions for the agentic web.

How to fix

Serve /.well-known/acp.json with protocol.name, protocol.version, api_base_url, supported transports, and capabilities.services.

Examples

Incorrect
GET /.well-known/acp.json

HTTP/1.1 404 Not Found
Correct
GET /.well-known/acp.json

HTTP/1.1 200 OK
Content-Type: application/json

{"protocol": {"name": "acp", "version": "1.0"}, "api_base_url": "/api", "capabilities": {"services": ["checkout", "inventory"]}}

Agent fix snippet

Copy this snippet and paste it into your AI coding agent to fix this issue automatically.

Serve /.well-known/acp.json:

{
  "protocol": {"name": "acp", "version": "1.0"},
  "api_base_url": "/api/commerce",
  "transports": ["https"],
  "capabilities": {"services": ["checkout", "inventory"]}
}