Skip to main content

​
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

​
safeId
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"
}
​
message
string
Human-readable confirmation that the Safe was selected successfully.
​
previousSafeId
string | null
ID of the Safe that was active before this call, or null if no Safe was previously selected.
​
newSafeId
string
ID of the newly selected Safe.
​
newSafeName
string
Display name of the newly selected Safe.

​
Error responses

Error messageCause
"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"
    }
  }
}