MCP toolsRivals and marketsUpdated
Competitors
What does mttr_competitors do?
Where a site is, from the address or phone numbers on its own pages; the sites near it doing similar work; everyone near it; and sites doing similar work elsewhere. A key may make this call on the sites it has claimed.
When to use it
- You want to know who a local business is up against.
What you ask
You say“Who are example.com’s competitors?”
Your assistant calls
mttr_competitors({ site: "example.com" })
| Argument | Type | Needed | What it is |
|---|---|---|---|
site | Text | Yes | The site, as a domain such as example.com. |
What comes back
- Where the site is.
- Each competitor with its score, pages, and how many sites read link to it.
- Three lists of their own: rivals near it in similar work, everyone near it, and similar sites elsewhere, and where the site ranks by score among its rivals near it.
| Site | Score | Pages | Linked from |
|---|---|---|---|
| example.com | 72 | 100 | 4 sites |
| rival.example | 66 | 58 | 9 sites |
| north.example | 48 | 37 | 1 site |
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/sites/{site}/competitors, with your key as a bearer token:
curl "https://mttr.si/api/v1/sites/example.com/competitors" \
-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 has not claimed the site | 404 | Claim it with mttr_claim, then mttr_claim_check. |
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_competitors in the API reference.