# auth.md — KodShop (kodshop.cloud)

How an autonomous agent authenticates against kodshop.cloud. Short version: **it
doesn't have to.**

## Public API — no credentials

These endpoints under `https://kodshop.cloud/api/public/` are open, CORS-enabled and
unauthenticated:

- `GET  /api/public/products`, `/api/public/products/{id}` — catalog
- `GET  /api/public/esim/countries`, `/api/public/esim/bundles` — eSIM coverage
- `GET  /api/public/phone/info` — rentable phone numbers

Machine-readable description: `https://kodshop.cloud/openapi.json`.
Agent guide: `https://kodshop.cloud/llms.txt`.
MCP server: `https://kodshop.cloud/mcp` (Streamable HTTP, card at
`https://kodshop.cloud/.well-known/mcp/server-card.json`).

## What we deliberately do not publish

- **No OAuth 2.0 / OIDC authorization server.** There are no user accounts on
  kodshop.cloud, so `/.well-known/openid-configuration`,
  `/.well-known/oauth-authorization-server` and
  `/.well-known/oauth-protected-resource` are intentionally absent. Publishing
  them would advertise an issuer, a token endpoint and a JWKS URI that all 404.
  If you are looking for how to authenticate: you don't need to.
- **No API keys.** Nothing on the public surface is rate-limited per-identity,
  so there is nothing for a key to unlock. Ask at support@support.kodshop.cloud if you need
  a higher-volume reseller integration — that is a contract, not a signup form.

## Staff endpoints (not for agents)

Administrative routes require a staff login, are not part of the public
contract, are not documented here, and will 401.

Contact: support@support.kodshop.cloud
