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, one row per sender, with a list view in apps that support it.

Inputs

Name	Type	Required	Description
`inbox`	string	Optional	Inbox name (like "Work Gmail"), inbox id, or leave empty for all inboxes

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 approved it in chat.

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	Literal true once the human approved the unsubscribe request in this chat. Required unless the app prompts the person directly (confirmInApp).

Example call

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