# Visits (`mttr_visits`)

Updated October 24, 2026.

## What does mttr_visits do?

Who fetched a site’s pages in the last 28 days against the 28 before, counted by the site’s own server: people, people an assistant sent, and crawlers by name, AI crawlers marked. A key may make this call on the sites it has claimed.

Who may call it: Your claimed sites.

## When to use it

- You want to know whether AI crawlers read a site.
- You want to see people sent by assistants.

## What you ask

You might say: “Which AI crawlers fetched example.com this month?”

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

| Argument | Type | Needed | What it is |
| --- | --- | --- | --- |
| `site` | Text | Yes | The site, as a domain such as example.com. |
| `limit` | Number | No | How many to return. |

## What comes back

- Visits by day, by crawler, by assistant and by page.
- The last day an AI crawler fetched each page.
- A crawler fetching a page is not a citation. Only sites whose server sends counts have any.

A sample, with made-up sites and figures:

| Day | Count |
| --- | --- |
| Week 1 | 310 |
| Week 2 | 284 |
| Week 3 | 352 |
| Week 4 | 401 |

| Total | Now | Before |
| --- | --- | --- |
| People | 1,347 | 1,190 |
| Sent by assistants | 64 | 31 |
| AI crawler fetches | 2,210 | 1,640 |

## Over HTTP

```
curl "https://mttr.si/api/v1/sites/example.com/visits" \
  -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. |
| The key has not claimed the site | 404 | Claim it with `mttr_claim`, then `mttr_claim_check`. |

## 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_visits in the API reference](https://mttr.si/docs/reference#mttr_visits).

## Goes with

- [Search traffic](https://mttr.si/docs/tools/traffic.md)
- [Citations so far](https://mttr.si/docs/tools/citations.md)