# 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://stg.alva.xyz/)
- [Full LLM context](https://stg.alva.xyz/llms-full.txt)
- [OpenAPI spec](https://stg.alva.xyz/openapi.json)
- [Agent discovery](https://stg.alva.xyz/agent.json)
- [Well-known agent discovery](https://stg.alva.xyz/.well-known/agent.json)
- [Agent Skills index](https://stg.alva.xyz/.well-known/agent-skills/index.json)
- [Developer guide markdown](https://stg.alva.xyz/developers.md)
- [Explore markdown](https://stg.alva.xyz/explore.md)
- [Public discovery MCP](https://stg.alva.xyz/mcp)
- [Machine-readable pricing](https://stg.alva.xyz/pricing.md)
- [Agent authentication](https://stg.alva.xyz/auth.md)
- [Agent onboarding](https://stg.alva.xyz/onboarding.md)
- [Agent sandbox](https://stg.alva.xyz/sandbox.md)
- [Agent status page](https://stg.alva.xyz/status)

## Authenticated surfaces

- Private Alva product APIs and authenticated MCP-style actions outside the public discovery endpoint 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