# Perkly

> A points-based loyalty & rewards program for OpoShop stores — customers earn points on every order and redeem them for money off at checkout.

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