# Folio

Private website evaluations and Astra search observations.

- [Agent API guide](/docs/api/reference.md): Authentication, saved results, 24-hour freshness, explicit starts, and recovery.
- [OpenAPI](/api/openapi.json): Machine-readable HTTP contract.
- [API reference and keys](/docs/api): Human reference and signed-in key management.
- Published index over MCP (Streamable HTTP, no key): POST /api/index-mcp. Tools: folio_index_overview, folio_index_search, folio_index_answer, folio_index_website. Read-only saved AI answers to buyer questions; positions are the order in one saved answer, not a search ranking.

GET requests never create paid evaluations. Read the API guide before using an evaluate-enabled key.