Skip to main content
Glama
loinc-mcp

loinc-mcp

by robsyc

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

Search LOINC codes by text query. Returns codes, names, and classifications.

get_code

Get full details for a LOINC code: parts, classification, units, panel members, and answer options.

Related MCP server: medical-codes

Quick Start

Prerequisites

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:mcp

Acknowledgments

Available Tools

2 tools
get_codeA
Read-onlyIdempotent

Get full details for a LOINC code: name, parts, classification, units, and panel members/answer options if applicable.

Inputs: code (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 2 tools

    Disambiguation5/5

    get_code retrieves details for a specific code, while search finds codes by text. Their purposes are completely distinct, leaving no ambiguity.

    Naming Consistency4/5

    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.

    Tool Count3/5

    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.

    Completeness3/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables LLMs to search LOINC terms with free-text, relevance-ranked, and faceted queries via the LOINC Search API, mirroring the loinc.org/search experience.
      5
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Search medical codes including ICD-10, LOINC, and clinical terms for conditions, procedures, and drugs via natural language queries.
      293 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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 npm
      MIT