get_kyc_status - Agentcard

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

{
  "tool": "get_kyc_status",
  "arguments": {}
}