# Pages (`mttr_pages`)

Updated October 24, 2026.

## What does mttr_pages do?

The pages of a site from its latest read, with status, clicks from home, words and the rules each fails. It can be narrowed to the pages failing one rule. Any key may make this call, on any public site.

Who may call it: Any key.

## When to use it

- You want to see which pages a fix touches.
- You want the pages that fail one rule.

## What you ask

You might say: “Which pages on example.com fail the sources rule?”

```
mttr_pages({ site: "example.com" })
```

| Argument | Type | Needed | What it is |
| --- | --- | --- | --- |
| `site` | Text | Yes | The site, as a domain such as example.com. |
| `failing` | Text | No | A rule id. Only pages failing that rule. |
| `q` | Text | No | Text the path must contain. |
| `kind` | One of these: home, article, service, page | No | Only pages of this kind. |
| `section` | Text | No | Only pages in this section, such as /guides. |
| `sort` | One of these: path, kind, depth, words, ms, inlinks, failing | No | What to sort by. |
| `dir` | One of these: asc, desc | No | Which way to sort. |
| `limit` | Number | No | How many to return. |
| `offset` | Number | No | How many to skip, for the next part of a long list. |

## What comes back

- Each page with its status, depth, words and failing rules.

A sample, with made-up sites and figures:

| Page | Status | Clicks | Words | Fails |
| --- | --- | --- | --- | --- |
| /guides/drain-cleaning | 200 | 2 | 1,240 | 2 |
| /guides/septic-care | 200 | 2 | 980 | 1 |
| /contact | 200 | 1 | 140 | 0 |

## Over HTTP

```
curl "https://mttr.si/api/v1/sites/example.com/pages" \
  -H "Authorization: Bearer $MTTR_KEY"
```

## When it fails

| When | Status | What to do |
| --- | --- | --- |
| Your assistant has no key yet | 401 over MCP | Sign up with `mttr_signup`, then connect again with the key it gives. |
| mttr has no public report of the site yet | 404 | Ask for a read with `mttr_rescan`, then watch it with `mttr_job`. |

## Sources

- [Model Context Protocol: tools](https://modelcontextprotocol.io/specification/2025-06-18/server/tools), Model Context Protocol: How an assistant calls a tool.

The call in full: [mttr_pages in the API reference](https://mttr.si/docs/reference#mttr_pages).

## Goes with

- [One page](https://mttr.si/docs/tools/page.md)
- [Map of a site](https://mttr.si/docs/tools/map.md)