# 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 and save more), 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://app.usecrateful.com/openapi.json
- API docs (Swagger): https://app.usecrateful.com/docs
- Fuller LLM context: https://app.usecrateful.com/llms-full.txt
- Release notes: https://app.usecrateful.com/api/release-notes
- MCP endpoint (hosted): https://app.usecrateful.com/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
Merchants have no password. A session starts when the merchant opens Crateful from
their OpoShop admin (the app connects to the store there). API calls then send the
session as `Authorization: Bearer <token>` on /api/* requests; the /mcp endpoint
takes the caller's own OpoShop store token the same way.