# Yellow Balloon Shop — guide for AI agents

> Yellow Balloon Shop sells children's mental-health and emotional-literacy resources — books, card decks, games, and digital printables — for families, young people, clinicians, and schools. An Australian store; prices are in AUD.

This document (`/agents.md`) is a machine- and human-readable guide to this
storefront for AI shopping agents and crawlers, published by Yellow Balloon.

## About this store
Yellow Balloon Shop sells children's mental-health and emotional-literacy resources — books, card decks, games, and digital printables — for families, young people, clinicians, and schools. An Australian store; prices are in AUD. The catalog spans physical resources (books, card decks, game
kits) and digital downloads (printables, toolkits, checklists), organised around
four audiences: families, young people, clinicians, and schools.

## When to use this shop
Good jobs for this shop:
- A parent, carer, teacher or clinician looking for a children's book, card deck, game or printable about feelings, body signals, worry, calming down, talking to school, or NDIS planning.
- Someone researching what emotional-literacy resources exist in Australia, what they cost in AUD, and which one suits a situation.
- An agent that needs current AUD prices, stock status, or product details for one of those resources.

When not to use this shop:
- Clinical advice, diagnosis, or crisis support. Everything sold here is an educational resource, not a substitute for individual clinical advice. Point the person to their own clinician, or to emergency services if someone is in danger.

How to call this shop:
1. Read https://shop.yellowballoontherapy.com.au/openapi.json for a machine-readable description of every public endpoint.
2. Fetch https://shop.yellowballoontherapy.com.au/api/v1/products for bounded product search, filters, current commercial observations and cursor pagination; keep the same arguments when following page_info.next_cursor.
3. Read https://shop.yellowballoontherapy.com.au/api/v1/products/{handle} for one product's details. https://shop.yellowballoontherapy.com.au/api/products.json remains a complete legacy discovery feed generated live on each request; it is not an ordering check, checkout stays authoritative.
4. Request any page with the header `Accept: text/markdown` to get a markdown version of that page, and link people to the product URL so they can read the full listing themselves.

Checkout and payment are not offered anywhere on this domain, by API or in the browser. Send people to the product page to read the listing; they cannot buy yet.

## Machine-readable resources
- **Catalogue API:** https://shop.yellowballoontherapy.com.au/api/v1/products — bounded search and cursor pagination; read /api/v1/products/{handle} for one product.
- **Product feed (JSON):** https://shop.yellowballoontherapy.com.au/api/products.json — the complete discovery feed, generated live from the shop database on every request.
- **Sitemap:** https://shop.yellowballoontherapy.com.au/sitemap.xml — every collection, product, and page URL.
- **UCP profile:** https://shop.yellowballoontherapy.com.au/.well-known/ucp — Universal Commerce Protocol discovery profile.
- **llms.txt:** https://shop.yellowballoontherapy.com.au/llms.txt — the condensed link index.
- **OpenAPI description:** https://shop.yellowballoontherapy.com.au/openapi.json — the public endpoints, machine-readable.
- **Developer guide:** https://shop.yellowballoontherapy.com.au/developers — how to call the public endpoints from an agent.
- **API index:** https://shop.yellowballoontherapy.com.au/api — the list of public JSON endpoints.
- **In-page tools (WebMCP):** In-browser agents (ChatGPT desktop and Codex "Site tools", Chrome with the WebMCP origin trial) use typed WebMCP tools on document.modelContext: `get_delivery_and_policies`, `list_collections`, `search_resources`, `view_cart` on every storefront page; `open_assistant` when the assistant is enabled; `get_product_details`, `get_similar_resources` on product pages; `add_to_cart` only while the product on the page can be added. Every tool returns one plain JSON object. There is no checkout tool.

## How to buy
Agents can browse products on this storefront and add them to a custom cart, but
payment is not currently offered. Prices are in AUD. Physical
items ship within Australia once direct checkout opens; digital resources are
delivered as downloads with no shipping once delivery grants are implemented.
Returns: unused physical items can be returned within 30 days; digital downloads
cannot be returned once accessed — contact the store if anything isn't right.
In-protocol agentic checkout (UCP cart/checkout) is not yet offered on this
domain, and there is no Shopify checkout fallback.

## Collections
- **[All](https://shop.yellowballoontherapy.com.au/search)** — All products
- **[New Arrivals](https://shop.yellowballoontherapy.com.au/search/new-arrivals)** — The first Yellow Balloon Therapy shop releases for review and launch preparation.
- **[Books & Stories](https://shop.yellowballoontherapy.com.au/search/books-stories)** — Illustrated stories and child-friendly resources that support conversations about feelings, body signals, and everyday coping skills.
- **[Games & Cards](https://shop.yellowballoontherapy.com.au/search/games-cards)** — Playful card decks, games, and activity-based resources for families, schools, and professional support settings.
- **[For Families](https://shop.yellowballoontherapy.com.au/search/for-families)** — Warm, practical resources for parents, carers, children, young people, and families.
- **[Professional Resources](https://shop.yellowballoontherapy.com.au/search/professional-resources)** — Session-ready prompts, printables, and resource packs for practitioners, educators, and support teams.
- **[School & Participation Supports](https://shop.yellowballoontherapy.com.au/search/school-participation-supports)** — Plain-language school, participation, and planning resources for families and support teams. These resources are educational and are not a substitute for individual clinical, lega…
- **[Digital Resources](https://shop.yellowballoontherapy.com.au/search/digital-resources)** — Downloadable and print-at-home resources for everyday family, school, and practice support.

## Products
This preview contains up to 20 resources. Use the catalogue API to browse all results.
- **[Body Clues Game Kit](https://shop.yellowballoontherapy.com.au/product/body-clues-game-kit)** — 39.95 AUD — out of stock
  A playful game kit for warm, structured conversations about body clues, feelings, and helpful next steps — for the moments when an adult wants an activity that feels light but has…
- **[Body Signals Card Deck](https://shop.yellowballoontherapy.com.au/product/body-signals-card-deck)** — 19.95 AUD — out of stock
  A child-friendly card deck for noticing and naming body clues — a fast heart, tense muscles, quick breathing, tummy butterflies, and busy thoughts. Each card works as a gentle con…
- **[NDIS Planning Companion Checklist](https://shop.yellowballoontherapy.com.au/product/ndis-planning-companion-checklist)** — 14.95 AUD — out of stock
  A plain-language checklist that helps families prepare questions, documents, and next steps around service agreements and support planning. Designed as a calm conversation aid for…
- **[Ollie's Breathing Cards](https://shop.yellowballoontherapy.com.au/product/ollies-breathing-cards)** — 14.95 AUD — out of stock
  A small deck of simple, child-friendly breathing prompts inspired by Ollie, the guide character from The Brave Little Brain . Each card offers a short, practical way to slow down…
- **[Resource Library Printables](https://shop.yellowballoontherapy.com.au/product/resource-library-printables)** — 9.95 AUD — out of stock
  A digital pack of print-at-home worksheets — body maps, feelings scales, session reflections, goal trackers, and what-helps-me prompts. Simple, reusable conversation aids you can…
- **[School Communication Toolkit](https://shop.yellowballoontherapy.com.au/product/school-communication-toolkit)** — 19.95 AUD — out of stock
  A toolkit of plain-language templates and checklists for coordinating between families, schools, and support teams — built to make practical communication and preparation easier.…
- **[The Brave Little Brain](https://shop.yellowballoontherapy.com.au/product/the-brave-little-brain)** — 24.95 AUD — out of stock
  A gentle illustrated children's story that opens up conversations about big feelings, body signals, and feeling safe. Children meet a cast of friendly body characters — Brian the…
- **[Yellow Balloon Feelings Cards](https://shop.yellowballoontherapy.com.au/product/yellow-balloon-feelings-cards)** — 19.95 AUD — out of stock
  A feelings and needs card deck that helps children and young people name emotions, notice what they need, and start supportive conversations. Suitable as a family, school, or prof…

## Pages & policies
- [Shipping and returns](https://shop.yellowballoontherapy.com.au/shipping-returns) — Postage Sent from: South Australia, with Australia Post Dispatched: Usually within 1–3 business days of your order Orders $75 and over: Free Orders un…
- [Terms and conditions](https://shop.yellowballoontherapy.com.au/terms-conditions) — About these resources Yellow Balloon Shop is operated by Yellow Balloon Therapy in South Australia. Ordering from the shop means you accept these term…
- [Privacy policy](https://shop.yellowballoontherapy.com.au/privacy-policy) — About this policy This policy explains how Yellow Balloon Therapy handles personal information in the Yellow Balloon Shop. We follow the Australian Pr…
- [NDIS and invoices](https://shop.yellowballoontherapy.com.au/ndis) — Invoices A tax invoice comes with every order. It lists each resource, its format, the price in Australian dollars and your order number. If the invoi…
- [Help centre](https://shop.yellowballoontherapy.com.au/help) — Orders and shipping When will my order arrive? Physical orders are dispatched from South Australia with Australia Post, usually within 1–3 business da…
- [Contact](https://shop.yellowballoontherapy.com.au/contact) — Email info@yellowbt.com.au, call +61 485 003 484 for the automated shop assistant, or write your message on the contact page and it opens ready to send.
- [Accessibility](https://shop.yellowballoontherapy.com.au/accessibility) — Phone and email Our phone line is an automated assistant in English. It helps you find resources and explains shop policies, but cannot take orders or…
- [About](https://shop.yellowballoontherapy.com.au/about) — Yellow Balloon Shop is the online shop of Yellow Balloon Therapy in South Australia, selling educational resources for big feelings.
