MCP toolsWork and approvalsUpdated
Drop a brief
What does mttr_content_drop do?
Drops one of your open briefs, so its place among the three open at once is free for the next. A key may make this call on the sites it has claimed.
When to use it
- A brief is for a page you will not write.
What you ask
You say“Drop the French drain brief; we do not do those.”
Your assistant calls
mttr_content_drop({ site: "example.com", brief: 10 })
| Argument | Type | Needed | What it is |
|---|---|---|---|
site | Text | Yes | The site, as a domain such as example.com. |
brief | Number | Yes | The brief's id, from mttr_content_next. |
What comes back
- The brief dropped, and room for the next.
- Open
- 2Dropped
Brief 13 dropped. Ask for the next.
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/content/drop, with your key as a bearer token:
curl -X POST "https://mttr.si/api/v1/account/content/drop" \
-H "Authorization: Bearer $MTTR_KEY" \
-H "Content-Type: application/json" \
-d '{"site":"example.com","brief":10}'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_content_drop in the API reference.