normalize_allele
Normalize one reported HLA allele name (any era or reporting shorthand: legacy A0101, Cw0702 or Cw07:02, G/P group names, A02:XX, two-field A02:01g, optional HLA- prefix) to current 2-field form, with G group, P group, serologic equivalent, and flags. NMDP MAC codes (A02:AB) are recognised but not expanded (flag mac_code). A name that does not exist comes back UNRESOLVABLE (flag nonexistent_allele), never corrected to a nearby real one.
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": {
"name": "<name>"
},
"name": "normalize_allele"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | One reported HLA allele name, any nomenclature era. An allele string only, never a patient name, medical record number or other identifier. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| flags | Yes | e.g. deprecated_name, legacy_rollover (a pre-2010 rollover name such as A*9201, resolved through the official 2010 mapping to A*02:101), nonexistent_allele, null_allele, g_group_name, p_group_name, xx_code, lg_notation, mac_code. | |
| g_group | Yes | G group; NONE (no group), AMBIGUOUS (members differ) or UNRESOLVABLE. | |
| reported | Yes | The input, verbatim. | |
| current_name | Yes | Current full name in the pinned release, or UNRESOLVABLE. | |
| allele_2field | Yes | Current 2-field form, or UNRESOLVABLE. Never present an UNRESOLVABLE name as an allele. |