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
| Name | Type | Required | Description |
|---|---|---|---|
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
| Name | Type | Required | Description |
|---|---|---|---|
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
| Name | Type | Required | Description |
|---|---|---|---|
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
| Name | Type | Required | Description |
|---|---|---|---|
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"
]
}
}
}
}
}
}