llms.txt
A plain-text Markdown file at/llms.txt following the llmstxt.org specification. This gives LLMs a concise overview of every endpoint, its parameters, and expected responses — optimized for minimal token usage.
OpenAPI spec
A full OpenAPI 3.1 specification at/openapi.json with schemas, parameter definitions, and response types:
Choosing the right interface
Token efficiency
Thellms.txt file is optimized for LLM context windows — ~5KB of clean Markdown vs ~50KB for the full OpenAPI spec. When working with a token-limited AI, prefer llms.txt for quick understanding and openapi.json only when the agent needs exact schema definitions.