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

# submit_kyc_fields

> Submit identity fields for verification: the ones the ID photo didn't carry (listed by missingFields — the tax/ID number always has to be asked since IDs don't…

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

## What it does

Submit identity fields for verification: the ones the ID photo didn't carry (listed by missingFields — the tax/ID number always has to be asked since IDs don't print it; call it "SSN" only for US documents and "national ID number" otherwise), corrections to extracted values the user flagged, and the User Agreements acceptance (agreements\_accepted, after presenting each agreement verbatim). That number is forwarded directly to the verification provider and never stored by Agentcard. NEVER ask about occupation, income, spending volume, or account purpose — those are filled automatically and must not be asked.

## Inputs

| Field | Type | Description |
| - | - | - |
| `first_name` | string | Legal first name, exactly as printed on the ID document. |
| `last_name` | string | Legal last name, exactly as printed on the ID document. |
| `date_of_birth` | string | YYYY-MM-DD |
| `ssn` | string | US documents: 9-digit SSN, dashes optional. Non-US documents: the national ID / tax number printed on the ID. Forward-only — never stored. |
| `address_line1` | string | Residential street address, line 1 (e.g. 123 Main St). |
| `address_line2` | string | Residential street address, line 2 — apartment, suite, or unit. Omit if none. |
| `address_city` | string | City of the residential address. |
| `address_region` | string | 2-letter state code for US (e.g. CA). |
| `address_postal_code` | string | Postal / ZIP code of the residential address. |
| `address_country_code` | string | 2-letter ISO country code (e.g. US). |
| `phone_number` | string | E.164 with country code, e.g. +14155551234. |
| `terms_accepted` | boolean | DEPRECATED — use agreements\_accepted. true once the user explicitly accepted the card issuer's cardholder terms. |
| `agreements_accepted` | array | Keys of the User Agreements the user explicitly accepted, one by one — the FULL required set from the agreements list in the previous step's result. Only pass after presenting each agreement verbatim and getting an explicit yes covering all of them. |

## Returns

| Field | Type | Description |
| - | - | - |
| `message` *(required)* | string | |
| `nextStep` | string/null | |
| `missingFields` | array | |
| `verificationUrl` | string | Face-scan link, present once everything is collected. |

## Example call

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


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