MCP toolsWork and approvalsUpdated
Where a proposal stands
What does mttr_proposal do?
Says where one proposal stands: pending, approved, declined or expired. It says deploy only once you approved it, and gives your reason when you declined. A key may make this call on the sites it has claimed.
When to use it
- The assistant is waiting to deploy a proposed change.
What you ask
You say“Has my proposal for example.com been approved?”
Your assistant calls
mttr_proposal({ id: 4242 })
| Argument | Type | Needed | What it is |
|---|---|---|---|
id | Number | Yes | The proposal id that mttr_propose returned. |
What comes back
- Where it stands, and whether to deploy.
- Your reason, when you declined it.
- Proposed
- Emailed to you
- 3Approved
- 4Deployed
Approved. Deploy is now true.
Made-up sites and figures, to show the shape of the answer. The answer itself is JSON.
Over HTTP
It is GET /api/v1/account/proposal, with your key as a bearer token:
curl "https://mttr.si/api/v1/account/proposal?id=4242" \
-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. |
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_proposal in the API reference.