MCP toolsInside a siteUpdated
Map of a site
What does mttr_map do?
Every page of a site’s latest read, one of three ways: as a tree by address, by links from the home page, or by meaning, with pages that read alike placed close. Any key may make this call, on any public site.
When to use it
- You want the whole site in one view.
- You want to find pages nothing links to.
What you ask
You say“Map example.com as a tree.”
Your assistant calls
mttr_map({ site: "example.com" })
| Argument | Type | Needed | What it is |
|---|---|---|---|
site | Text | Yes | The site, as a domain such as example.com. |
view | One of these | No | tree (the default), links or meaning.treelinksmeaning |
What comes back
- Each page with its state, failing rules, clicks from home and words.
- By links: the hubs, and pages no link leads to when the read was complete.
- By meaning: groups of pages, close meaning similar, never better or cited.
/Fails 1 ruleHome/guidesPasses42 pages/guides/drain-cleaningFails 2 rules1,240 words/guides/septic-careFails 1 rule980 words/servicesPasses18 pages/contactPasses140 words
Made-up sites and figures, to show the shape of the answer. The answer itself is JSON.
Over HTTP
It is GET /api/v1/sites/{site}/map, with your key as a bearer token:
curl "https://mttr.si/api/v1/sites/example.com/map" \
-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. |
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_map in the API reference.