MCP toolsRead and fixUpdated
Sites read
What does mttr_sites do?
The sites mttr has read, each with its latest score, its page count and the rule to fix first. A key may make this call on the sites it has claimed.
When to use it
- You want to see the sites you can ask about.
- You want to pick which site to work on.
What you ask
You say“Which of my sites needs the most work?”
Your assistant calls
mttr_sites({})| Argument | Type | Needed | What it is |
|---|---|---|---|
q | Text | No | Text the site name must contain. |
state | One of these | No | Only sites in this state.livedraftblocked |
sort | One of these | No | What to sort by.scorehostpagesrunsatchange |
dir | One of these | No | Which way to sort.ascdesc |
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 site with its score, pages read and first fix.
- 25 at a time, by score unless you ask for another order.
| Site | Score | Pages | Fix first |
|---|---|---|---|
| example.com | 72 | 100 | Show sources on guides |
| shop.example | 61 | 84 | Describe images |
| north.example | 48 | 37 | Add a way to get in touch |
Made-up sites and figures, to show the shape of the answer. The answer itself is JSON. A score says pages are well formed. It does not say an assistant cites the site.
Over HTTP
It is GET /api/v1/sites, with your key as a bearer token:
curl "https://mttr.si/api/v1/sites" \
-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. |
Every error’s wording is in the API reference.
The call in full, with its HTTP address, each argument’s type, who may make it and the call in four languages, is mttr_sites in the API reference.