MCP tools
Junk screening
Automatic junk cleanup that cannot lose real mail: review, rescue, and report, plus the agent layer for accounts still in suggest mode.
Call these with tools/call on https://getinboxtriage.com/mcp. See the MCP overview for sign-in and the request format.
review_screened
Tool
Mail moved to Screened, with a plain-language digest and rows to rescue or report. Run it as a routine.
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
inbox |
string | Optional | Inbox name, inbox id, or leave empty for all inboxes |
days |
number | Optional | Screened in the last N days. Default 7. Ignored if `since` is set. |
since |
string | Optional | ISO time; overrides `days`. |
offset |
number | Optional | Where to start. Pass nextOffset from the last page. |
limit |
number | Optional | Rows per page, 1 to 100. Default 25. |
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "review_screened",
"arguments": {}
}
}
rescue_screened
Tool
Moves a screened message back to the inbox and marks the sender known-good.
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
inboxId |
string | Required | Inbox id from list_inboxes. |
id |
string | Required | The screened row's id, from review_screened |
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "rescue_screened",
"arguments": {
"inboxId": "inbox_lx2k9a1b",
"id": "..."
}
}
}
report_screened
Tool
Reports a screened message as spam and blocklists the sender's domain.
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
inboxId |
string | Required | Inbox id from list_inboxes. |
id |
string | Required | The screened row's id, from review_screened |
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "report_screened",
"arguments": {
"inboxId": "inbox_lx2k9a1b",
"id": "..."
}
}
}
screen_junk
Tool
Up to 50 unscreened messages worth a junk/unsure/fine call, with a fixed rubric.
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
inbox |
string | Optional | Inbox name, inbox id, or leave empty for all inboxes |
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "screen_junk",
"arguments": {}
}
}
confirm_screening
Tool
Applies your junk/unsure/fine verdicts from screen_junk.
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
verdicts |
object[] | Required |
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "confirm_screening",
"arguments": {
"verdicts": [
{}
]
}
}
}
show_screened
Tool
Shows screened mail as an interactive list with Rescue, Report, a period picker, and inbox tabs.
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
inbox |
string | Optional | Inbox name, inbox id, or leave empty for all inboxes |
days |
number | Optional | Screened in the last N days. Default 7. |
offset |
number | Optional | Where to start. Pass nextOffset from the last page. |
limit |
number | Optional | Rows per page, 1 to 100. Default 25. |
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "show_screened",
"arguments": {}
}
}