MCP toolsAccount and sitesUpdated
Check a claim
What does mttr_claim_check do?
Looks for the record or file from Claim a site, and once it is found adds the site to your account. A key may make this call on the sites it has claimed.
When to use it
- You have put the record or the file up.
- A check said not yet, and a few minutes have passed.
What you ask
You say“I added the TXT record. Check my claim on example.com.”
Your assistant calls
mttr_claim_check({ site: "example.com" })
| Argument | Type | Needed | What it is |
|---|---|---|---|
site | Text | Yes | The site, as a domain such as example.com. |
What comes back
- Whether the proof was found, and where.
- When it was found, the site is yours: its private parts now answer to your key.
- When it was not, what was looked for, so you can compare it with what you put up.
- Token given
- Record put up
- Record found
- 4Site added
Found the TXT record at example.com. The site is on your account.
Made-up sites and figures, to show the shape of the answer. The answer itself is JSON.
Over HTTP
It is POST /api/v1/account/claim/check, with your key as a bearer token:
curl -X POST "https://mttr.si/api/v1/account/claim/check" \
-H "Authorization: Bearer $MTTR_KEY" \
-H "Content-Type: application/json" \
-d '{"site":"example.com"}'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_claim_check in the API reference.