# Alva Status

This is an agent-checkable status and recovery index for Alva public discovery resources.

## Public discovery resources expected to return 200

- [Homepage](https://alva.ai/)
- [Full LLM context](https://alva.ai/llms-full.txt)
- [OpenAPI spec](https://alva.ai/openapi.json)
- [Agent discovery](https://alva.ai/agent.json)
- [Well-known agent discovery](https://alva.ai/.well-known/agent.json)
- [Agent Skills index](https://alva.ai/.well-known/agent-skills/index.json)
- [Machine-readable pricing](https://alva.ai/pricing.md)
- [Agent authentication](https://alva.ai/auth.md)
- [Agent onboarding](https://alva.ai/onboarding.md)
- [Agent sandbox](https://alva.ai/sandbox.md)
- [Agent status page](https://alva.ai/status)

## Authenticated surfaces

- [MCP server](https://mcp.alva.ai) may require user-scoped authentication and can return 401 or 403 until the user authorizes access.
- API endpoints described in `/openapi.json` may require bearer authentication for private account, billing, brokerage, or playbook actions.

## Agent recovery policy

- 400: fix request shape using the OpenAPI schema.
- 401 or 403: ask the user to sign in or grant the required permission.
- 404: verify the URL against `/llms.txt`, `/agent.json`, or `/openapi.json` before retrying.
- 429: back off using `Retry-After` or `RateLimit-Reset`.
- 5xx: stop retries after a small bounded retry budget and report the incident to the user.

Contact: devs@alva.xyz