MCP tools

VIPs and profile

People and domains that always get a human look, and the shared triage profile.

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

list_vips

Tool

VIP people and domains for the account.

Inputs

No inputs.

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

add_vip

Tool

Adds VIP addresses or domains.

Inputs

NameTypeRequiredDescription
emails string[] Optional Email addresses to mark as VIP, e.g. ["dana@client.com"]
domains string[] Optional Bare domains to mark as VIP, e.g. ["client.com"]
Example call
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "add_vip",
    "arguments": {
      "emails": [
        "dana@client.com"
      ]
    }
  }
}

remove_vip

Tool

Removes VIPs. Without confirmed: true it only lists what would go.

Inputs

NameTypeRequiredDescription
emails string[] Optional Email addresses to drop from the VIP list
domains string[] Optional Domains to drop from the VIP list
confirmed boolean Optional true only after the person agreed in chat to remove exactly these entries
Example call
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "remove_vip",
    "arguments": {}
  }
}

get_triage_profile

Tool

Cadence, junk rules, VIPs, and quiet hours. Pass inboxId for the merged view for one inbox.

Inputs

NameTypeRequiredDescription
inboxId string Optional If set, also returns `effective` prefs for this inbox (defaults merged with its override).
Example call
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_triage_profile",
    "arguments": {}
  }
}

update_triage_profile

Tool

Deep-merges a patch onto the profile.

Inputs

NameTypeRequiredDescription
patch object Required Patch to deep-merge onto the stored triageProfile. Only include the fields you want to change.
Example call
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "update_triage_profile",
    "arguments": {
      "patch": {
        "defaults": {
          "vip": {
            "people": [
              "boss@example.com"
            ]
          }
        }
      }
    }
  }
}