along_select_safe

Overview

along_select_safe sets the active Safe for your MCP session. After calling this tool, all calls to the along tool will query the selected Safe’s knowledge graph. The selection is persisted server-side on your OAuth token, so it carries across conversations and reconnects.

The Safe selection persists server-side on the OAuth token. If you reconnect with the same OAuth token (after a token refresh), your previously selected Safe is automatically restored.

When to use

After calling along_list_safes to retrieve the Safe ID
When switching to a different knowledge base mid-session
At the start of a new conversation to explicitly set the active Safe

Parameters

string

required

The ID of the Safe to select. Retrieve this value from along_list_safes.

Response

On success, the tool returns a confirmation with the previous and new Safe details.

{
  "message": "Selected safe \"Sales Intelligence\". You can now use the \"along\" tool to search this safe's knowledge base.",
  "previousSafeId": "safe_def456",
  "newSafeId": "safe_abc123",
  "newSafeName": "Sales Intelligence"
}

string

Human-readable confirmation that the Safe was selected successfully.

string | null

ID of the Safe that was active before this call, or null if no Safe was previously selected.

string

ID of the newly selected Safe.

string

Display name of the newly selected Safe.

Error responses

Error message	Cause
`"safeId is required"`	You passed an empty or missing `safeId`.
`"Safe not found or not active"`	The Safe ID does not exist or the Safe has been deactivated.
`"You do not have access to this safe"`	You do not have permission to connect to this Safe.
`"Could not update session. Please reconnect."`	The OAuth token may have expired. Re-authorize and try again.

Selecting a Safe that is already active returns an immediate success message without making any changes.

Example

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "along_select_safe",
    "arguments": {
      "safeId": "safe_abc123"
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"message\":\"Selected safe \\\"Sales Intelligence\\\". You can now use the \\\"along\\\" tool to search this safe's knowledge base.\",\"previousSafeId\":null,\"newSafeId\":\"safe_abc123\",\"newSafeName\":\"Sales Intelligence\"}"
      }
    ]
  }
}

Overview

Safe Context

MCP Connection

MCP Tools

along_select_safe

Overview

When to use

Parameters

Response

Error responses

Example

​Overview

​When to use

​Parameters

​Response

​Error responses

​Example

Overview

When to use

Parameters

Response

Error responses

Example