> ## 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 text message). |
| `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": {}
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.