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

# List available accounts

> See which AI Growth Agent accounts your session can reach.

Ask your client:

> List my available AI Growth Agent accounts

The agent calls `list_accounts`, which reads your OAuth token's claims and
returns:

* `accounts` — every AI Growth Agent account you can access, each with its
  account ID
* `currentAccountId` — the account the session is currently acting on

The current account defaults to the first account in your token.

## Switching accounts

Every read tool uses the session's current account. To switch it, ask for the
account by name or ID — the agent calls `set_account` with the chosen
`accountId`:

> Use the Acme Corp account

`set_account` returns the updated `currentAccountId` and account list. The
choice is kept per user for the life of the server process and resets on
restart. An unknown ID errors with the list of valid accounts.

## One-off overrides

To query a different account without switching the session, pass an
`accountId` for that call only — every read tool accepts an optional
`accountId` override. For example:

> Show the visibility trend for account 123

## See also

* [Common workflows](/workflows) — the first-session recipe starts with
  `auth_status` → `list_accounts` → `set_account`
* [Available MCP tools](/tools) — full input and output reference