Skip to main content

​
Overview

The along_list_safes tool returns all Safes the authenticated user has access to, across every team they belong to. Call this tool to discover available knowledge bases before selecting one with along_select_safe.
This tool is only available on OAuth-authenticated sessions (personal connector). API key sessions are pre-scoped to a specific Safe and do not expose this tool.

​
When to use

  • At the start of a session when no Safe is selected
  • When the user wants to know which Safes are available
  • Before calling along_select_safe

​
Parameters

This tool takes no input parameters.

​
Response

{
  "currentSafeId": "safe_abc123",
  "safes": [
    {
      "id": "safe_abc123",
      "name": "Sales Intelligence",
      "description": "CRM data, call transcripts, and deal notes",
      "teamId": "team_xyz",
      "isCurrent": true
    },
    {
      "id": "safe_def456",
      "name": "Product Knowledge",
      "description": "Specs, roadmap, and engineering decisions",
      "teamId": "team_xyz",
      "isCurrent": false
    }
  ],
  "totalSafes": 2,
  "hint": "To select a safe, call along_select_safe with the safeId."
}
​
currentSafeId
string | null
ID of the currently active Safe for this session, or null if no Safe is selected.
​
safes
array
List of all Safes the authenticated user can access.
​
totalSafes
number
Total count of Safes accessible to the authenticated user.
​
hint
string
Instruction for the next step — prompts the AI to call along_select_safe with the chosen safeId.

​
Example

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