MCP toolsRivals and marketsUpdated
Leaderboard
What does mttr_leaderboard do?
Every ranked site by the score of its latest read, or the board of one crowd: a line of work, a state, a city or a size. Or one of the records, such as the most improved. Any key may make this call, on any public site.
When to use it
- You want to know where a site ranks.
- You want the best sites in a line of work to learn from.
What you ask
You say“Show me the leaderboard for the trades.”
Your assistant calls
mttr_leaderboard({})| Argument | Type | Needed | What it is |
|---|---|---|---|
in | Text | No | A line of work, such as trades, for its own board. Left out, every site. |
state | Text | No | A US state by its two letters, such as MO, for the board of the sites there. |
city | Text | No | A city in that state, such as Dallas, for the board of the sites there. Needs state. |
size | One of these | No | Sites of about one size, by the pages a read took of them.1-1011-5051-99100-plus |
record | One of these | No | One record in place of the places.fastestimprovedstagesanswer-firstbiggest |
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 place, score, stages and pages read.
- Sites kept unnamed go by a code.
| Place | Site | Score | Before |
|---|---|---|---|
| 1 | north.example | 91 | 88 |
| 2 | rival.example | 89 | 89 |
| 3 | Unnamed site | 87 | 80 |
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/leaderboard, with your key as a bearer token:
curl "https://mttr.si/api/v1/leaderboard" \
-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_leaderboard in the API reference.