help
Do I need an llms.txt for my API?
It is cheap and harmless, and it can help machine consumers orient. It is not a substitute for a precise OpenAPI, and nothing enforces what it says — treat it as a signpost, not a control.
smart_toy
AI & Agents 7
MCP, agent readiness, agent skills, copilots, and what changes when the primary consumer of your API is not a person.
search
help
How do I version an MCP server without breaking agents?
Treat the tool name and description as the contract. There is no version negotiation in the protocol, so renaming a tool or rewriting its description is a breaking change even when your HTTP API did not move.
help
What are agent skills, and how are they different from APIs?
A skill is a packaged, self-describing unit of what you let someone accomplish. It is the same question I have been asking since 2016 — what does your API actually let me do — with a new name and, finally, an audience...
help
What does "agent-ready" actually mean for an API?
A precise machine-readable contract, clean schema, task-shaped capabilities, honest descriptions, documented errors and limits, and a way for a machine to discover all of it. It is the API discipline you already knew,...
help
What is a capability, and why not just say API?
A capability is a human- and machine-readable definition of something the business can do. The test is that it has to matter to technical and non-technical stakeholders alike — which "API" usually does not.
help
Will AI agents replace the need for APIs?
No. Agents are API consumers — the most demanding ones yet. What changes is that the quality of your contract, schema and documentation now determines whether a machine can use you at all.