whoami

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

{
  "tool": "whoami",
  "arguments": {}
}

MCP

Organization tools

User tools

What it does

Inputs

Returns

Example call

​What it does

​Inputs

​Returns

​Example call

What it does

Inputs

Returns

Example call