# Ripply

> Customer referral program for OpoShop stores — refer a friend, start a ripple. Friends save on their first order; referrers earn a reward when it completes.

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://ripply.fly.dev/openapi.json
- API docs (Swagger): https://ripply.fly.dev/docs
- Fuller LLM context: https://ripply.fly.dev/llms-full.txt
- Release notes: https://ripply.fly.dev/api/release-notes
- MCP endpoint (hosted): https://ripply.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).