research_access
Get the user a free HLA-Verify API key, instantly. HLA-Verify is free for anyone: the key comes back in this result (status issued, field key) with 1,000 calls/day, 250 typings per call and 60 requests/minute; the user sends it as the X-API-Key header (or connects this MCP server with it). Ask before calling: it stores the email address with the key, used for service notices only. The key is shown once: give it to the user straight away. One key per address; asking again returns already_issued and never the key (lost keys: hello@hlaverify.com). Disposable inboxes are refused. Verified labs that need more can set tier "lab" with institution and use_case to apply for the Lab tier (10,000 calls/day, 5,000 typings per call): that is reviewed, and an approved key is emailed.
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": {
"email": "<email>"
},
"name": "research_access"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tier | No | Omit for a free key now. "lab" applies for the Lab tier instead (institution and use_case required). | |
| Yes | The user's email address. Stored with the key; service notices only. | ||
| source | No | Where the request came from, e.g. mcp (optional). | |
| use_case | No | What the API would be used for (optional; required with tier lab, where the decision is made on it). No patient details. | |
| institution | No | Lab, hospital, university, registry or company (optional; required with tier lab). | |
| expected_volume | No | Rough call or typing volume, e.g. 'about 20,000 typings a month' (optional). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | Always true; a refused request comes back as an error result. | |
| key | No | The API key, only when status is issued. Give it to the user; it is not shown again. | |
| tier | No | ||
| usage | No | ||
| issued | No | ||
| limits | No | ||
| status | Yes | issued: `key` holds a new free key, shown only this once. already_issued: this address already has a key (never shown again; lost keys: hello@hlaverify.com). recorded/already_recorded: a Lab-tier application (tier "lab") is on file. All are success; do not retry. | |
| key_ref | No | The key's first 8 characters. | |
| message | Yes | What to tell the user. | |
| release | Yes | IPD-IMGT/HLA release every verdict was computed against. |