# whoami (/docs/reference/mcp-tools/whoami)



{/* Generated by apps/docs/scripts/generate-mcp-pages.mjs — do not edit by hand. */}

Resolve the current principal: user, org, role, scopes, accessible workspaces.

|                     |                   |
| ------------------- | ----------------- |
| Required permission | `self`            |
| Capability ID       | `identity.whoami` |
| Destructive         | No                |

## Parameters [#parameters]

This tool takes no parameters — call it with an empty object.

## Input schema (JSON Schema) [#input-schema-json-schema]

```json
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
```

## Access control [#access-control]

A call succeeds only when the personal access token's scopes **and** the holder's role both allow `self` (effective permission = scope ∩ role, default-deny). The tool runs inside the token owner's organization — tenancy is never a parameter.