along_list_safes

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."
}

string | null

ID of the currently active Safe for this session, or null if no Safe is selected.

array

List of all Safes the authenticated user can access.

Show properties

string

The Safe ID. Pass this value to along_select_safe to activate this Safe.

string

Display name of the Safe.

string | null

Optional description of the Safe’s contents and purpose.

string

ID of the team that owns this Safe.

boolean

Whether this Safe is currently selected for the session. Matches currentSafeId.

number

Total count of Safes accessible to the authenticated user.

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": {}
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"currentSafeId\":null,\"safes\":[{\"id\":\"safe_abc123\",\"name\":\"Sales Intelligence\",\"description\":\"CRM data and deal notes\",\"teamId\":\"team_xyz\",\"isCurrent\":false}],\"totalSafes\":1,\"hint\":\"To select a safe, call along_select_safe with the safeId.\"}"
      }
    ]
  }
}

Overview

Safe Context

MCP Connection

MCP Tools

Overview

When to use

Parameters

Response

Example

​Overview

​When to use

​Parameters

​Response

​Example

Overview

When to use

Parameters

Response

Example