# Givly

> Givly adds checkout donations and round-up to your OpoShop store. At the cart a shopper can round their order up to the next whole dollar for a cause you choose, or add a set amount like $1, $2 or $5, and pays it through your normal checkout. You get a per-order donation ledger, a remittance report that shows exactly what to pay the cause, and an optional storefront counter showing how much your shoppers have raised together.

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.trygivly.com/openapi.json
- API docs (Swagger): https://app.trygivly.com/docs
- Fuller LLM context: https://app.trygivly.com/llms-full.txt
- Release notes: https://app.trygivly.com/api/release-notes
- MCP endpoint (hosted): https://app.trygivly.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
Get an access token via POST /api/auth/login, then send it as
`Authorization: Bearer <token>` on /api/* requests (and to the /mcp endpoint).