# Maggie's Organics Developer Resources

Machine-readable resources for maggiesorganics.com (Maggie's Organics — organic cotton socks, fair trade apparel, home goods).

## Resources

- [llms.txt](https://maggiesorganics.com/llms.txt) (text/plain): Plain-text overview of the brand, catalog sections, policies, and contact details for LLM agents.
- [OpenAPI 3.1 specification](https://maggiesorganics.com/openapi.json) (application/json): Storefront Cart API and UCP checkout-session endpoints, request/response schemas, and the JSON error envelope. Alias: /api/openapi.json.
- [UCP manifest](https://maggiesorganics.com/.well-known/ucp) (application/json): Universal Checkout Protocol profile (spec 2026-01-23) describing checkout and fulfillment capabilities for AI shopping agents.
- [XML sitemap](https://maggiesorganics.com/xmlsitemap.php) (text/xml): Sitemap index covering products, categories, brands, pages, and blog posts.
- [HTML sitemap](https://maggiesorganics.com/sitemap/) (text/html): Human-readable list of every category and page.
- [robots.txt](https://maggiesorganics.com/robots.txt) (text/plain): Crawl rules. AI crawlers (GPTBot, ClaudeBot, PerplexityBot, and others) are explicitly allowed.

## Authentication

No API key required. Storefront Cart API is cookie/session scoped. UCP write endpoints require Idempotency-Key and Request-Id headers.

## Error handling

API paths return JSON errors: /api/* and /graphql use an envelope with error.code, error.message and error.hint; UCP /checkout-sessions* endpoints return the same messages[] list. Nonexistent pages return HTTP 404; non-HTML clients receive a Markdown body pointing to the sitemap and llms.txt.

## Contact

maggies@organicclothes.com · 800-609-8593