routing.list_app_registrations

Description

The introspection primitive for cross-app routing. Returns the set of customer apps that have registered handlers against this user — useful for showing the user their connected AI products in your settings UI, and for letting them set per-app routing preferences via `routing.set_default_handler`. This tool is the data behind 'your trust graph compounds across every AI tool you use.'

Input schema

Output shape

{
  apps: Array<{
    app_id: string;
    display_name: string;
    handlers: Array<{ handler_id: string; action_classes: string[] }>;
    first_registered_at: string;
  }>;
}

Example call

JSON-RPC tools/call request body (omit the JSON-RPC envelope when using an SDK; the SDK adds it for you):

{
  "name": "routing.list_app_registrations",
  "arguments": { "user_id": "usr_01HXP9USER" }
}

Example response

Tool results are always wrapped as content[0].text with a stringified JSON body. The shape below is what you get back from JSON.parse(result.content[0].text):

{
  "apps": [
    {
      "app_id": "app_01HXP9YOURAPP",
      "display_name": "YourApp",
      "handlers": [
        { "handler_id": "hnd_01HXP9HANDLER", "action_classes": ["communicate", "schedule"] }
      ],
      "first_registered_at": "2026-08-01T10:00:00Z"
    },
    {
      "app_id": "app_01HXP9OTHERAPP",
      "display_name": "OtherApp",
      "handlers": [
        { "handler_id": "hnd_01HXP9OTHER", "action_classes": ["communicate"] }
      ],
      "first_registered_at": "2026-11-22T18:30:00Z"
    }
  ]
}

Errors this tool can return

See the full error catalog for resolution steps on each code, plus the standard transport-layer responses (401, 429).

Notes