MCP tools

Connect inboxes

Add inboxes and hand the person a link to sign in. No tool ever takes a password.

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

`propose_connection`

Tool

Detects the provider for an address and returns what to tell the person. Creates nothing.

Inputs

Name	Type	Required	Description
`email`	string	Required	The mailbox address.

Example call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "propose_connection",
    "arguments": {
      "email": "me@example.com"
    }
  }
}

`add_inbox`

Tool

Registers an inbox with no credential yet.

Inputs

Name	Type	Required	Description
`label`	string	Required	Display name, like "Work Gmail".
`provider`	enum	Required	google, microsoft, icloud, or imap. One of: google, microsoft, icloud, imap.
`email`	string	Required	The mailbox address.
`imapHost`	string	Optional	For provider=imap: the IMAP server (e.g. mail.example.com). Filled in for Yahoo, AOL, Fastmail and Zoho addresses; required for any other domain.
`imapPort`	number	Optional	IMAP port, default 993
`imapUser`	string	Optional	IMAP username if different from email. For provider=icloud with your own domain on iCloud+: the iCloud Mail address (ending in icloud.com, me.com or mac.com).

Example call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "add_inbox",
    "arguments": {
      "label": "Work",
      "provider": "google",
      "email": "me@example.com"
    }
  }
}

`start_google_oauth`

Tool

Returns a Google sign-in link for the person.

Inputs

Name	Type	Required	Description
`inboxId`	string	Required	Inbox id from list_inboxes.

Example call

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

`start_microsoft_oauth`

Tool

Returns a Microsoft sign-in link for the person.

Inputs

Name	Type	Required	Description
`inboxId`	string	Required	Inbox id from list_inboxes.

Example call

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

`start_imap_secret_capture`

Tool

Returns a link to a masked password form for iCloud or IMAP.

Inputs

Name	Type	Required	Description
`inboxId`	string	Required	Inbox id from list_inboxes.
`appPassword`	boolean	Optional	Yahoo/AOL only: use the app-password form even though sign-in is available.

Example call

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

`list_inboxes`

Tool

Every inbox with its connection and sync status. Check connectionStatus and needsReconnect.

Inputs

No inputs.

Example call

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