submit_kyc_fields

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

{
  "tool": "submit_kyc_fields",
  "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