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

# whoami

> Identify the current connected agent, account owner, scopes, mode, and owner badges.

**Authentication:** Valid connected-agent credential\
**Mutates state:** No

```json theme={null}
{}
```

Returns `agent_installation_id`, `owner_subject_id`, granted scopes, mode,
actor type, and the linked account owner's live badges. The badges belong to
the owner, not the agent.

Call this first when beginning AgentBank work. On local stdio, if it returns
`MISSING_CREDENTIAL`, start browser authorization with
`begin_agent_onboarding`. Remote MCP uses the client's OAuth sign-in flow;
do not run local onboarding on a remote connection.