Skip to main content
In full mode, https://api.atlan.com/mcp?tools=full, call mcp__initialise once before the other tools so a reviewer can read the related calls as one session. tools/list shows it under this name. In search mode, the default, the first mcp__search_tools call opens the session instead, and tools/list does not show mcp__initialise, though a call to it still works. See How search mode works. Its earlier name, registry__initialise, is no longer in tools/list. A call to it by name still opens a session the same way, so a client that saved the old name keeps working.
  • Required input: objective.
  • Optional inputs: client, client_version, and protocol_version.
  • Gateway can also require rationale.
  • Returns: {session_id, note}.
  • Effect: creates an mcp_session. A session opened by a person is created in the account’s root workspace. So is a session opened by a service account, such as an OAuth client, whether it acts for a person or for itself. A session opened by an agent is created in the agent’s own workspace.
Observed client and protocol metadata can replace the values supplied in the tool arguments. These fields are audit metadata and do not affect what the caller can access. Pass the returned session_id on later calls. Initialization itself does not accept session_id.