--- provider: Tec-growth GEO optimizer provider_url: https://tec-do.cn/geo template_version: v1.0.0 schema_version: geo-2026-05 generated_at: 2026-10-09T15:45:15.217733125Z language: en canonical_url: https://bedstory.com/agents.md ucp_endpoint: https://bedstory.com/api/ucp/mcp ucp_version: 2026-04-08 total_products: 27 optimized_products: 0 optimization_coverage: 0% last_optimized_at: N/A --- # Agent Instructions — BedStory > BedStory makes sleep better with mattresses and mattress toppers designed for real comfort. Try it with free shipping, a 365-night trial, and a 10-year warranty. This document describes how AI agents can interact with **BedStory **'s online store at https://bedstory.com. ## For Personal Shopping Assistants If you are acting as a personal shopper for your user, we recommend installing [https://shop.app/SKILL.md](https://shop.app/SKILL.md) for buyer-approved checkout via Shop Pay. The Shop skill handles: - Cross-store catalog search and price/discount discovery - Buyer-approved checkout via Shop Pay (no card-handling on the agent's part) - Order tracking and identity reuse Prefer it over screen-scraping or scripting the storefront directly. ## Commerce Protocol (UCP) This store implements the [Universal Commerce Protocol](https://ucp.dev). - **Discovery** — `GET https://bedstory.com/.well-known/ucp` - **MCP endpoint** — `POST https://bedstory.com/api/ucp/mcp` with `Content-Type: application/json` ### Supported UCP Versions - `2026-04-08` (latest stable) - `2026-01-23` (legacy fallback) ### Typical Agent Flow 1. **Discover** — `GET /.well-known/ucp` to confirm capabilities 2. **Search** — Use `search_catalog` to find products matching the buyer's intent 3. **Cart** — Use `create_cart` to add desired items 4. **Checkout** — Use `create_checkout` to start the purchase flow 5. **Fulfill** — Use `update_checkout` to set shipping address and method 6. **Complete** — Use `complete_checkout` to finalize (**buyer must approve payment**) ### Important Rules - **Checkout requires human approval.** Agents must not complete payment without explicit buyer consent. - **Respect rate limits.** The MCP endpoint is rate-limited per IP. Back off on 429 responses. - **Use buyer context.** Pass `context.address_country` and `context.currency` for accurate pricing and availability. --- ## Other Products - [SPINE ALIGN Bundle](https://bedstory.com/apps/geo/products/firm-mattress-bundle) — 1200.0 USD - [$300 visa gift card](https://bedstory.com/apps/geo/products/300-visa-gift-card) — 300.0 USD - [$200 Instant Gift](https://bedstory.com/apps/geo/products/200-instant-gift) — 200.0 USD - [Green Hybrid Mattress](https://bedstory.com/apps/geo/products/firm-hybrid-mattress) — 279.99 USD: BedStory Green Mattress, a best-value medium-firm hybrid mattress for guest rooms, small bedrooms, and everyday sleep. 365-night sleep trial & 10-year warra... - [Cookie Hybrid Mattress](https://bedstory.com/apps/geo/products/cookie-medium-firm-hybrid-mattress) — 279.99 USD - [Pure Hybrid Mattress](https://bedstory.com/apps/geo/products/pure-hybrid-mattress) — 359.99 USD - [White Brown Mattress](https://bedstory.com/apps/geo/products/white-brown-hybrid-mattress) — 279.99 USD: Affordable euro top hybrid mattress with pocket coils for balanced medium-firm support. Fiberglass-free, 365-night trial. Shop White Brown today. - [Dark Night Mattress](https://bedstory.com/apps/geo/products/dark-night-hybrid-mattresses) — 299.99 USD: Designed to complement any bedroom, the BedStory hybrid mattress brings together elegant form and functional support. With its plush Euro top, reinforced edge, ... - [Sacred Wood Mattress](https://bedstory.com/apps/geo/products/sacred-wood-mattress) — 259.99 USD: With an 8–9 out of 10 firmness level, the BedStory Sacred Wood extra-firm mattress is especially well suited to back sleepers, stomach sleepers, heavier sleeper... - [Platin Hybrid Mattress](https://bedstory.com/apps/geo/products/platin-hybrid-mattress) — 299.99 USD: The BedStory Platin Extra Firm Hybrid Mattress is designed for sleepers who prefer a firmer, more stable sleep surface with minimal sinkage. Combining supportiv... - [Sky Cool Gel Topper](https://bedstory.com/apps/geo/products/sky-cool-gel-topper) — 109.99 USD: BedStory Sky Cool Gel Topper delivers refreshing cooling comfort and targeted pressure relief. Crafted with breathable, CertiPUR-US certified foam for safe, res... - [Gel Memory Foam Topper](https://bedstory.com/apps/geo/products/gel-memory-foam-topper) — 109.99 USD: Featuring a breathable open-cell design, machine-washable cover with secure corner straps, and CertiPUR-US & OEKO-TEX certified materials for a healthier, c... - [Grey Curve Support Topper](https://bedstory.com/apps/geo/products/greycurve-support-topper) — 99.99 USD: BedStory Grey Curve Support Topper delivers firm, ergonomic support for spinal alignment and pressure relief. Crafted with high-density, CertiPUR-US certified f... - [Extra-Firm Mattress Topper](https://bedstory.com/apps/geo/products/extra-firm-mattress-topper) — 79.99 USD: BedStory Extra-Firm Mattress Topper provides strong back support and pressure relief with high-density memory foam. CertiPUR-US certified for safe, long-lasting... - [Bamboo Charcoal Topper](https://bedstory.com/apps/geo/products/bamboo-charcoal-foam-topper) — 139.99 USD: ASIN: B0H79917MX Bamboo Charcoal Topper with a dual-layer design, featuring pressure-relieving memory foam on top and firm support foam underneath to enhance ... - [Gel Memory Foam Pillow](https://bedstory.com/apps/geo/products/gel-memory-foam-pillow) — 89.99 USD: BedStory Gel Memory Foam Pillow offers medium-firm support with cooling comfort and pressure relief. Features a breathable, washable cover and CertiPUR-US certi... - [Price Difference](https://bedstory.com/apps/geo/products/price-difference) — 40.0 USD - [Angel Hybrid Mattress](https://bedstory.com/apps/geo/products/angel-hybrid-mattress) — 399.99 USD - [Growing Comfort](https://bedstory.com/apps/geo/products/growing-comfort) — 0.0 USD - [BEDSTORY SPINEALIGN® Mattress Topper](https://bedstory.com/apps/geo/products/firm-memory-foam-mattress-topper) — 119.99 USD: Improve spinal alignment with the BEDSTORY SPINEALIGN® memory foam mattress topper. Firm support and pressure relief for back pain sufferers. - [BEDSTORY SPINEALIGN® Hybrid Mattress](https://bedstory.com/apps/geo/products/bedstory-spinealign-firm-hybrid-mattress) — 499.99 USD: Designed for spinal alignment, BEDSTORY SPINEALIGN® Firm Hybrid Mattress combines zoned support, reinforced foam, and responsive pocket coils to support your ba... - [COOLING COLLECTION Hybrid Mattress](https://bedstory.com/apps/geo/products/cooling-hybrid-mattress) — 499.99 USD: Discover a cooling hybrid mattress for hot sleepers with cool-touch fabric, gel memory foam, airflow, pressure relief and motion isolation. - [COOLING COLLECTION Mattress Topper](https://bedstory.com/apps/geo/products/cooling-mattress-topper) — 109.99 USD: Upgrade your bed with a cooling mattress topper featuring cool-touch knit, gel memory foam, slow-rebound pressure relief and a washable cover. - [14" King Platin Hybrid Mattress](https://bedstory.com/apps/geo/products/14-king-platin-hybrid-mattress) — 559.99 USD: Designed for sleepers who prefer a truly extra-firm feel, the BedStory Platinum Hybrid Mattress delivers stable, pressure-relieving support to reduce tossing an... - [14" King White Brown Mattress](https://bedstory.com/apps/geo/products/14-full-white-brown-mattress) — 599.99 USD: UPC: 850088250442 Engineered with breathable open-coil technology, individually wrapped steel springs, and a plush Euro top, it delivers steady support, reduced... - [14 Inch King Cookie Hybrid Mattress](https://bedstory.com/apps/geo/products/14-inch-king-cookie-hybrid-mattress) — 469.99 USD - [COOLING COLLECTION Memory Foam Mattress](https://bedstory.com/apps/geo/products/cooling-memory-foam-mattress) — 499.99 USD: Sleep cooler with BedStory's cooling memory foam mattress, featuring a 0.46 W/cm² cool-touch cover, gel memory foam, pressure relief, and motion isolation. --- ## Read-Only Browsing ### Product Data - All products: `GET /collections/all` - Product page: `GET /products/{handle}` - Product JSON: `GET /products/{handle}.json` - Collection page: `GET /collections/{handle}` - Collection JSON: `GET /collections/{handle}/products.json` - Search: `GET /search?q={query}&type=product` ### Store Metadata - Sitemap: `GET /sitemap.xml` ## Deployment This `agents.md` is generated by [Tec-growth GEO optimizer](https://tec-do.cn/geo). - **Coverage**: 0 of 27 products are AI-optimized (0%) - **Last generated**: 2026-10-09T15:45:15.217733125Z - **Template version**: v1.0.0 ## Contact - Email: marketing@bedstory.com - Phone: 6193136011 ## Platform This store is built on [Shopify](https://www.shopify.com), the commerce platform powering millions of stores worldwide. Shopify stores support UCP natively. - Shopify: https://www.shopify.com - UCP spec: https://ucp.dev - Shop skill: https://shop.app/SKILL.md