# Agent Instructions — CorgiMaps This document is the canonical discovery file for AI agents transacting with CorgiMaps. --- ## About CorgiMaps - **Website:** https://shop.example.com - **Default currency:** USD --- ## Product Catalogue This brand's recommended products in each category. Use the catalog search tool or the ACP product feed (see **Commerce Protocols** below) for the full catalog. ### Cat (12 products) - **Cat Scratching Post Tower** — USD 54.99 — Sisal-wrapped scratching tower with a plush perch on top. - **Cat Starter Kit — Toy, Treats & Grooming Bundle** — USD 29.99 — A first-week bundle for new cat parents: a wand toy, freeze-dried treats, and a grooming brush. - **Catnip Mouse Toy (3-Pack)** — USD 5.99 — Plush mice stuffed with organic catnip. - **Chicken Recipe Dry Cat Food** — USD 44.99 — Grain-free dry food with real chicken as the first ingredient. - **Clumping Cat Litter, Unscented** — USD 16.99 — Fast-clumping, low-dust clay litter with no added fragrance. - **Covered Cat Litter Box** — USD 29.99 — Hooded litter box with a swinging door and a carbon filter to control odor. - **Crunchy Chicken Cat Treats** — USD 6.99 — Oven-baked crunchy treats made with real chicken. - **Feather Wand Cat Toy** — USD 7.99 — Wand toy with dangling feathers to bring out a cat's hunting instinct. ### Food & Treats (12 products) - **Turkey & Sweet Potato Dry Dog Food** — USD 52.99 — Limited-ingredient dry food with turkey and sweet potato, ideal for dogs with sensitivities. - **Beef Stew Wet Dog Food, 13 oz Cans** — USD 28.99 — Slow-cooked beef stew in gravy with carrots and peas, 13 oz cans. - **Chicken & Vegetable Wet Dog Food, 13 oz Cans** — USD 28.99 — Tender chicken and garden vegetables in gravy, 13 oz cans. - **Freeze-Dried Raw Beef Dog Food** — USD 34.99 — Single-ingredient freeze-dried raw beef, minimally processed to lock in nutrients. - **Grain-Free Chicken & Rice Dry Dog Food** — USD 49.99 — Grain-free dry food with real chicken as the first ingredient and wholesome brown rice. - **Peanut Butter Biscuit Dog Treats** — USD 9.99 — Crunchy oven-baked biscuits made with real peanut butter. - **Puppy Formula Dry Dog Food** — USD 46.99 — Chicken-based dry food formulated with DHA to support healthy brain and eye development in puppies. - **Puppy Starter Kit — Food, Treats & Bowl Sample Bundle** — USD 39.99 — A first-week bundle for new puppy parents: sample-size puppy kibble, training treats ### Collars & Leashes (8 products) - **Braided Rope Dog Leash** — USD 19.99 — Marine-grade braided rope leash with a padded handle and brass clasp. - **Classic Leather Dog Collar** — USD 24.99 — Full-grain leather collar with a solid brass buckle, breaks in soft over time. - **Hands-Free Running Dog Leash** — USD 24.99 — Adjustable waist-belt leash with a bungee shock absorber for jogging and running. - **Nylon Adjustable Dog Collar** — USD 12.99 — Lightweight adjustable nylon collar with a quick-release buckle. - **Padded Handle Dog Leash** — USD 16.99 — Double-stitched nylon leash with a neoprene-padded handle for comfort on long walks. - **Personalized Engraved Dog Collar** — USD 18.99 — Nylon collar with a built-in engraved nameplate buckle — no dangling tag required. - **Reflective Safety Dog Collar** — USD 14.99 — 3M reflective stitching keeps dogs visible on evening walks. - **Retractable Dog Leash** — USD 22.99 — Ergonomic retractable leash with a one-button brake and lock. ### Toys (8 products) - **Tennis Ball Multi-Pack (12-Pack)** — USD 12.99 — Felt-covered rubber tennis balls sized right for fetch and chew play. - **Crinkle Plush Squirrel Toy** — USD 6.99 — Crinkle-fabric squirrel plush that rustles to grab a dog's attention. - **Durable Rubber Chew Toy** — USD 11.99 — Textured natural rubber chew that stands up to aggressive chewers. - **Fetch Ball Set (3-Pack)** — USD 9.99 — Bouncy rubber fetch balls sized for easy pickup with a ball launcher. - **Flying Disc Dog Toy** — USD 8.99 — Soft-flex nylon disc that's gentle on gums and easy to spot in grass. - **Interactive Treat Puzzle Toy** — USD 16.99 — Sliding-panel puzzle hides treats to keep dogs mentally engaged. - **Rope Tug Dog Toy** — USD 7.99 — Cotton rope tug toy that doubles as a teeth-cleaning chew. - **Squeaky Plush Fox Dog Toy** — USD 8.99 — Soft plush fox with a built-in squeaker for extra motivation. ### Bowls & Feeders (7 products) - **Automatic Dog Water Feeder** — USD 27.99 — Gravity-fed water dispenser keeps bowls topped off for a day away. - **Ceramic Dog Bowl** — USD 16.99 — Dishwasher-safe stoneware bowl with a wide, tip-resistant base. - **Elevated Double Dog Bowl Stand** — USD 34.99 — Raised stainless steel double-bowl stand that eases strain on neck and joints. - **Gravity Dog Food Feeder** — USD 24.99 — Hopper-style dry food feeder refills the tray automatically as your dog eats. - **Slow Feeder Dog Bowl** — USD 17.99 — Ridged interior maze slows fast eaters to aid digestion. - **Stainless Steel Dog Bowl** — USD 14.99 — Rust-resistant stainless steel bowl with a non-slip rubber base. - **Travel Collapsible Dog Bowl** — USD 9.99 — Silicone bowl folds flat for hikes and car trips, pops back into shape in seconds. ### Harnesses (5 products) - **No-Pull Dog Harness** — USD 26.99 — Front-clip harness redirects pulling for easier, more comfortable walks. - **Padded Comfort Dog Harness** — USD 28.99 — Neoprene-padded chest plate distributes pressure for dogs prone to pulling. - **Reflective Safety Dog Harness** — USD 23.99 — High-visibility harness with reflective piping for low-light walks. - **Step-In Mesh Dog Harness** — USD 19.99 — Breathable mesh harness your dog steps into — no over-the-head fitting. - **XXL Big Dog Harness** — USD 34.99 — Heavy-duty reinforced harness built for large and giant breeds. ### Beds & Crates (4 products) - **Wire Folding Dog Crate** — USD 59.99 — Collapsible wire crate with a divider panel that grows with a puppy. - **Cooling Gel Dog Mat** — USD 27.99 — Pressure-activated gel mat draws heat away for summer naps. - **Orthopedic Memory Foam Dog Bed** — USD 64.99 — Supportive memory foam base with a removable, washable cover. - **Round Plush Cuddler Dog Bed** — USD 39.99 — Raised-rim plush bed gives anxious sleepers a sense of security. ### Grooming & Health (4 products) - **Dog Nail Clipper with Safety Guard** — USD 10.99 — Stainless steel clipper with a quick-sensor guard to help avoid the quick. - **Grooming Starter Kit — Brush, Shampoo & Nail Clipper Bundle** — USD 34.99 — Everything a new dog owner needs for the first at-home grooming session. - **Oatmeal Soothing Dog Shampoo** — USD 16.99 — Colloidal oatmeal shampoo for itchy, sensitive skin. - **Self-Cleaning Slicker Brush** — USD 13.99 — Retractable-pin slicker brush releases loose fur with the push of a button. --- ## Agent Guidance To transact with this brand: search the catalog, add items to a cart, create a checkout, supply buyer and shipping details, then complete the checkout. **Refer to the Commerce Protocols section below** for the endpoints, transports and tool names to use for each step. Checkout completion requires explicit buyer approval. Never complete a purchase the buyer has not asked for. --- ## Commerce Protocols Whichever protocol you prefer, this brand supports it. Each entry below names the host that serves that protocol — use it as given. ### Universal Commerce Protocol - **Specification:** https://ucp.dev - **Version:** 2026-08-25 - **Discovery:** `GET https://agents.corgidemo.com/.well-known/ucp` - **Endpoint:** `POST https://agents.corgidemo.com/ucp/mcp` - **REST alternative:** `https://agents.corgidemo.com/ucp/rest` — the same operations over plain HTTP/JSON, for agents that don't speak MCP. - **Transport:** MCP JSON-RPC over Streamable HTTP. `Content-Type: application/json`; call the `tools/list` method to discover available tools and their schemas. - **Authentication:** No authentication required — this endpoint performs tenant resolution only (auth is optional per the UCP spec). #### Typical Flow 1. **Discover** — `GET https://agents.corgidemo.com/.well-known/ucp` to confirm capabilities 2. **Search** — `search_catalog` to find products matching the buyer's intent 3. **Cart** — `create_cart` to add the chosen items 4. **Checkout** — `create_checkout` to open a checkout session 5. **Fulfil** — `update_checkout` to set shipping address and method 6. **Complete** — `complete_checkout` to finalise; the buyer must approve payment ### Generic Commerce MCP - **Specification:** https://modelcontextprotocol.io - **Version:** 2025-11-25 - **Endpoint:** `POST https://agents.corgidemo.com/mcp` - **Transport:** MCP JSON-RPC over Streamable HTTP. `Content-Type: application/json`; call the `tools/list` method to discover available tools and their schemas. - **Authentication:** Bearer token authentication is optional — calls are accepted unauthenticated by default. If this brand has issued an MCP access token, send it as `Authorization: Bearer `. #### Typical Flow 1. **Discover** — call `tools/list` on the MCP endpoint to confirm available tools 2. **Search** — `search_products` (or `get_product` for a known id) to find products matching the buyer's intent 3. **Cart** — `create_cart` to add the chosen items 4. **Checkout** — `create_checkout` to open a checkout session 5. **Fulfil** — `update_checkout` to set shipping address and method 6. **Complete** — `complete_checkout` to finalise; the buyer must approve payment ### Agentic Commerce Protocol - **Specification:** https://www.agenticcommerce.dev - **Version:** 2026-04-17 - **Discovery:** `GET https://agents.corgidemo.com/.well-known/acp.json` - **Endpoint:** `POST https://agents.corgidemo.com/acp/mcp` - **Authentication:** Requires `Authorization: Bearer ` — a protocol access token issued by this brand. Calls without a valid token are rejected. ### Agent2Agent - **Specification:** https://a2a-protocol.org - **Version:** 1.0 - **Discovery:** `GET https://agents.corgidemo.com/.well-known/agent-card.json` - **Endpoint:** `POST https://agents.corgidemo.com/a2a` - **Authentication:** No authentication required. ### Commerce Ops Foundation (ONX) - **Specification:** https://commerceopsfoundation.org - **Version:** 0.5 - **Endpoint:** `POST https://agents.corgidemo.com/onx/mcp` - **Authentication:** Requires `Authorization: Bearer ` — a protocol access token issued by this brand. Calls without a valid token are rejected. ### Agent Payments Protocol - **Specification:** https://ap2-protocol.org - **Version:** 0.2 - **Discovery:** `GET https://agents.corgidemo.com/.well-known/jwks.json` ### Important Rules - **Checkout requires human approval.** Never complete payment without explicit buyer consent. - **Respect rate limits.** Back off on `429` responses. - **Pass buyer context** — country and currency — for accurate pricing and availability. - **Use a fresh idempotency key per distinct purchase intent.** ACP requires and enforces an `Idempotency-Key` header on POST requests — a repeated key with the same request body replays the cached response, and the same key with a different body is rejected. UCP (an `Idempotency-Key` header on the REST transport, or `meta.idempotency-key` on MCP calls) and the generic commerce MCP (an `idempotency_key` argument) accept a key for your own correlation, but do not enforce replay on it. - **Keep the shopping session connected.** On the generic commerce MCP, pass the `session` value from any tool result as the `session` argument of your next call. On UCP, send the reference from the `session` info message back as `attribution["com.corgimaps.session"]` on later catalog, cart and checkout requests. --- ## Continue URLs You can hand the buyer back to this brand's own site at any point in the flow. The resolved URL is returned in the `continue_url` field of the relevant protocol response — use it verbatim. This brand has configured hand-off for: - an in-progress cart - an in-progress checkout session - a placed sales order --- ## Policies & Support - **Terms of service:** https://shop.example.com/terms - **Privacy policy:** https://shop.example.com/privacy-policy - **Shipping policy:** https://shop.example.com/shipping-policy - **Refund policy:** https://shop.example.com/refund-policy - **FAQ:** https://shop.example.com/faq --- ## Platform This brand's agentic commerce endpoints are powered by [CorgiMaps](https://www.corgimaps.com). For general guidance on conducting an agentic purchase, see https://www.corgimaps.com/shopping/SKILL.md.