MCP tools

Unsubscribe

Find mailing lists and unsubscribe, one approved request at a time.

Call these with tools/call on https://getinboxtriage.com/mcp. See the MCP overview for sign-in and the request format.

`review_unsubscribes`

Tool

Newsletter and mailing-list senders with counts, unread, per-week rate, a noise level and a suggested action, noisiest first.

Inputs

Name	Type	Required	Description
`inbox`	string	Optional	Inbox name (like "Work Gmail"), inbox id, or leave empty for all inboxes
`offset`	number	Optional	Where to start. Pass nextOffset from the last page.
`limit`	number	Optional	Senders per page, 1 to 100. Default 25.

Example call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "review_unsubscribes",
    "arguments": {}
  }
}

`propose_unsubscribe`

Tool

Checks a message for a one-click unsubscribe link and returns a pending request to approve.

Inputs

Name	Type	Required	Description
`inboxId`	string	Required	Inbox id from list_inboxes.
`messageId`	string	Required	Message id from list_messages, search_mailbox, or show_inbox.
`confirmed`	boolean	Optional	Only needed when the sender is on the VIP list: pass true after the human agrees in chat.

Example call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "propose_unsubscribe",
    "arguments": {
      "inboxId": "inbox_lx2k9a1b",
      "messageId": "18f3a2b4c5d6e7f8"
    }
  }
}

`confirm_unsubscribe`

Tool

Sends the one unsubscribe request after the person approves it in the app prompt or on the approval page.

Inputs

Name	Type	Required	Description
`pendingUnsubscribeId`	string	Required	pendingUnsubscribeId returned by propose_unsubscribe
`approvalCode`	string	Required	approvalCode returned by propose_unsubscribe for this pending request
`humanApprovedInChat`	true	Optional	Ignored. Approval happens in the in-app prompt or on the approval page.

Example call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "confirm_unsubscribe",
    "arguments": {
      "pendingUnsubscribeId": "pu_4b8e1f",
      "approvalCode": "K7Q2"
    }
  }
}