I require that every API publishes an llms.txt file at a predictable, well-known location so that large language models and the agents built on them can find a concise, curated map of what the API is and how to work with it. This file should point to the documentation, the OpenAPI, and the entry points that matter, written in plain language a model can actually parse. I care about this because agents are becoming first-class consumers, and if we leave them to guess by scraping marketing pages we get brittle, expensive, and wrong integrations. A small text file, maintained deliberately, is how we stay legible to the machines now reading our APIs.
Agent Readiness with llms.txt
Rules
APIs.json Agent LLMs Txt Info
APIs should link an llms.txt file so AI agents have a curated, machine-readable entry point describing the API and how to work with it. Declaring a property of type LLMsTxt in the APIs.json propert...
Strategies
APIs Are Legible to Automated Consumers
I want our APIs to be legible to the automated consumers reading them, not just to the humans who wrote them. That means operations that describe themselves clearly, tool definitions that spell out...
APIs Are Ready for AI Agents
I want every API we operate to be ready for the agents that are now showing up as first-class consumers alongside our human developers. That means our APIs publish the machine-readable signposts ag...
Experiences
Agent Experience
Agent experience is developer experience for machines. As AI agents become first-class consumers of APIs, the experience they have discovering, understanding, authenticating, and calling an API mat...
Discovery
The average enterprise maintains approximately 0.5 APIs per employee, making it a constant challenge to track the growing inventory of HTTP APIs being produced and consumed. Enterprises often addre...
Lifecycle
travel_explore Discovery Production
Discovery is how APIs get found and reused instead of rebuilt. APIs.json, catalogs, and search make the APIs I operate visible to the people who need them. Good discovery is what turns a pile of AP...
