loinc-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@loinc-mcp search for LOINC codes related to glucose"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
LOINC MCP Server
A Model Context Protocol server for querying LOINC (Logical Observation Identifiers Names and Codes) terminology through the LOINC Search API.
Available Tools
Tool | Description |
| Search LOINC codes by text query. Returns codes, names, and classifications. |
| Get full details for a LOINC code: parts, classification, units, panel members, and answer options. |
Related MCP server: medical-codes
Quick Start
Prerequisites
Python 3.12+
A LOINC account (free at loinc.org/join)
Install as a uv tool
git clone https://github.com/robsyc/loinc-mcp && cd loinc-mcp
uv tool install .Then add to your .cursor/mcp.json or Claude Desktop config:
{
"mcpServers": {
"loinc-mcp": {
"command": "loinc-mcp",
"env": {
"LOINC_USERNAME": "your-username",
"LOINC_PASSWORD": "your-password"
}
}
}
}Run with uvx
{
"mcpServers": {
"LOINC": {
"command": "uvx",
"args": ["--from", "git+https://github.com/robsyc/loinc-mcp", "loinc-mcp"],
"env": {
"LOINC_USERNAME": "your-username",
"LOINC_PASSWORD": "your-password"
}
}
}
}Usage Examples
"Search for LOINC codes related to glucose"
"Get the full details for LOINC code 2339-0"
"Look up the lipid panel 24331-1 and show me its members"
API Details
This server wraps the LOINC Search API:
Base URL:
https://loinc.regenstrief.org/searchapi/Auth: HTTP Basic Authentication (LOINC account credentials)
Endpoints used:
/loincs(search) and FHIR/Questionnaire/{code}(panels)Rate limiting: 10 requests/second (enforced client-side)
LOINC Class Types
Code | Type |
1 | Laboratory |
2 | Clinical |
3 | Claims attachments |
4 | Surveys |
Panel Detection
When get_code is called for a panel (detected via the CLASS field), panel members are automatically fetched from the FHIR Questionnaire endpoint. For survey panels, answer options are included inline with each member.
Development
uv sync --group dev
# Lint
uv run ruff check src/ tests/
# Tests
uv run pytest tests/ -v
# MCP Inspector
LOINC_USERNAME=your-user LOINC_PASSWORD=your-pass uv run fastmcp dev inspector src/loinc_mcp/server.py:mcpAcknowledgments
LOINC for the terminology and API
Regenstrief Institute for maintaining LOINC
FastMCP for the MCP framework
Available Tools
2 toolsget_codeARead-onlyIdempotent
Get full details for a LOINC code: name, parts, classification, units, and panel members/answer options if applicable.
Inputs: code (required). Returns: result
searchARead-onlyIdempotent
Search LOINC codes by text. Returns matching codes with names and classifications.
Inputs: query (required), limit, class_type. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
get_code retrieves details for a specific code, while search finds codes by text. Their purposes are completely distinct, leaving no ambiguity.
Both names follow a simple verb pattern, but get_code uses verb_noun while search is just a verb. Slight inconsistency, though both are clear and predictable.
With only 2 tools, the server is minimal but covers basic search and retrieval for LOINC. It is slightly thin for a domain with many potential operations, yet acceptable for a focused utility.
The set covers core lookup and search but lacks operations like listing by class, navigating hierarchies, or batch queries. Notable gaps exist, but the two tools serve essential needs.
Maintenance
Related MCP Connectors
Read-only U.S. lab-test catalog, collection-site search, and reference-range context.
Query Health Gorilla FHIR patients, conditions, medications and lab results.
Diagnoses, drugs & lab codes: ICD-11, LOINC, RxNorm, MeSH, ATC, CID-10. 33 tools, MIT.
Look up drug names, RxCUIs, ingredients and interactions in RxNorm.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables LLMs to search LOINC terms with free-text, relevance-ranked, and faceted queries via the LOINC Search API, mirroring the loinc.org/search experience.5MIT
- AlicenseNot gradedqualityCmaintenanceSearch medical codes including ICD-10, LOINC, and clinical terms for conditions, procedures, and drugs via natural language queries.293 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables searching clinical terms and codes across UMLS vocabularies, retrieving concept details, listing source-asserted atoms, and crosswalking codes between vocabularies via the NLM UMLS Terminology Services REST API.304 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables term search, class lookup, and cross-ontology mappings across NCBO BioPortal's ~1,300 biomedical ontologies.88 npmMIT