Medical Terminologies MCP Server

A Model Context Protocol (MCP) server providing unified access to major global medical terminologies:

• ICD-11 - International Classification of Diseases (WHO)
• SNOMED CT - Systematized Nomenclature of Medicine
• LOINC - Logical Observation Identifiers Names and Codes
• RxNorm - Normalized names for clinical drugs (NIH)
• MeSH - Medical Subject Headings (NLM)

Features

• 27 specialized tools for medical terminology lookup
• Multi-terminology support in a single server
• Cross-terminology mapping and search
• Built-in caching for improved performance
• Rate limiting to respect API limits
• Detailed responses with rich formatting

Installation

Global Installation (Recommended)

npm install -g medical-terminologies-mcp

Local Installation

npm install medical-terminologies-mcp

Configuration

Claude Desktop

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "medical-terminologies": {
      "command": "npx",
      "args": ["-y", "medical-terminologies-mcp"],
      "env": {
        "WHO_CLIENT_ID": "your-who-client-id",
        "WHO_CLIENT_SECRET": "your-who-client-secret"
      }
    }
  }
}

Environment Variables

*Required for ICD-11 tools. Get credentials at: https://icd.who.int/icdapi

Other APIs (LOINC, RxNorm, MeSH, SNOMED CT) do not require authentication.

Available Tools (27)

ICD-11 Tools (5)

LOINC Tools (4)

RxNorm Tools (5)

MeSH Tools (4)

SNOMED CT Tools (5)

Crosswalk Tools (4)

Usage Examples

Search for a diagnosis in ICD-11

Use icd11_search with query "type 2 diabetes mellitus"

Look up a lab test in LOINC

Use loinc_details with loinc_num "2339-0" to get glucose test details

Find drug information in RxNorm

Use rxnorm_search with query "metformin" then rxnorm_concept for details

Search across all terminologies

Use find_equivalent with term "diabetes" to search ICD-11, SNOMED, LOINC, RxNorm, and MeSH

Map ICD-10 to ICD-11

Use map_icd10_to_icd11 with icd10_code "E11" to find ICD-11 equivalents

Terminology Licenses

ICD-11 (WHO)

ICD-11 content is provided under the Creative Commons Attribution-NoDerivatives 3.0 IGO license (CC BY-ND 3.0 IGO).

• You must attribute WHO as the source
• You may not create derivative works
• API access requires registration at https://icd.who.int/icdapi

SNOMED CT

SNOMED CT content is for reference purposes only. Production use requires an IHTSDO (SNOMED International) license.

• Member countries have national licenses
• Affiliate licenses available for others
• More info: https://www.snomed.org/snomed-ct/get-snomed

LOINC

LOINC content is provided under the LOINC License.

• Free for most uses
• Attribution required
• Registration recommended

RxNorm

RxNorm is produced by the U.S. National Library of Medicine and is freely available.

• No license required for use
• Attribution appreciated

MeSH

MeSH is produced by the U.S. National Library of Medicine and is freely available.

• No license required for use
• Attribution appreciated

API Rate Limits

This server implements rate limiting to respect API providers:

Development

Building from source

git clone https://github.com/SidneyBissoli/medical-terminologies-mcp.git
cd medical-terminologies-mcp
npm install
npm run build

Running locally

npm start

Testing with MCP Inspector

npx @modelcontextprotocol/inspector node dist/index.js

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Author

Sidney Bissoli

• GitHub: @SidneyBissoli

License

This project is licensed under the MIT License - see the LICENSE file for details.

Note: While this software is MIT licensed, the medical terminologies accessed through it have their own licenses (see Terminology Licenses above).

Acknowledgments

• WHO for the ICD-11 API
• Regenstrief Institute for LOINC
• U.S. National Library of Medicine for RxNorm and MeSH
• SNOMED International for SNOMED CT
• Anthropic for the Model Context Protocol

Support

If you encounter any issues or have questions:

• Open an issue on GitHub
• Check existing issues for solutions

Made with love for the medical informatics community