Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

HLA-Verify

REMOTE · API.HLAVERIFY.COM · SCANNED SEP 29

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

+14 this week 64 Trust /100
Trust breakdown (7 categories)

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score → Why this is hard to score →

Endpoint Security46
Transport & Reachability100
Schema Quality & AI Usability67
  • AI-judged instruction clarity (excellent).Pass
  • Context-footprint check failed: tool/resource definitions use about 1910 tokens (~191/item across 10 items; 10 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management43
  • Stability observed for 13 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage98
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 95% of tool parameters carry a description.Partial
  • Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety100
  • No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
  • We read all 10 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
  • An AI judge read all 11 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
  • Implements a current MCP spec version (2026-07-28).Pass
Install

How do I install the HLA-Verify MCP server?

HLA-Verify is a hosted endpoint at https://api.hlaverify.com/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

remote · api.hlaverify.com

# add to Claude Code
claude mcp add --transport http com-hlaverify-hla-verify 'https://api.hlaverify.com/mcp'
// .cursor/mcp.json
{
  "mcpServers": {
    "com-hlaverify-hla-verify": {
      "url": "https://api.hlaverify.com/mcp"
    }
  }
}
// .vscode/mcp.json
{
  "servers": {
    "com-hlaverify-hla-verify": {
      "type": "http",
      "url": "https://api.hlaverify.com/mcp"
    }
  }
}
# ~/.codex/config.toml
[mcp_servers.com-hlaverify-hla-verify]
url = "https://api.hlaverify.com/mcp"
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "com-hlaverify-hla-verify": {
      "type": "remote",
      "url": "https://api.hlaverify.com/mcp",
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add com-hlaverify-hla-verify --url 'https://api.hlaverify.com/mcp' --transport streamable-http
# ~/.hermes/config.yaml
mcp_servers:
  com-hlaverify-hla-verify:
    url: "https://api.hlaverify.com/mcp"
// ~/.netclaw/config/netclaw.json
{
  "McpServers": {
    "com-hlaverify-hla-verify": {
      "Transport": "http",
      "Url": "https://api.hlaverify.com/mcp"
    }
  }
}
# add to Vellum
assistant mcp add com-hlaverify-hla-verify -t streamable-http -u 'https://api.hlaverify.com/mcp'
// mcp.json
{
  "mcpServers": {
    "com-hlaverify-hla-verify": {
      "type": "http",
      "url": "https://api.hlaverify.com/mcp"
    }
  }
}

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 28 Sept 26 +1
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 25 Sept 26 +1
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 24 Sept 26 +11
    • Judged manipulation: unverified → pass ▲ security
    • Schema quality: unverified → excellent ▲ functional
  • 23 Sept 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 20 to 23. That category is still filling its 30-day observation window: 6 days of observed history at the previous scan, 7 at this one. The score rises as the window fills, whether or not the server changes.

  • 22 Sept 26 −11
    • Judged manipulation: pass → unverified ▼ security
    • The server rewrote its instructions, which are the text every model session reads security
    • Schema quality: excellent → unverified ▼ functional
  • 21 Sept 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 13 to 17. That category is still filling its 30-day observation window: 4 days of observed history at the previous scan, 5 at this one. The score rises as the window fills, whether or not the server changes.

  • 19 Sept 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.

  • 18 Sept 26 0
    • The server rewrote its instructions, which are the text every model session reads security
    • Schema quality: 1567 → 1863 ▼ functional
    • New tool “research_access” functional
Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 29 Sept 2026 · Probed https://api.hlaverify.com/mcp

TLS valid

Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .

Subject Issuer Valid from Valid until Key Signature Serial
CN=hlaverify.com CN=WE1,O=Google Trust Services,C=US 10 Sept 2026 9 Dec 2026 ECDSA 256 ECDSA-SHA256 c7f669035450f63a13530b060bee0b28
SANs: hlaverify.com, api.hlaverify.com, *.api.hlaverify.com
CN=WE1,O=Google Trust Services,C=US (CA) CN=GTS Root R4,O=Google Trust Services LLC,C=US 13 Dec 2023 20 Feb 2029 ECDSA 256 ECDSA-SHA384 7ff31977972c224a76155d13b6d685e3
CN=GTS Root R4,O=Google Trust Services LLC,C=US (CA) CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE 15 Nov 2023 28 Jan 2028 ECDSA 384 SHA256-RSA 7fe530bf331343bedd821610493d8a1b

Background: What to check on a remote MCP endpoint →

DNSSEC insecure

Validation of api.hlaverify.com. — Not signed

Zone DS Keys Algorithms Outcome
. trust_anchor 20326, 38696 8, 8 Verified
com. present 19718 13 Verified
hlaverify.com. absent Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation
Authentication No authorisation required

The endpoint answered without asking for a token. Anyone who knows the URL can reach it.

Result No authorisation required
HTTP status 200

Background: How OAuth 2.1 works in the 2026 MCP spec →

Transports 2 probes
Transport URL Outcome Status Location
streamable-http https://api.hlaverify.com/mcp Verified 200
http (plaintext) http://api.hlaverify.com/mcp Inconclusive 405
MCP tools · 10 exposed · ~1,574 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
about ~35

What this server is and is not, what to send it, benchmark evidence for why to use it, the beta state, and terms.

Input schema present but exposes no named parameters.

NameTypeReqDescription
agentsstring––
apistring––
betastring––
beta_keystring––
beta_signupstring––
codestring––
commercialstring––
demostring––
disclaimerstring––
inputsstring––
limitsstring––
namestringyes–
releasestringyesIPD-IMGT/HLA release every verdict was computed against.
researchstring––
scopestring––
whystring––

No examples provided.

allele_info ~108

Look up one exact 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), or deleted (successor). Not found if the name has never existed in any release.

NameTypeReqDescription
namestringyesExact HLA allele name, a lower-resolution prefix, or a deleted name. An allele string only, never a patient name, medical record number or other identifier.
NameTypeReqDescription
attributionstring–Data attribution (IPD-IMGT/HLA, CC-BY-ND).
confirmedboolean–assigned: confirmed (vs unconfirmed) allele.
detailstring–Present only when the name is not assigned in this release (and then no other field is).
first_releasestring|null–assigned: first release the exact name appeared in.
g_groupstring|null–assigned: G group, or null.
ligandsobject–Class I (A/B/C) ligand facts, aggregated over member alleles: 'ambiguous' when members disagree, 'unknown' when no residue data.
members_countinteger–valid_prefix: number of assigned alleles under the prefix.
members_samplearray–valid_prefix: up to 10 member alleles.
namestring––
null_alleleboolean–assigned: true for an N (null, not expressed) allele.
p_groupstring|null–assigned: P group, or null.
releasestring–IPD-IMGT/HLA release every verdict was computed against.
serologyobject–assigned: WMDA serologic equivalents by column (non-empty columns only).
statusstring–assigned: an exact allele in this release; valid_prefix: a lower-resolution prefix of assigned alleles; deleted: withdrawn or renamed (see successor).
successorstring|null–deleted: the current name, or null if none.

No examples provided.

beta_signup ~140

Put 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 hello@hlaverify.com for a beta key instead of waiting.

NameTypeReqDescription
emailstringyesThe user's email address.
orgstring–Lab, company or institution (optional).
sourcestring–Where the signup came from, e.g. mcp (optional).
use_casestring–What they would use the API for (optional). No patient details.
NameTypeReqDescription
messagestringyesWhat to tell the user, including how to get a beta key today.
okbooleanyesAlways true; a rejected signup comes back as an error result.
releasestringyesIPD-IMGT/HLA release every verdict was computed against.
statusstringyesalready_recorded: the address was already on the list. Both are success — do not retry.

No examples provided.

check_typing ~199

QC-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; allele strings only, no patient identifiers).

NameTypeReqDescription
typingobjectyeslocus -> up to 4 reported allele names. Allele strings only: never patient names, medical record numbers, dates of birth, or accession or case identifiers.
NameTypeReqDescription
attributionstring–Data attribution (IPD-IMGT/HLA, CC-BY-ND).
countsobjectyes–
drb345object|nullyesDRB3/4/5 expected from DRB1 vs reported; null when DRB1 is not typed.
issuesarrayyes–
lociobjectyesReported locus key -> one row per reported allele, in input order.
profileobjectyes–
releasestringyesIPD-IMGT/HLA release every verdict was computed against.
validbooleanyestrue when there are no error-severity issues. Gate on this before using the typing.

No examples provided.

donor_compat ~212

Donor/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.

NameTypeReqDescription
donorobjectyeslocus -> up to 4 reported allele names. Allele strings only: never patient names, medical record numbers, dates of birth, or accession or case identifiers.
recipientobjectyeslocus -> up to 4 reported allele names. Allele strings only: never patient names, medical record numbers, dates of birth, or accession or case identifiers.
NameTypeReqDescription
attributionstring–Data attribution (IPD-IMGT/HLA, CC-BY-ND).
b_leaderobjectyes–
donor_validbooleanyesDonor typing QC had no errors.
issuesobjectyes–
kir_ligandsobjectyes–
recipient_validbooleanyesRecipient typing QC had no errors.
releasestringyesIPD-IMGT/HLA release every verdict was computed against.

No examples provided.

match_score ~229

Count 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; 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.

NameTypeReqDescription
donorobjectyeslocus -> up to 4 reported allele names. Allele strings only: never patient names, medical record numbers, dates of birth, or accession or case identifiers.
frameworkstring––
recipientobjectyeslocus -> up to 4 reported allele names. Allele strings only: never patient names, medical record numbers, dates of birth, or accession or case identifiers.
NameTypeReqDescription
attributionstring–Data attribution (IPD-IMGT/HLA, CC-BY-ND).
countstringyes'matched/total' over the resolvable loci only, or UNRESOLVABLE when none resolves. Check verdicts for 'potential' loci before quoting it as a confident count.
flagsarrayyese.g. resolution_insufficient, null_allele, null_allele_mismatch.
frameworkstringyes–
gvh_mismatchesintegeryesGraft-versus-host mismatches over non-potential loci.
hvg_mismatchesintegeryesHost-versus-graft mismatches over non-potential loci.
releasestringyesIPD-IMGT/HLA release every verdict was computed against.
verdictsobjectyesFramework locus -> verdict.

No examples provided.

normalize_allele ~77

Normalize one reported HLA allele name (any era) to current 2-field form, with G group, P group, serologic equivalent, and flags.

NameTypeReqDescription
namestringyesOne reported HLA allele name, any nomenclature era. An allele string only, never a patient name, medical record number or other identifier.
NameTypeReqDescription
allele_2fieldstringyesCurrent 2-field form, or UNRESOLVABLE. Never present an UNRESOLVABLE name as an allele.
current_namestringyesCurrent full name in the pinned release, or UNRESOLVABLE.
flagsarrayyese.g. deprecated_name, nonexistent_allele, null_allele.
g_groupstringyesG group; NONE (no group), AMBIGUOUS (members differ) or UNRESOLVABLE.
reportedstringyesThe input, verbatim.

No examples provided.

research_access ~268

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

NameTypeReqDescription
emailstringyesThe applicant's email address. The approval code is sent here.
expected_volumestring–Rough call or typing volume, e.g. 'about 20,000 typings a month' (optional).
institutionstringyesUniversity, hospital, institute or nonprofit the work is done at.
sourcestring–Where the application came from, e.g. mcp (optional).
use_casestringyesWhat the research or teaching is, and what the API would be used for. This is what the decision is made on, so be specific. No patient details.
NameTypeReqDescription
messagestringyesWhat to tell the user, including that approval is by hand and not instant.
okbooleanyesAlways true; a rejected application comes back as an error result.
releasestringyesIPD-IMGT/HLA release every verdict was computed against.
statusstringyesalready_recorded: this address already has an application on file. Both are success; do not retry.

No examples provided.

validate_gl_string ~127

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

NameTypeReqDescription
glstringyesGL String to validate and normalize. Allele names and GL grammar only, never patient identifiers.
NameTypeReqDescription
allelesarrayyesEach distinct allele token, in first-seen order.
attributionstring–Data attribution (IPD-IMGT/HLA, CC-BY-ND).
changedbooleanyesnormalized_gl differs from the trimmed input.
countsobjectyes–
issuesarrayyes–
lociarrayyes–
normalized_glstringyesThe GL String with outdated names replaced by current ones.
releasestringyesIPD-IMGT/HLA release every verdict was computed against.
validbooleanyestrue when there are no error-severity issues.

No examples provided.

verify_text ~179

Scan HLA typing report text, or model output about HLA, for allele-shaped tokens and classify each one: valid / legacy (with modern form) / deleted (with successor) / fabricated. 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.

NameTypeReqDescription
textstringyesHLA typing report text, or model output about HLA typing, to scan for allele names. Send the HLA content only: strip patient names, medical record numbers, dates of birth, accession and case identifi…
NameTypeReqDescription
attributionstring–Data attribution (IPD-IMGT/HLA, CC-BY-ND).
cleanbooleanyesThe guardrail: true only when no token is hallucinated, fabricated_group or deleted. Gate on this before presenting the text.
countsobjectyesNumber of distinct tokens per status.
releasestringyesIPD-IMGT/HLA release every verdict was computed against.
tokensarrayyesEach distinct allele-shaped token found, sorted by token.

No examples provided.

Common questions

What is the HLA-Verify MCP server?

HLA-Verify is an MCP server listed in the public MCP registry as com.hlaverify/hla-verify. HLA nomenclature and match checks against a pinned IPD-IMGT/HLA release. No patient identifiers. This page covers its hosted endpoint (https://api.hlaverify.com/mcp).

Is the HLA-Verify MCP server safe to use?

HLA-Verify scores 64 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the HLA-Verify MCP server expose?

HLA-Verify exposes 10 tools: verify_text, normalize_allele, allele_info, match_score, check_typing, and 5 more. Their descriptions and schemas cost roughly 1,574 tokens of context every time the server is loaded.

Does the HLA-Verify MCP server require authentication?

No. We connected to HLA-Verify without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.

Is the HLA-Verify MCP server still maintained?

HLA-Verify is still listed as active in the MCP registry. We last reached this channel on 29 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.