MCP toolsSearch and assistantsUpdated
Citations so far
What does mttr_citations do?
What assistants were found to cite for a site, question by question, from the lookups already made, and the credits left for more. It costs nothing. A key may make this call on the sites it has claimed.
When to use it
- Before asking an assistant anything new.
- You want to know where a site is cited.
What you ask
You say“Where is example.com cited so far?”
Your assistant calls
mttr_citations({ site: "example.com" })
| Argument | Type | Needed | What it is |
|---|---|---|---|
site | Text | Yes | The site, as a domain such as example.com. |
What comes back
- Each question with what each assistant cited.
- The credits left, and the price of a new lookup.
| Question | Cited | Named only |
|---|---|---|
| Septic pumping near me | 1 of 3 | 1 of 3 |
| How to clear a drain | 0 of 3 | 0 of 3 |
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}/citations, with your key as a bearer token:
curl "https://mttr.si/api/v1/sites/example.com/citations" \
-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_citations in the API reference.