> ## 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.

# get_kyc_status

> Check the user's identity verification (KYC) status.

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

Check the user's identity verification (KYC) status. Returns whether they are verified and, if not, the current state plus the conversational next step. Use this to poll after the user does the face scan, or any time create\_card reports kyc\_required.

## Inputs

None.

## Returns

| Field                  | Type        | Description                                                                                                           |
| ---------------------- | ----------- | --------------------------------------------------------------------------------------------------------------------- |
| `message` *(required)* | string      | Human-readable status / next step.                                                                                    |
| `verified`             | boolean     | True when identity verification has passed.                                                                           |
| `status`               | string/null | Raw KYC state: "verified", "pending", "requires\_input", "duplicate\_identity", "canceled", or null if never started. |
| `reason`               | string/null | Failure reason from the verification provider when one exists.                                                        |
| `nextStep`             | string/null | Conversational next step when the flow is in progress.                                                                |
| `missingFields`        | array       |                                                                                                                       |
| `verificationUrl`      | string      |                                                                                                                       |

## Example call

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