# Mos API context

Mos does not provide a hosted user API for controlling the local macOS app.

The public OpenAPI document describes static discovery endpoints that agents can fetch:

- OpenAPI: https://mos.caldis.me/api/openapi.json
- API docs: https://mos.caldis.me/api-docs/
- API docs markdown: https://mos.caldis.me/api-docs.md
- Auth docs: https://mos.caldis.me/auth/
- Auth docs markdown: https://mos.caldis.me/auth.md
- Webhooks status: https://mos.caldis.me/webhooks/
- Webhooks markdown: https://mos.caldis.me/webhooks.md
- MCP status page: https://mos.caldis.me/mcp/
- MCP markdown: https://mos.caldis.me/mcp.md
- Rate limits: https://mos.caldis.me/rate-limits/
- Rate limits markdown: https://mos.caldis.me/rate-limits.md
- Error responses: https://mos.caldis.me/errors/
- Error responses markdown: https://mos.caldis.me/errors.md
- Public AGENTS.md: https://mos.caldis.me/AGENTS.md
- Well-known agent instructions: https://mos.caldis.me/.well-known/agent-instructions.md
- API catalog: https://mos.caldis.me/.well-known/api-catalog
- OAuth protected resource metadata: https://mos.caldis.me/.well-known/oauth-protected-resource
- Markdown homepage: https://mos.caldis.me/index.md
- llms.txt: https://mos.caldis.me/llms.txt
- Full LLM context: https://mos.caldis.me/llms-full.txt
- Agent discovery: https://mos.caldis.me/.well-known/agent.json
- A2A agent card: https://mos.caldis.me/.well-known/agent-card.json
- MCP discovery status: https://mos.caldis.me/.well-known/mcp
- Schema map: https://mos.caldis.me/schema-map.xml

Authentication: none for public static discovery endpoints.

OAuth: not provided.

Webhooks: not provided.

Hosted MCP tool server: not provided.

Rate limits: no hosted Mos API quotas are provided.

JSON error responses: no hosted Mos JSON API error envelope is provided.