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

# whoami

> Show who you are operating as: the authenticated AgentCard account's email, user id, name, plan, KYC + account status, member-since date, and how this session…

Connect to `https://mcp.agentcard.sh/mcp` with the **user's connection token** (or a `buy_token` for org-owned accounts).

**Behavior:** read-only, idempotent.

## What it does

Show who you are operating as: the authenticated AgentCard account's email, user id, name, plan, KYC + account status, member-since date, and how this session is connected (personal login vs a third-party OAuth app connection, with the app name). Call this when the user asks "who am I" / "which account is this", or before money-moving actions when you need to confirm the account. Read-only. KYC shown here is the stored snapshot — use get\_kyc\_status when you need the live, provider-checked state.

## Inputs

None.

## Returns

| Field                      | Type                                          | Description                                                                                                                                                                            |
| -------------------------- | --------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `message` *(required)*     | string                                        | Human-readable identity summary.                                                                                                                                                       |
| `email`                    | string/null                                   | Email of the authenticated account, or null for a phone-first account (e.g. signed up by SMS on the iMessage relay).                                                                   |
| `userId`                   | string                                        | AgentCard user id of the authenticated account.                                                                                                                                        |
| `name`                     | string/null                                   | Cardholder name ("First Last"), or null before KYC info is submitted.                                                                                                                  |
| `plan`                     | string                                        | Subscription plan id, e.g. 'free', 'basic', or 'pro'.                                                                                                                                  |
| `subscriptionStatus`       | string/null                                   | Stripe subscription status (e.g. 'active', 'past\_due'), or null on the free plan.                                                                                                     |
| `accountStatus`            | string                                        | Account standing: 'active' or 'suspended'.                                                                                                                                             |
| `kycVerified`              | boolean                                       | Whether identity verification (KYC) has passed (stored snapshot).                                                                                                                      |
| `kycStatus`                | string/null                                   | Raw stored KYC state (e.g. approved, pending, requires\_input), or null if never started.                                                                                              |
| `memberSince`              | string                                        | ISO timestamp the account was created.                                                                                                                                                 |
| `connectionType`           | string: `oauth` · `personal` · `organization` | How this session authenticates: 'oauth' (third-party app connection), 'personal' (CLI/dashboard login), or 'organization' (a company's Agentcard integration acting for its end user). |
| `connectionClientId`       | string/null                                   | OAuth client id of the connected app, when connectionType is oauth.                                                                                                                    |
| `connectionClientName`     | string/null                                   | Display name of the connected OAuth app (e.g. "Claude"), when known.                                                                                                                   |
| `connectionOrganizationId` | string/null                                   | Organization id, when connectionType is organization.                                                                                                                                  |

## Example call

```json theme={null}
{
  "tool": "whoami",
  "arguments": {}
}
```