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

NameTypeRequiredDescription
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.
Example call
{
  "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

NameTypeRequiredDescription
inboxId string Required Inbox id from list_inboxes.
id string Required The screened row's id, from review_screened
Example call
{
  "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

NameTypeRequiredDescription
inboxId string Required Inbox id from list_inboxes.
id string Required The screened row's id, from review_screened
Example call
{
  "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

NameTypeRequiredDescription
inbox string Optional Inbox name, inbox id, or leave empty for all inboxes
Example call
{
  "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

NameTypeRequiredDescription
verdicts object[] Required
Example call
{
  "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

NameTypeRequiredDescription
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.
Example call
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "show_screened",
    "arguments": {}
  }
}