# Name a site on the leaderboard (`mttr_list`)

Updated October 24, 2026.

## 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.

Who may call it: Your claimed sites.

## 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 might 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.

A sample, with made-up sites and figures:

| Place | Site | Score |
| --- | --- | --- |
| 11 | north.example | 74 |
| 12 | example.com | 72 |
| 13 | Unnamed site | 71 |

A score says pages are well formed. It does not say an assistant cites the site.

## Over HTTP

```
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. |

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

## Goes with

- [Leaderboard](https://mttr.si/docs/tools/leaderboard.md)
- [Claim a site](https://mttr.si/docs/tools/claim.md)