Skip to main content
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