> ## 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": {}
}
```