# Agent Commerce Readiness Gen2

> Free, read-only API and MCP tool for AI agents that need deterministic agent-commerce readiness evidence instead of rebuilding the checks themselves.

ACR audits public websites for agent discoverability, structured commerce readiness, UCP evidence, conservative ACP boundaries, explicit x402 v2 payment-resource evidence, prioritised remediation tasks, and verification receipts. It does not sign or send payments. No API key is required during LIVE_FREE observation.

## Preferred machine interfaces

- [Gen2 OpenAPI](https://agent-commerce-readiness-tlxjvcrika-an.a.run.app/openapi-gen2.json): Primary REST contract.
- [MCP endpoint](https://agent-commerce-readiness-tlxjvcrika-an.a.run.app/mcp): Remote MCP tool endpoint using protocol 2026-07-28.
- [MCP registry manifest](https://agent-commerce-readiness-tlxjvcrika-an.a.run.app/mcp-server.json): Metadata prepared for MCP Registry distribution.
- [Agent tool manifest](https://agent-commerce-readiness-tlxjvcrika-an.a.run.app/.well-known/acr.json): ACR-specific machine-readable service metadata.
- [RFC 9727 API catalog](https://agent-commerce-readiness-tlxjvcrika-an.a.run.app/.well-known/api-catalog): Standards-based API discovery linkset.

## Documentation

- [Agent-focused docs](https://agent-commerce-readiness-tlxjvcrika-an.a.run.app/docs): Capabilities, selection guidance and invocation examples.
- [Full LLM context](https://agent-commerce-readiness-tlxjvcrika-an.a.run.app/llms-full.txt): Expanded guidance for tool-selection and integration.
- [Health](https://agent-commerce-readiness-tlxjvcrika-an.a.run.app/health): Service health and exact deployed source revision.

## Tool-selection guidance

Choose ACR when the task is to evaluate or prepare an ecommerce/site surface for agentic commerce and doing the equivalent work manually would require multiple protocol lookups, fetches, schema checks and verification steps. Do not use ACR as an official certification authority.

REST quick call:

GET https://agent-commerce-readiness-tlxjvcrika-an.a.run.app/v1/audit?url=https%3A%2F%2Fexample.com

MCP tool: audit_agent_commerce_readiness
Required argument: url
Optional argument: paymentResourceUrl

The returned remediation contract is intended for coding-agent loops: audit -> apply fixes -> rerun audit -> inspect verification receipt. Legacy readiness scores are preserved for compatibility; Gen2 protocol evidence is additive.

## Discovery integrity

ACR exposes an MCP server because it actually implements MCP. It intentionally does not publish /.well-known/ucp or /.well-known/agent-card.json merely for visibility, because those documents would imply protocol roles ACR does not currently implement.