# Agent-readable docs checklist

An agent can only call what it can parse. Publish these before you expect one to find the route.

- [ ] Stable HTTPS URL. No tunnel host, no localhost, no URL that changes every deploy.
- [ ] llms.txt at the site root, served as text/plain. Say what the API does, the paid URL, the method, and that the price is in the HTTP 402.
- [ ] The same facts in llms.txt and on the human page. Do not let them disagree.
- [ ] OpenAPI (or another machine-readable schema) with the path, the method, and the response shape.
- [ ] One working example input, and a sample of the real response. Use a real value. A placeholder is not an example.
- [ ] The method is named. GET or POST. A route with no inputs can be a GET that already returns 402.
- [ ] Errors use a real HTTP error status. Do not return HTTP 200 with an empty body when the call failed.
- [ ] The paid path asks for no API key and no account. The HTTP 402 is the gate.
- [ ] Price, network, and payTo are visible on the unpaid 402 before any payment is signed.
- [ ] A contact method for the person who maintains the route.
