MCP toolsRivals and marketsUpdated
Worked examples
What does mttr_examples do?
How other sites pass a rule a page fails: pages on sites in the same market, or the nearest sites, that pass it and are closest to the page in meaning, each with the passage that comes closest. A key may make this call on the sites it has claimed.
When to use it
- You know what a rule asks and want to see it done well.
What you ask
You say“Show me how other sites answer first on a page like /guides/drain-cleaning.”
mttr_examples({ site: "example.com", path: "/pricing", rule: "answer-first" })
| Argument | Type | Needed | What it is |
|---|---|---|---|
site | Text | Yes | The site, as a domain such as example.com. |
path | Text | Yes | The page, as a path such as /guides/gravel. |
rule | Text | Yes | A page rule id, as mttr_rules gives it. |
limit | Number | No | How many to return. |
What comes back
- Pages elsewhere that pass the rule, closest first.
- The passage on each that comes closest, marked as quoted.
rival.example/guides/blocked-drainsAnswers in the first line under the question
86% alikenorth.example/help/slow-drainsA short answer, then the steps
78% alike
Made-up sites and figures, to show the shape of the answer. The answer itself is JSON.
Over HTTP
It is GET /api/v1/sites/{site}/examples, with your key as a bearer token:
curl "https://mttr.si/api/v1/sites/example.com/examples?path=%2Fpricing&rule=answer-first" \
-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_examples in the API reference.