Merge two candidates
merge_candidates[Candidates] Merge merge_id into keep_id after preview_candidate_merge (send its preview_token; field_choices picks keep or merge per field). Owners and admins only. IRREVERSIBLE: there is no unmerge. The candidate is not told. It is for two records of the same person.
Every argument in full, with examples: get_tool_reference.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"keep_id": "<keep_id>",
"merge_id": "<merge_id>",
"preview_token": "<preview_token>"
},
"name": "merge_candidates"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| keep_id | Yes | Candidate id (the `id` of a list_candidates row) of the record that stays. | |
| merge_id | Yes | Candidate id (the `id` of a list_candidates row) of the record merged into it; it is archived and points to the kept record afterwards. | |
| llm_model | No | Your model id, e.g. "claude-opus-4-8"; "unknown" if unsure. For analytics. | |
| duplicate_id | No | Duplicate pair id (a duplicate pair `id` from get_candidate include=duplicates) this merge resolves; found from the pair when left out. | |
| field_choices | No | Per field, 'keep' (the default) keeps the kept record's value and 'merge' takes the merged record's. | |
| preview_token | Yes | The preview_token of preview_candidate_merge for the same pair. When the records changed since the preview, the merge is refused with 409 and needs a new preview. | |
| conversation_id | No | The conversation_id this server returned earlier in this conversation, unchanged, including after later user messages. Omit it if you have none. Recorded for the server developer's analytics. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| moved | Yes | ||
| keep_id | Yes | ||
| merge_id | Yes | ||
| repeated | Yes | ||
| not_moved | Yes | ||
| merge_record_id | Yes | ||
| _mcp_instructions | No | Server-issued metadata for this conversation. |