# Retain

> Branded returns & exchanges portal — exchange-first, revenue-protecting.

This app is built on the EverBee Store 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://retainreturns.fly.dev/openapi.json
- API docs (Swagger): https://retainreturns.fly.dev/docs
- Fuller LLM context: https://retainreturns.fly.dev/llms-full.txt
- Release notes: https://retainreturns.fly.dev/api/release-notes
- MCP endpoint (hosted): https://retainreturns.fly.dev/mcp — add this URL to Claude or any LLM
  client to drive the app in natural language. Auth with your own EverBee 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).