# Agent Instructions — The DJ Shop This store supports AI-driven catalogue discovery over the Universal Commerce Protocol (UCP). ## Commerce Protocol (UCP) - [UCP Discovery](https://m2-staging-thedjshop-co-uk.cfstack.com/.well-known/ucp) — GET, merchant profile: versions, capabilities - [MCP endpoint](https://m2-staging-thedjshop-co-uk.cfstack.com/agent/mcp) — POST, Content-Type: application/json ### Typical agent flow (v1) 1. Discover — GET /.well-known/ucp 2. Search — search_catalog 3. Inspect — get_product / lookup_catalog 4. Cart — create_cart, then give the shopper the returned continue_url to review and complete (The agent builds the cart; the shopper completes checkout in the browser — checkout requires human approval.) ### Supported UCP versions - 2026-04-08 (latest stable) - 2026-01-23 ### Rules - Pass context.address_country and context.currency for accurate pricing/availability. - Respect rate limits; back off on 429. - Checkout requires human approval. Do not complete payment without explicit buyer consent. ## Read-Only Browsing (No Authentication Required) The store serves these JSON endpoints itself (no auth, no GraphQL dependency): - [Products / search](https://m2-staging-thedjshop-co-uk.cfstack.com/agent/products.json?q={query}&page={n}) — GET - [Single product](https://m2-staging-thedjshop-co-uk.cfstack.com/agent/products/{url_key}.json) — GET - [Category products](https://m2-staging-thedjshop-co-uk.cfstack.com/agent/collections/{url_key}/products.json) — GET - [Sitemap](https://m2-staging-thedjshop-co-uk.cfstack.com/sitemap.xml) — GET - Agent discovery — /agents.md (canonical) and /llms.txt (mirror), plus /.well-known/ucp ## Product Categories - [DJ Equipment Packages](https://m2-staging-thedjshop-co-uk.cfstack.com/dj-equipment/packages) - [CDJ and Multimedia Packages](https://m2-staging-thedjshop-co-uk.cfstack.com/dj-equipment/packages/cd) - [Turntable Packages](https://m2-staging-thedjshop-co-uk.cfstack.com/dj-equipment/packages/turntables) - [Digital DJ Packages](https://m2-staging-thedjshop-co-uk.cfstack.com/dj-equipment/packages/digital-dj-packages) - [Traktor DJ Package Deals](https://m2-staging-thedjshop-co-uk.cfstack.com/dj-equipment/packages/digital-dj-packages/native-instruments-packages/traktor-packages) - [Denon DJ Packages](https://m2-staging-thedjshop-co-uk.cfstack.com/dj-equipment/packages/cd/denon-packages) - [Pioneer Packages](https://m2-staging-thedjshop-co-uk.cfstack.com/dj-equipment/packages/cd/pioneer-packages) - [Bags / Soft Cases / Hard Cases](https://m2-staging-thedjshop-co-uk.cfstack.com/accessories/bags-soft-cases) - [CD Cases and Bags](https://m2-staging-thedjshop-co-uk.cfstack.com/accessories/bags-soft-cases/cd-cases-and-bags) - [DJ CD Pages](https://m2-staging-thedjshop-co-uk.cfstack.com/accessories/bags-soft-cases/cd-cases-and-bags/dj-cd-pages) - [Slappa](https://m2-staging-thedjshop-co-uk.cfstack.com/accessories/bags-soft-cases/cd-cases-and-bags/slappa) - [CD Player Bags](https://m2-staging-thedjshop-co-uk.cfstack.com/accessories/bags-soft-cases/cd-player-bags) - [DJ Controller Bags and Cases](https://m2-staging-thedjshop-co-uk.cfstack.com/accessories/bags-soft-cases/dj-controller-bags-cases) - [Headphone Cases](https://m2-staging-thedjshop-co-uk.cfstack.com/accessories/bags-soft-cases/headphone-cases) - [Keyboard Bags](https://m2-staging-thedjshop-co-uk.cfstack.com/accessories/bags-soft-cases/keyboard-bags) - [Mixer Bags](https://m2-staging-thedjshop-co-uk.cfstack.com/accessories/bags-soft-cases/mixer-bags) - [Record Bags](https://m2-staging-thedjshop-co-uk.cfstack.com/accessories/bags-soft-cases/record-bags) - [Speaker Bags](https://m2-staging-thedjshop-co-uk.cfstack.com/accessories/bags-soft-cases/speaker-bags) - [USB SD Card Accessories Cases](https://m2-staging-thedjshop-co-uk.cfstack.com/accessories/bags-soft-cases/usb-sd-card-accessories-cases) - [Work Stations](https://m2-staging-thedjshop-co-uk.cfstack.com/accessories/bags-soft-cases/work-stations) - [CD Mixer Combo Bags](https://m2-staging-thedjshop-co-uk.cfstack.com/accessories/bags-soft-cases/cd-mixer-combo-bags) - [Courier Bags](https://m2-staging-thedjshop-co-uk.cfstack.com/accessories/bags-soft-cases/courier-bags) - [Headshell Bags](https://m2-staging-thedjshop-co-uk.cfstack.com/accessories/bags-soft-cases/headshell-bags) - [Laptop Bags](https://m2-staging-thedjshop-co-uk.cfstack.com/accessories/bags-soft-cases/laptop-bags) - [Keyboard Cover Serato](https://m2-staging-thedjshop-co-uk.cfstack.com/accessories/bags-soft-cases/laptop-bags/keyboard-cover-serato) - [Laptop Sleeve](https://m2-staging-thedjshop-co-uk.cfstack.com/accessories/bags-soft-cases/laptop-bags/laptop-sleeve) - [Shoulder Strap](https://m2-staging-thedjshop-co-uk.cfstack.com/accessories/bags-soft-cases/laptop-bags/shoulder-strap) - [Laptop Shields](https://m2-staging-thedjshop-co-uk.cfstack.com/accessories/bags-soft-cases/laptop-bags/laptop-shields) - [Laptop Stand Carry Pouch](https://m2-staging-thedjshop-co-uk.cfstack.com/accessories/bags-soft-cases/laptop-bags/laptop-stand-carry-pouch) - [Multi Purpose Bags](https://m2-staging-thedjshop-co-uk.cfstack.com/accessories/bags-soft-cases/multi-purpose-bags) - [Record Boxes](https://m2-staging-thedjshop-co-uk.cfstack.com/accessories/bags-soft-cases/record-boxes) - [Sound Card Cases](https://m2-staging-thedjshop-co-uk.cfstack.com/accessories/bags-soft-cases/sound-card-cases) - [Trolley Bags](https://m2-staging-thedjshop-co-uk.cfstack.com/accessories/bags-soft-cases/trolly-bags) - [Vinyl Storage Units](https://m2-staging-thedjshop-co-uk.cfstack.com/accessories/bags-soft-cases/vinyl-storage-units) - [Bubble Machines](https://m2-staging-thedjshop-co-uk.cfstack.com/bubble-machines) - [Cables and Leads](https://m2-staging-thedjshop-co-uk.cfstack.com/accessories/cables-and-leads) - [Distribution Panels](https://m2-staging-thedjshop-co-uk.cfstack.com/accessories/cables-and-leads/distribution-panels) - [Speaker / Audio Cables](https://m2-staging-thedjshop-co-uk.cfstack.com/accessories/cables-and-leads/speaker-audio-cables) - [USB Midi Cables](https://m2-staging-thedjshop-co-uk.cfstack.com/accessories/cables-and-leads/usb-midi-cables) - [RCA Phono Leads](https://m2-staging-thedjshop-co-uk.cfstack.com/accessories/cables-and-leads/phono-leads) - [USB Audio Cables](https://m2-staging-thedjshop-co-uk.cfstack.com/accessories/cables-and-leads/usb-audio-cables) - [Cartridges and Stylus](https://m2-staging-thedjshop-co-uk.cfstack.com/dj-equipment/cartridges-and-styli) - [Cartridge and stylus kit](https://m2-staging-thedjshop-co-uk.cfstack.com/dj-equipment/cartridges-and-styli/cartridge-and-stylus-kit) - [Gemini](https://m2-staging-thedjshop-co-uk.cfstack.com/dj-equipment/cartridges-and-styli/gemini) - [Headshell Mounted Carts](https://m2-staging-thedjshop-co-uk.cfstack.com/dj-equipment/cartridges-and-styli/headshell-mounted-carts) - [Numark](https://m2-staging-thedjshop-co-uk.cfstack.com/dj-equipment/cartridges-and-styli/numark) - [Replacement Styli](https://m2-staging-thedjshop-co-uk.cfstack.com/dj-equipment/cartridges-and-styli/replacement-styli) - [Stanton](https://m2-staging-thedjshop-co-uk.cfstack.com/dj-equipment/cartridges-and-styli/stanton) - [Concordes](https://m2-staging-thedjshop-co-uk.cfstack.com/dj-equipment/cartridges-and-styli/concordes) - [Headshell Bags](https://m2-staging-thedjshop-co-uk.cfstack.com/dj-equipment/cartridges-and-styli/headshell-bags) ## Store Policies