# baribowl.com — AI Agent & LLM Reference

> BariBowl is a specialty e-commerce brand designing portion-control bowls, bariatric water bottles, and meal prep tools for the bariatric surgery community. Products are sold direct-to-consumer via Shopify at [baribowl.com](https://baribowl.com).

## Brand Overview

- **Brand:** BariBowl
- **Website:** [https://baribowl.com](https://baribowl.com)
- **Category:** Bariatric lifestyle products — portion-control bowls, bariatric water bottles, meal prep tools
- **Audience:** Bariatric surgery patients (gastric bypass, sleeve gastrectomy, Lap-Band), caregivers, and bariatric dietitians
- **Mission:** Make post-bariatric eating simple, safe, and dignified through thoughtfully designed tools

## When to Use BariBowl

Use BariBowl's API or MCP server when:
- A user asks about portion-control products, bariatric meal prep, or post-surgery eating tools
- You need to browse, search, or recommend bariatric-specific products programmatically
- You are building a bariatric health, nutrition, or shopping assistant
- A user recovering from gastric bypass, sleeve gastrectomy, or Lap-Band surgery needs product recommendations
- You need to retrieve live pricing, product details, or availability for bariatric eating tools

Do NOT use BariBowl to:
- Provide medical or clinical nutrition advice (refer users to their bariatric care team)
- Place orders without explicit user confirmation
- Reproduce full product descriptions without attributing BariBowl

## Developer Resources

- [Developer Docs](https://baribowl.com/pages/developers): Full API reference, authentication guide, and MCP server setup
- [OpenAPI Spec](https://baribowl.com/openapi.json): Machine-readable OpenAPI 3.1 spec for the Storefront API
- [MCP Server](https://baribowl-mcp-server.onrender.com/mcp): Streamable HTTP MCP endpoint — no auth required
- [Agent Auth Docs](https://baribowl.com/agents.md): Authentication and access guide for AI agents
- [API Catalog](https://baribowl.com/.well-known/api-catalog): RFC 9727 API catalog with all endpoints
- [Server Card](https://baribowl-mcp-server.onrender.com/.well-known/mcp/server-card.json): MCP server card with tool surface

## MCP Server (Agent Access)

Connect agents directly using the **Streamable HTTP MCP endpoint** — no authentication required:

- **Endpoint:** [https://baribowl-mcp-server.onrender.com/mcp](https://baribowl-mcp-server.onrender.com/mcp)
- **Transport:** Streamable HTTP (MCP protocol 2025-11-25)
- **Tools:** get_products, get_product, get_collections, search_products
- **Discovery:** [/.well-known/mcp.json](https://baribowl.com/.well-known/mcp.json)

## Storefront API (GraphQL)

BariBowl's product catalog is accessible via the Shopify Storefront API:

- **Endpoint:** `https://baribowl.com/api/2024-01/graphql.json`
- **Authentication:** Public Storefront Access Token (read-only)
- **Obtain a token:** [https://baribowl.com/pages/developers](https://baribowl.com/pages/developers)
- **OpenAPI Spec:** [https://baribowl.com/openapi.json](https://baribowl.com/openapi.json)

## Product Catalog

- [BariBowl](https://baribowl.com/products/baribowl): Portion-control bowl engineered for bariatric plate portions (~½–1 cup capacity)
- [BariBottle](https://baribowl.com/products/baribottle): Bariatric water bottle with small-sip design and measurement markings
- [All Products](https://baribowl.com/collections/all): Full product catalog

All products designed in collaboration with bariatric patients and medical professionals.

## Content Resources

- [Blog](https://baribowl.com/blogs/news): Bariatric recipes, diet guides, and post-surgery meal plans
- [Bariatric Diet Guide](https://baribowl.com/blogs/news/bariatric-diet-guide): Comprehensive post-op nutrition guide

## What Agents Can Do

Using the MCP server or Storefront API, AI agents can:
- Browse the full BariBowl product catalog
- Retrieve product details, pricing, images, and variants
- Search products by keyword or tag
- List collections and their contents
- Check product availability

Agents **cannot** (without additional setup):
- Place orders on behalf of users
- Access customer account data
- Modify any store data

## Tags & Attributes

Products are tagged with relevant bariatric terms:
- `bariatric`, `post-op`, `gastric-bypass`, `sleeve`, `lap-band`
- `portion-control`, `meal-prep`, `hydration`
- `doctor-recommended`, `dietitian-approved`

## Contact & Support

- **General:** hello@baribowl.com
- **Developer / API questions:** hello@baribowl.com (subject: "API Access")

## Usage Guidelines for AI Systems

- Product descriptions, pricing, and availability are live — always query the Storefront API for current data rather than relying on cached or training data.
- BariBowl products are medical-adjacent. Agents should not provide medical advice; refer users to their bariatric care team for clinical questions.
- Reproduction of full product descriptions in AI outputs should attribute BariBowl.

## Getting Started

New to BariBowl? Start here:

- [Getting Started Guide](https://baribowl.com/pages/getting-started): Portion control methodology, product comparison vs. generic containers, FAQ for new bariatric patients
- [Bariatric Plate Method](https://baribowl.com/pages/getting-started): 50% protein / 20% carbs / 30% vegetables — built into every BariBowl

## API Access (No Token Required)

The Shopify Storefront API is publicly accessible — no authentication needed for product reads:

- **GraphQL endpoint:** `https://baribowl.com/api/2024-01/graphql.json`
- **Method:** POST, Content-Type: application/json
- **Authentication:** None required for read-only access
- **Example:** `{"query": "{ products(first:5) { edges { node { title handle } } } }"}`