# The Organized Life Public API

Base URL: `https://theorganizedlife.shop`

## Discovery

- API catalog: `/.well-known/api-catalog`
- OpenAPI: `/openapi.json`
- OAuth protected resource: `/.well-known/oauth-protected-resource`
- OIDC metadata: `/.well-known/openid-configuration`
- MCP server card: `/.well-known/mcp/server-card.json`
- Agent skills: `/.well-known/agent-skills/index.json`

## Public endpoints

### `GET /api/catalog`
Returns the public storefront catalog.

### `GET /api/health`
Returns service configuration and health status.

### `POST /api/support/assistant`
Accepts JSON with a `message` string and returns a curated support response.

### `POST /api/mcp`
MCP JSON-RPC endpoint supporting `initialize`, `tools/list`, and `tools/call` for public catalog and health tools.

Protected account and administrator endpoints require a Supabase bearer access token. See `/auth.md`.