> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alongagents.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# along_list_safes

> List all Along Safes the authenticated user has access to across all teams.

## 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`.

<Note>
  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.
</Note>

## 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

```json theme={null}
{
  "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."
}
```

<ResponseField name="currentSafeId" type="string | null">
  ID of the currently active Safe for this session, or `null` if no Safe is selected.
</ResponseField>

<ResponseField name="safes" type="array">
  List of all Safes the authenticated user can access.

  <Expandable title="properties">
    <ResponseField name="safes[].id" type="string">
      The Safe ID. Pass this value to `along_select_safe` to activate this Safe.
    </ResponseField>

    <ResponseField name="safes[].name" type="string">
      Display name of the Safe.
    </ResponseField>

    <ResponseField name="safes[].description" type="string | null">
      Optional description of the Safe's contents and purpose.
    </ResponseField>

    <ResponseField name="safes[].teamId" type="string">
      ID of the team that owns this Safe.
    </ResponseField>

    <ResponseField name="safes[].isCurrent" type="boolean">
      Whether this Safe is currently selected for the session. Matches `currentSafeId`.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="totalSafes" type="number">
  Total count of Safes accessible to the authenticated user.
</ResponseField>

<ResponseField name="hint" type="string">
  Instruction for the next step — prompts the AI to call `along_select_safe` with the chosen `safeId`.
</ResponseField>

## Example

<CodeGroup>
  ```json Request theme={null}
  {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "along_list_safes",
      "arguments": {}
    }
  }
  ```

  ```json Response theme={null}
  {
    "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.\"}"
        }
      ]
    }
  }
  ```
</CodeGroup>