Files for agents
Machine-readable files, each for a different consumer.
| File | For |
|---|---|
/SKILL.md |
The agent manifest. Written for a model. |
/llms.txt |
A short index: what Weir is, how to connect, every endpoint. |
/llms-full.txt |
All of these docs in one file, with every endpoint's price. |
/openapi.json |
The full contract, OpenAPI 3.1. Generate clients from it. |
This documentation site serves its own /llms.txt and /llms-full.txt too, built from the same
pages you are reading.
Every page here is also Markdown
Append .md to any URL:
/pagination → the page
/pagination.md → the same content, as Markdown
Including the generated endpoint pages. It is the exact string the HTML was built from, so the two cannot disagree.
SKILL.md
Point an agent at it and it integrates without reading anything else. It covers what human documentation leaves out because a person infers it: when not to call the API, which mistakes cost money, and which errors are a dead end.
It also resolves at /skill.md and /Skill.md.
The contract
Generated from the route definitions and guarded by a test that fails the build if the two drift.
- Genuinely 3.1. Nullability is a type union, not the removed
nullablekeyword, so X's nullable counts generate as nullable in your client. - Every operation's price is in it. The
x-weir-billingextension gives the credits per call, the credits per returned item, and the rate-limit weight. The reference pages read it from there, so a price shown here is the price charged. - Stable
operationIds. One name per operation, everywhere.searchRedditis the reference page/reference/reddit/searchRedditand the MCP toolsearch_reddit.
Where to read it
| Surface | For |
|---|---|
| Reference pages | Reading. One page per operation, with its price. |
/openapi.json |
Generating a client. |
| Console | Running a real request and seeing what it cost. |