MCP toolsAccount and sitesUpdated
Name a site on the leaderboard
What does mttr_list do?
Puts a site you have claimed on the public leaderboard by its name, with a link to its report. With show set to false it takes the name off again, and the site goes by an anonymous code. A key may make this call on the sites it has claimed.
When to use it
- Your site is doing well and you want it seen.
- You would rather it ranked without its name.
What you ask
You say“Show example.com by name on the leaderboard.”
mttr_list({ site: "example.com", show: "show" })
| Argument | Type | Needed | What it is |
|---|---|---|---|
site | Text | Yes | The site, as a domain such as example.com. |
show | True or false | No | True to name it, false to make it anonymous again. True if left out. |
What comes back
- Whether the site is now named or goes by its code.
- Its place on the board.
| Place | Site | Score |
|---|---|---|
| 11 | north.example | 74 |
| 12 | example.com | 72 |
| 13 | Unnamed site | 71 |
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 POST /api/v1/account/list, with your key as a bearer token:
curl -X POST "https://mttr.si/api/v1/account/list" \
-H "Authorization: Bearer $MTTR_KEY" \
-H "Content-Type: application/json" \
-d '{"site":"example.com","show":"show"}'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_list in the API reference.