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

# link_account

> Link or merge another Agentcard account that belongs to the same person.

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

**Behavior:** destructive.

## What it does

Link or merge another Agentcard account that belongs to the same person. Use when the user says they already have an account under a DIFFERENT email or phone number — most often after identity verification (KYC) is rejected as a duplicate, which means that person already verified on another account. Two steps: (1) call with \{ type, identifier } to send a one-time code to that email/phone; (2) call again with the \{ ticket, code } to verify. If the identifier belongs to a different account, the two accounts are MERGED (the identity-verified account survives and gains the other's email/phone, so both sign in to one account); if no account has it, it is simply added to the current account.

## Inputs

| Field        | Type                      | Description                                                               |
| ------------ | ------------------------- | ------------------------------------------------------------------------- |
| `type`       | string: `email` · `phone` | Step 1: which kind of identifier the OTHER account uses.                  |
| `identifier` | string                    | Step 1: the email address or phone number of the other account to verify. |
| `ticket`     | string                    | Step 2: the ticket returned by step 1.                                    |
| `code`       | string                    | Step 2: the one-time code the user received.                              |

## Returns

| Field                  | Type   | Description                         |
| ---------------------- | ------ | ----------------------------------- |
| `message` *(required)* | string | Human-readable result or next step. |

## Example call

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