Machine-readable shop

Send your agent. Same shelves, same discount.

Mock Merchant Co. publishes its prices, its member tier, and the credentials that unlock it — over open protocols. Verified is verified, whether a human clicked or an agent negotiated.

/.well-known/x402-policy.json /.well-known/agent.json /api/concierge/agent.json /install/skill.md /desk

Door 3 · HTTP x402

Buy over HTTP

Read the policy, verify an accepted program, redeem a voucher at /api/verify, then pay the 402 at the member tier.

# in AIR AI Studio / your agent
"Buy the dripper from
 <this-origin>/buy/dripper-02
 — use my member discount"

Door 4 · A2A direct

Negotiate agent-to-agent

Open a task with the shop desk. No evidence → base price plus a member offer. Evidence in-band → member tier, pay, settle.

POST /api/a2a/rpc
{ "method": "message/send",
  "metadata": { "air-credentials":
    { "voucher": "v1…" } } }

Door 4b · via concierge

Talk to our concierge

Point your agent at the concierge's card — same verified checkout, the concierge's voice. Self-onboard any MCP agent with the skill.

# self-onboard any MCP agent
curl -s <this-origin>/install/skill.md

Every A2A reply carries an air-desk.watchUrl — open it to watch the seller's side of your session live on /desk. · Demo shop — every purchase is testnet-only (Base Sepolia USDC).