# llms.txt

> Read these docs as plain markdown, one page, the index, or every page in one file, over HTTP or with the CLI. No account needed.

Every docs page is also plain markdown, written to be read by coding agents.
No account is needed for any of it.

| What                 | URL                                                      |
| -------------------- | -------------------------------------------------------- |
| One page             | `https://mynth.io/docs/<slug>.md`                        |
| The introduction     | [/docs.md](https://mynth.io/docs.md)                                     |
| The index            | [/llms.txt](https://mynth.io/llms.txt)                                   |
| Every page, one file | [/llms-full.txt](https://mynth.io/llms-full.txt)                         |
| The model catalog    | [/models.json](https://mynth.io/models.json), [/models.txt](https://mynth.io/models.txt) |
| The OpenAPI document | `https://api.mynth.io/openapi.json`                      |

## One page

Append `.md` to a docs URL: [/docs/getting-started.md](https://mynth.io/docs/getting-started.md).

The same URL without `.md` also returns markdown when the request asks for
it: an `Accept` header with `text/markdown` or `text/plain` and without
`text/html`. `curl`, `wget`, and `httpie` get markdown when `Accept` is empty
or `*/*`. Browsers send `text/html`, so they still get the page. An unknown
`.md` URL is a plain `404`.

The markdown keeps every code example. Tabbed examples come out as labelled
code blocks, and SDK, REST, and CLI variants of a page come out as separate
"Using the SDK", "Using the REST API", and "Using the CLI" sections.

## The index and the full file

[/llms.txt](https://mynth.io/llms.txt) lists every page in reading order, grouped by section,
with its markdown URL and a one-line description. It ends with links to the
changelog, the model catalog, and the OpenAPI document.

[/llms-full.txt](https://mynth.io/llms-full.txt) is every page in the same order, separated by
`---`. It is large. Prefer the index plus the pages you need.

## With the CLI

```bash
npx @mynthio/cli docs list
npx @mynthio/cli docs get getting-started
npx @mynthio/cli docs get api-reference/webhook-payloads --json
```

`docs list` prints the index and `docs get <slug>` prints one page. The slug is
the URL path after `/docs/`, without `.md`, and `index` is the introduction.
`--json` wraps the output: `{ path, content }` for `get` and `{ content }` for
`list`.

The CLI rejects an empty path, a `.md` suffix, a URL, a query, a fragment, a
backslash, and `..` segments. `MYNTH_DOCS_URL` points it at another host.

## Prices and models change

Pages are cached for up to an hour. Read prices and the model list live from
`GET https://api.mynth.io/models` or [/models.json](https://mynth.io/models.json), and price a
real request with an [estimate](https://mynth.io/docs/guides/estimate-cost.md), rather than
copying numbers out of a page.

## Next steps

- [Agent prompt](https://mynth.io/docs/sdks/agents/agent-prompt.md): a prompt that points an agent at these docs.
- [Skills](https://mynth.io/docs/sdks/agents/skills.md): the Mynth skill for coding agents.