# BakeriesAI.com — AI-readable bakery marketplace

BakeriesAI.com is a marketplace of independent bakeries. This site exposes
structured, machine-readable catalog, pricing, serving-size, availability,
allergen, and ordering data for AI assistants, search engines, and shopping agents.

## Bakeries
- Buttercream — https://bakeriesai.com/bakery/buttercream
- Muddy Paws Cheesecake — https://bakeriesai.com/bakery/muddy-paws
- Queen of Cakes — https://bakeriesai.com/bakery/queen-of-cakes
- Thirsty Whale Bakery — https://bakeriesai.com/bakery/thirsty-whale
- YoYo Donuts — https://bakeriesai.com/bakery/yoyo-donuts

## Query API — ask a question, get matching products with order links

Search products (keyword, serving size, occasion, dietary):
  GET https://bakeriesai.com/api/search?q=birthday+cake&servings=20&occasion=birthday
  Parameters: q, product_type (or category), servings, occasion, company_id, needed_by, lead_time_hours

Recommendations (ranked matches for a request):
  GET https://bakeriesai.com/api/recommendations?q=chocolate+cake&servings=12

Order intent (checkout link for a specific product + serving count):
  POST https://bakeriesai.com/api/order-intent
  Body: {"product_id": 123, "servings_needed": 20}

Agent order request (natural language -> product match + checkout link):
  POST https://bakeriesai.com/api/agent/order-request
  Body: {"customer_request": "birthday cake that serves 20"}

Example questions these answer:
- "Find a birthday cake that serves 20"
- "What gluten-free desserts are available?"
- "Which items ship nationwide?"
- "I need a cake for 12 people by Friday"

## MCP server (for AI agents)
Model Context Protocol endpoint — Streamable HTTP, JSON-RPC 2.0:
  POST https://bakeriesai.com/mcp
Add it in an MCP-capable client (Claude, ChatGPT, etc.) as a remote/Streamable-HTTP
server with the URL above. No auth — it's public and read-only.

Tools (query accepts natural language — occasion, servings, dietary needs, and
budget are parsed from the text; structured params are optional refinements):
  - search_products(query, servings, occasion, exclude_allergens, fulfillment)
  - recommend(occasion, servings, query, exclude_allergens)
  - get_product(id)
  - check_availability(id, servings, needed_by)
  - compare(ids | query, servings)
  - find_under_budget(max_price, query, servings, exclude_allergens)
  - list_categories()
  - list_bakeries()
  - get_bakery(slug | name)
Resources:
  - marketplace://overview      (bakeries + categories)
  - bakery://{slug}             (one per bakery)
Prompts:
  - occasion-gift(occasion, servings, dietary)
  - dietary-safe-order(allergens, occasion)
Every product result includes an order_url that routes the customer to that
bakery's own checkout.

## Bulk feeds
- Products (JSON):     https://bakeriesai.com/ai/products.json
- Menu:                https://bakeriesai.com/ai/menu.json
- Google Shopping feed:https://bakeriesai.com/ai/google-merchant.xml
- Schema.org JSON-LD:  https://bakeriesai.com/ai/schema/products.jsonld
- Locations:           https://bakeriesai.com/ai/locations.json
- Shipping:            https://bakeriesai.com/ai/shipping.json
- Allergens:           https://bakeriesai.com/ai/allergens.json
- Per bakery:          https://bakeriesai.com/ai/companies/{slug}/products.json
- Bakery knowledge:    https://bakeriesai.com/ai/companies/{slug}/knowledge.json
- Bakery knowledge LD: https://bakeriesai.com/ai/companies/{slug}/knowledge.jsonld

## Knowledge base — bakery questions answered by the bakeries themselves
Every question has ONE permanent page carrying every bakery's answer, attributed
and dated. Products in an answer carry an order_url you can send a customer to.
- All knowledge:       https://bakeriesai.com/ai/knowledge.json
- One question:        https://bakeriesai.com/ai/knowledge/{question-slug}.json
- Question index:      https://bakeriesai.com/ai/questions.json
- Categories:          https://bakeriesai.com/ai/categories.json
- Search it:           https://bakeriesai.com/ai/knowledge/search?q=can+cheesecake+be+frozen
- Every AI surface:    https://bakeriesai.com/ai/sitemap.xml
- Human pages:         https://bakeriesai.com/knowledge/{question-slug}  (QAPage JSON-LD, machine summary)
https://bakeriesai.com/ai/products.json cross-references each product to the questions answered
about it, so you can go product -> knowledge in one hop.

## Structured data on pages
Every product and bakery page also embeds inline schema.org JSON-LD:
Product (with offers, aggregateRating, reviews, and serving sizes) and
Bakery/Organization (with product offers).

## Data notes
- Unknown numeric values are null, not 0.
- Catalog data is synchronized from each bakery's own Square account.
- Serving sizes are provided as min/max ranges where known.
- To send a customer to purchase, use the product's checkout/order link;
  payment is completed on that bakery's own Square checkout.

## Sitemaps
- https://bakeriesai.com/sitemap.xml