# Crateful

> Crateful lets shoppers build their own box on your OpoShop store. You pick the pool of products and the rule — pick any 6, any 6 for $50, or buy-more-save-more tiers — and shoppers fill a crate in a storefront configurator with live running pricing and a progress meter that says exactly what is still needed to unlock the deal. One click adds the whole crate to the cart, and the discount is enforced at checkout only when the crate is genuinely complete.

This app is built on the OpoShop platform. It is agent-friendly: the full
API is described in OpenAPI and wrapped by an MCP server so an LLM can drive it
directly.

## Machine interfaces
- API contract (OpenAPI): https://crateful.fly.dev/openapi.json
- API docs (Swagger): https://crateful.fly.dev/docs
- Fuller LLM context: https://crateful.fly.dev/llms-full.txt
- Release notes: https://crateful.fly.dev/api/release-notes
- MCP endpoint (hosted): https://crateful.fly.dev/mcp — add this URL to Claude or any LLM
  client to drive the app in natural language. Auth with your own OpoShop store
  token via Authorization: Bearer <token>.

## Auth
Get an access token via POST /api/auth/login, then send it as
`Authorization: Bearer <token>` on /api/* requests (and to the /mcp endpoint).