MCP toolsRivals and marketsUpdated
Markets
What does mttr_markets do?
Groups of sites close in meaning, each named by the site at its centre, largest first. A site in a market writes about the same work as the others in it. Only whoever runs this mttr may make this call.
When to use it
- You want to see how the sites read fall into lines of work.
What you ask
You say“What markets has mttr found?”
Your assistant calls
mttr_markets({})It takes nothing. Ask for it as it is.
What comes back
- Each market with the site at its centre and how many sites it holds.
| Market, by its centre | Sites |
|---|---|
| north.example | 64 |
| rival.example | 41 |
| shop.example | 18 |
Made-up sites and figures, to show the shape of the answer. The answer itself is JSON.
Over HTTP
It is GET /api/v1/markets, with your key as a bearer token:
curl "https://mttr.si/api/v1/markets" \
-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. |
| The key is a person’s, not the owner’s | 403 | Nothing: only whoever runs mttr makes this call. |
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_markets in the API reference.