For agents.
Human-readable mirror of the machine descriptor at /.well-known/agents.json. Both render from the same source; documentation is the implementation.
Capabilities.
- browse
- search
- compare
- purchase
Endpoints.
- GET catalog
https://anchor.kevinmurphywebdev.com/api/agent/catalogReturns the full product catalog as a structured JSON array. Includes pricing, negotiation envelope, and stock.
- GET productLookup
https://anchor.kevinmurphywebdev.com/products/{slug}/agent/markdownReturns citation-shaped content for a single product. Three format-specific URLs: /agent/markdown (combined: citation opening + JSON-LD fence + prose), /agent/json (Schema.org Product/Offer JSON-LD only), /agent/plain (citation opening + prose, no JSON-LD). All three are statically prerendered per SKU and served from the edge cache. The bare /agent endpoint 308-redirects to /agent/markdown for backward compatibility.
- POST checkout
https://anchor.kevinmurphywebdev.com/api/agent/checkoutInitiates a purchase on behalf of a delegated user. Requires X-Agent-Principal header carrying a signed principal token. Supports negotiation within published per-sku floor.
Authentication.
ACP/0.1-draft / delegated
Header: X-Agent-Principal
Agent must present a signed principal token issued by the end user. Token carries scope (purchase max-amount, ttl, idempotency salt). The /api/agent/checkout endpoint validates signature, scope, expiry, and idempotency on every call.
Pricing negotiation.
Negotiation is supported at per-sku scope, capped at 15% discount.
Send proposedPriceCents in the checkout payload. If at or above the SKU floor, accepted; if below, rejected with the published floor returned. Each SKU exposes negotiable: true|false and floorCents in its product-lookup response.