Skip to content
Official MCP RegistryListed

HLA-Verify

Part ofHLA-VerifyMCP server

HLA nomenclature and match checks against a pinned IPD-IMGT/HLA release. No patient identifiers.

First seen 2 Oct 2026. Evidence as of 7 Oct 2026.

10
Tools
From an anonymous probe
1
Source listings
Each with its own history
12
Recorded changes
Since first seen

Tools

ToolDescriptionBehaviour
aboutWhat this server is and is not, what to send it, benchmark evidence for why to use it, the beta state, and terms.Read-only
allele_infoLook up one name in the pinned release and return what it is: assigned (G/P group, first release, confirmed status, WMDA serology, null flag), valid_prefix (member count and sample), group (a G or P group name: member count and sample), or deleted (successor). Reported shorthands are accepted as /v1/normalize accepts them — legacy colon-less names (A*0101, Cw*0702), the XX code (A*02:XX), two-field A*02:01g, an optional HLA- prefix — and answer with the facts of the name they stand for plus resolves_to and a flag (deprecated_name, xx_code, lg_notation); an NMDP multiple allele code (A*02:AB) returns mac_code, recognised but not expanded. Not found if the name has never existed in any release.Read-only
beta_signupPut a user on the free public beta's notification list for paid API keys. Ask before calling: it records the address they give you. Re-signing the same address is safe (status already_recorded). Someone who needs a higher rate limit today should email [email protected] for a beta key instead of waiting.Changes data
check_typingQC-check one HLA typing (all loci) against the pinned release: resolves every reported allele, flags unresolvable/outdated/locus-mismatched/null alleles, flags too-many/single/homozygous per locus, computes the B-leader (-21 M/T) and KIR-ligand (C1/C2/Bw4) profile, and DRB3/4/5 expected-vs-reported. Nomenclature and internal-consistency checking of the report, not clinical interpretation. typing: {"A": ["A*01:01", "A*02:01"], "B": [...], "DRB1": [...], ...} (any nomenclature era, G/P group names, A*02:XX and two-field A*02:01g included; NMDP MAC codes are flagged, not expanded; allele strings only, no patient identifiers).Read-only
donor_compatDonor/recipient immunogenetic compatibility under two published rule sets: HLA-B leader match (-21 M/T, Petersdorf 2020) for a single HLA-B mismatch, and KIR ligand (C1/C2/Bw4) class comparison, computed over each side's full typing QC. Rule checking against published frameworks; it does not rank or recommend a donor. recipient/donor: {"A": [...], "B": [...], "C": [...], "DRB1": [...], ...} (allele strings only, no patient identifiers). Decision support only; not a medical device.Read-only
match_scoreCount a donor-recipient HLA match by the published counting rules (R1-R6): allele arithmetic over chromosomes, not a donor recommendation. recipient/donor: {"A": ["A*01:01","A*02:01"], "B": [...], ...} (two reported alleles per locus, any nomenclature era including G/P group names such as A*02:01:01G; allele strings only, no patient identifiers). framework: 6/6, 8/8, 10/10, 12/12, or antigen. Returns count, per-locus verdicts, GvH/HvG mismatch counts, and flags; unresolvable typing yields 'potential', never a confident count.Read-only
normalize_alleleNormalize one reported HLA allele name (any era or reporting shorthand: legacy A*0101, G/P group names, A*02:XX, two-field A*02:01g, optional HLA- prefix) to current 2-field form, with G group, P group, serologic equivalent, and flags. NMDP MAC codes (A*02:AB) are recognised but not expanded (flag mac_code).Read-only
research_accessApply for free HLA-Verify access for an academic or nonprofit lab. Ask before calling: it records the address, institution and use case you give it. Approval is manual: a person reads every application, so it is not instant and not guaranteed. If it is approved the applicant is emailed a single-use code that takes 100% off a subscription for 12 months at self-serve checkout, with no card and no contract. Re-applying with the same address is safe (status already_recorded) and never overwrites an application that has already been decided. Commercial labs should buy a tier at https://api.hlaverify.com/pricing instead.Changes data
validate_gl_stringValidate and normalize a GL String (Genotype List, ^ | + ~ / grammar): resolves every allele token, flags outdated/unresolvable names and structural problems (mixed loci within a slash-list, a repeated locus within a haplotype or across ^ blocks, more than two haplotypes, differing loci across a genotype or genotype list, empty elements), and returns the normalized string. Grammar and nomenclature checking only; send allele names, not patient identifiers.Read-only
verify_textScan HLA typing report text, or model output about HLA, for allele-shaped tokens and classify each one: valid / legacy (with modern form) / G-P group / deleted (with successor) / fabricated / NMDP MAC code (seen, not expanded) / KIR name (out of scope, not checked). Nomenclature checking against a pinned IPD-IMGT/HLA release, not interpretation of a case. Use on any AI-generated or transcribed content mentioning HLA. Send the HLA content only, with patient identifiers removed first.Read-only

Change history

  1. verify_text: input schema changed
  2. verify_text: description changed (+"expanded) / KIR name (out of scope, not checked)." -"expanded).")
  3. allele_info: input schema changed
  4. allele_info: description changed (+"Reported shorthands are accepted as /v1/normalize accepts them — legacy colon-less names (A*0101, Cw*0702), the XX code (A*02:XX), two-field A*02:01g, an optional HLA- prefix — and answer with the facts of the name they stand for plus resolves_to and a flag (deprecated_name, xx_code, lg_notation); an NMDP multiple allele code (A*02:AB) returns mac_code, recognised but not expanded." -"exact")
  5. verify_text: input schema changed
  6. verify_text: description changed (+"G-P group /" +"fabricated / NMDP MAC code (seen, not expanded)." -"fabricated.")
  7. normalize_allele: input schema changed
  8. normalize_allele: description changed (+"era or reporting shorthand: legacy A*0101, G/P group names, A*02:XX, two-field A*02:01g, optional HLA- prefix)" +"NMDP MAC codes (A*02:AB) are recognised but not expanded (flag mac_code)." -"era)")
  9. match_score: description changed (+"era including G/P group names such as A*02:01:01G;" -"era;")
  10. check_typing: description changed (+"era, G/P group names, A*02:XX and two-field A*02:01g included; NMDP MAC codes are flagged, not expanded;" -"era;")
  11. allele_info: input schema changed
  12. allele_info: description changed (+"group (a G" +"P group name: member count and sample), or")
Source listings
SourceListingFirst seenLast seenVersions
Official MCP Registrycom.hlaverify/hla-verify2 Oct 20267 Oct 20261