# Commerce protocols on AI Agent Pages

AI Agent Pages scores **agentic commerce** signals for online stores and hybrid sites. This guide is for humans implementing manifests and for agents discovering commerce-ready listings.

## Universal Commerce Protocol (UCP)

**UCP** is an open standard for agent-led shopping: merchants publish a JSON **discovery profile** at:

`https://your-store.com/.well-known/ucp`

Agents read that file to learn checkout capabilities, transports (REST, MCP, A2A), and payment handlers. Spec and tutorials: [ucp.dev](https://ucp.dev/).

### How AIAP scores UCP

- Readiness scans (via [isitagentready.com](https://isitagentready.com) when available) include **`commerce.ucp`** — “UCP profile”.
- Choose **site type: Online store** (`commerce`) on submit so UCP and related commerce checks count toward your **profile score**.
- For **content** or **agency** sites, commerce probes are **informational only** (they do not lower your score).
- When the external scanner is unavailable, AIAP probes `/.well-known/ucp` directly as a fallback.

### Checklist for merchants

1. Publish a valid UCP manifest at `/.well-known/ucp` on your store origin (HTTPS, `application/json` or correct content-type).
2. Submit with **site type** `commerce` and **category** `ecommerce` (or SaaS if product-led).
3. Rescan after you ship the manifest (admin **Rescan** or wait for cron).
4. Optional: implement related protocols (AP2, ACP, x402) as your stack supports them — see readiness breakdown on your listing.

### Directory and MCP discovery

- **Public directory:** filter `?ucp=1` on `/listings` for approved listings with a passing UCP check.
- **MCP tools:** `search_commerce_listings` (UCP-ready and commerce filters), `get_readiness_report` (full commerce.* checks).

## Other commerce checks (informational context)

| Check | Meaning |
|-------|---------|
| `commerce.ucp` | UCP manifest at `/.well-known/ucp` |
| `commerce.ap2` | Agent Payments Protocol (autonomous checkout mandates) |
| `commerce.acp` | Agentic Commerce Protocol discovery |
| `commerce.x402` | x402 payment rails |
| `commerce.mpp` | Merchant payment profile signals |

Full rubric aligns with isitagentready.com commerce presets.

## Future: AIAP as a UCP merchant

**Planned (not live yet):** AI Agent Pages may publish its own `/.well-known/ucp` profile so agents can purchase directory products (featured placement, boosts) through standard agentic checkout — not only Stripe checkout in a browser. Until then, use existing boost/checkout flows on listing pages.

Track implementation notes in repo `AGENT-HANDOFF.md` and product backlog.

## Links

- [Submit a listing](/submit) — choose **Online store** for commerce scoring
- [Browse directory](/listings) — `?ucp=1` for UCP-ready stores
- [AGENTS.md](/AGENTS.md) — MCP tools for agents
- [UCP specification](https://ucp.dev/)