# HLA-Verify

> HLA-Verify is a free MCP server for health and science. Deterministic check of HLA allele names against a pinned IPD-IMGT/HLA release. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, self-hosted
- **Website:** https://hlaverify.com
- **Repository:** https://github.com/jasonbrelsford/verifiable-science-envs/tree/HEAD/edge
- **MCP Registry name:** com.hlaverify/hla-verify
- **Categories:** health and science
- **Listing updated:** 2026-11-16

## About

HLA-Verify exists because a wrong allele name looks fine: a fabricated name like `DQB1*05:03:26:99` is perfectly well formed, so neither a reviewer nor a language model notices. The service scans free text, typing reports or LIMS exports for allele-shaped tokens and classifies each as valid, a G or P group, deleted (with its successor), a fabricated group or hallucinated, meaning no such name in any release back to 1.05.0. Legacy spellings such as `A*0201` are accepted and flagged as deprecated, and NMDP MAC codes are surfaced rather than skipped.

There is no model inside it: it is a lookup engine pinned to one release (3.66.0, with 47,424 alleles), so verdicts are reproducible from the release hash. Other endpoints normalise typing reports, return facts for a single allele and score donor-recipient matches, and a lab toolkit adds typing QC and GL String validation. Not covered are KIR genes, serology-only typings and unexpanded multiple allele codes.

Requests are processed in memory and discarded, with counts logged but not content. The site states it is a research and evaluation tool and not a medical device. The API is open at 100 calls a day per IP, 1,000 a day with a free instant key, and 10,000 for verified labs.

## Features

- **Token classification:** Labels each allele name as valid, group, deleted, fabricated or hallucinated.
- **Pinned release:** Every response names the IPD-IMGT/HLA release it used.
- **No model in the loop:** Results are computed and reproducible from the release.
- **Report normalisation:** Converts typing strings to current names and reductions.
- **Donor-recipient matching:** Scores pairs under published rules.
- **No request storage:** Requests are processed in memory and discarded.

## Good for

- Check an AI-drafted typing summary for invented alleles
- Convert a LIMS export to current nomenclature
- Find the successor of a deleted allele name
- Score a donor-recipient HLA match
- Validate GL Strings in a lab workflow

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http hla-verify https://api.hlaverify.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.hlaverify.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "hla-verify": {
      "url": "https://api.hlaverify.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "hla-verify": {
      "type": "http",
      "url": "https://api.hlaverify.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "hla-verify": {
      "serverUrl": "https://api.hlaverify.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "hla-verify": {
      "type": "http",
      "url": "https://api.hlaverify.com/mcp"
    }
  }
}
```

## FAQ

### Is an LLM used?

No, every answer is computed from the official IPD-IMGT/HLA files.

### What does it cost?

Free: 100 calls a day per IP without a key, 1,000 with a free key.

### Are my requests stored?

No, they are processed in memory and discarded.

### Is it a medical device?

No, it is described as a research and evaluation tool.

### Which release does it use?

IPD-IMGT/HLA 3.66.0.

### Is HLA-Verify free?

Yes. HLA-Verify is free to use.

### How do I add HLA-Verify to Claude Code?

Run this command in your terminal: claude mcp add --transport http hla-verify https://api.hlaverify.com/mcp

### What are the best alternatives to HLA-Verify?

The closest alternatives to HLA-Verify are Tooluniverse, Oya Browser, Later Stages, MedXpert 标准检索连接器 and MedXpert 全球法规连接器 (reg-connector).

## Alternatives

- [Tooluniverse](https://ai-powered.com/mcp/tooluniverse): Tooluniverse is an open-source MCP server for health and science.
- [Oya Browser](https://ai-powered.com/mcp/oya-browser): Oya Browser is a freemium MCP server for browser automation.
- [Later Stages](https://ai-powered.com/mcp/later-stages): Later Stages is a free MCP server for health and science.
- [MedXpert 标准检索连接器](https://ai-powered.com/mcp/medxpert-2): MedXpert 标准检索连接器 is a free MCP server for legal and government.
- [MedXpert 全球法规连接器 (reg-connector)](https://ai-powered.com/mcp/medxpert-reg-connector): MedXpert 全球法规连接器 (reg-connector) is a free MCP server for legal and government.
- [Splyt](https://ai-powered.com/mcp/splyt): Splyt is a free MCP server for health and science.
- [Health Agent](https://ai-powered.com/mcp/health-agent): Health Agent is an MCP server for health and science.
- [Pausila](https://ai-powered.com/mcp/pausila): Pausila is a free MCP server for local services.

---
Source: https://ai-powered.com/mcp/hla-verify
