Medical Terminologies MCP

Unified access to global medical terminologies: ICD-11, SNOMED CT, LOINC, RxNorm, MeSH. 27 tools for medical coding, terminology lookup, and crosswalk mappings.

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(opt-in; requires self-hosted Snowstorm)
- LOINC- Logical Observation Identifiers Names and Codes
- RxNorm- Normalized names for clinical drugs (NIH)
- MeSH- Medical Subject Headings (NLM)
- ATC- Anatomical Therapeutic Chemical classification (WHO Collaborating Centre, served via NLM RxClass)
- CID-10- Brazilian Portuguese translation of ICD-10 (DataSUS V2008, bundled)

- "What's the ICD-11 code for type 2 diabetes?"→icd11_search
- "Map ICD-10 code E11 to ICD-11."→map_icd10_to_icd11
- "What does LOINC 2339-0 measure?"→loinc_details
- "Qual o código CID-10 para infarto agudo do miocárdio?"→cid10_search

The answers come from authoritative sources (WHO, NLM, NIH, DataSUS) — real codes and mappings, not guesses from training data.

- 31 default tools (37 with SNOMED enabled) for medical terminology lookup
- 3 MCPPromptsthat orchestrate tool calls into named workflows (find-medical-code,drug-info,cid10-portuguese-lookup) — clients render these as one-click user actions
- 4 MCPResourcesfor in-process reference content (info://server,info://cid10/chapters,info://licenses,info://stats) — sub-millisecond reads (exceptinfo://statswhich round-trips to the StatsCounter Durable Object on the hosted endpoint)
- Multi-terminology support in a single server
- Cross-terminology mapping and search
- Provenance on every response(since v1.8.0): each successful tool result carries a machine-readable provenance block — source, canonical URL, data vintage, real extraction instant (cache hits keep the original fetch instant), ready-to-use citation, and license — instructuredContent.provenance+attribution, mirrored in_metaundercom.sidneybissoli.medical/, with a compact text footer for text-only clients. Multi-source responses (find_equivalent,validate_codes) carry one block per source; server-computed ranking fields are flagged as derived
- Built-in caching for improved performance
- Rate limiting to respect API limits
- Detailed responses with rich formatting
- Two transports:stdio(default; for Claude Desktop, IDE clients) andStreamable HTTP(the hosted Cloudflare Worker athttps://medical.sidneybissoli.com/mcp, or your own instance ofworker/)

npx @modelcontextprotocol/inspector --transport streamable-http \ --server-url https://medical.sidneybissoli.com/mcp

npx -y smithery mcp add sidneybissoli/medical-terminologies-mcp

npm install -g medical-terminologies-mcp

{ "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" } } } }

npm ci && cd worker && npm ci npm run dev # wrangler dev on http://localhost:8787 # Inspector via HTTP npx @modelcontextprotocol/inspector --transport streamable-http --server-url http://localhost:8787/mcp

npm ci && npm run build:worker-lib cd worker && npm ci npx wrangler login # one-time, browser flow npx wrangler deploy # publishes to <name>.<account>.workers.dev # Set ICD-11 secrets so those 5 tools work: npx wrangler secret put WHO_CLIENT_ID npx wrangler secret put WHO_CLIENT_SECRET

After your Worker is live, register the URL on Smithery:
- Visithttps://smithery.ai→Publish → MCP(orhttps://smithery.ai/new).
- Pick theURLsubmission path (Smithery deprecated container hosting in 2024 — URL is the supported flow now).
- Pastehttps://<your-worker>.workers.dev/mcp. Smithery's gateway scans for compliance and proxies traffic.

These are only registered whenENABLE_SNOMED_TOOLS=true. SeeSNOMED CT setup (advanced).

## LOINC Search Results for "glucose" Found 1024 total results (showing 3): 1. 74790-7 - Glucose challenge (hydrogen breath test) panel - Exhaled gas Component: Glucose challenge panel | Method: - 2. 104708-3 - Deprecated Estimated average glucose [Moles/volume] in Blood Component: Estimated average glucose | Property: SCnc 3. 97510-2 - Glucose measurements in range out of Total glucose measurements during reporting period Component: Glucose measurements in range/Total glucose measurements | Property: NFr | Method: Calculated

total_count(1024) reflects every match in the NLM Clinical Tables index, not just the page returned. Bumpmax_results(max 50) to see canonical codes like2339-0(Glucose [Mass/volume] in Blood); the API's relevance ranking puts panels and derived measurements above plain blood-glucose at small page sizes.

rxnorm_ingredients— rxcui: "6809" (metformin)

# Ingredients for RxCUI 6809 Found 18 ingredient(s): | RxCUI | Name | Type | |-------|------|------| | 6809 | metformin | Single Ingredient | | 1007411 | chlorpropamide / metformin | Multiple Ingredient | | 1043562 | metformin / saxagliptin | Multiple Ingredient | | 1243019 | linagliptin / metformin | Multiple Ingredient | | 1486436 | dapagliflozin / metformin | Multiple Ingredient | | 1545149 | canagliflozin / metformin | Multiple Ingredient | | 1664314 | empagliflozin / metformin | Multiple Ingredient | | 729717 | metformin / sitagliptin | Multiple Ingredient | | ... | (10 more combinations) | Multiple Ingredient |

For an RxCUI that is itself an ingredient (TTY=IN), the tool returns that ingredient plus every multi-ingredient (TTY=MIN) concept that includes it. Use this to enumerate combination products built around a substance.

mesh_descriptor— mesh_id: "D006973" (Hypertension)

# Hypertension MeSH ID: D006973 ## Scope Note Persistently high systemic arterial BLOOD PRESSURE. Based on multiple readings (BLOOD PRESSURE DETERMINATION), hypertension is currently defined as when SYSTOLIC PRESSURE is consistently greater than 140 mm Hg or when DIASTOLIC PRESSURE is consistently 90 mm Hg or more. ## Tree Numbers - C14.907.489 ## Concepts - Hypertension (preferred) ## Allowed Qualifiers 35 qualifier(s) allowed. Use mesh_qualifiers for details.

The scope note comes from the descriptor'spreferred concept, not its annotation field (which is an indexer-facing note). Tree numbers are the navigable path into MeSH's controlled hierarchy —C14.907.489places Hypertension under Cardiovascular Diseases → Vascular Diseases.

- ICD-11 lookup:icd11_searchwith a clinical term → pick the result →icd11_lookupwith the code for full details, oricd11_hierarchyto walk parents/children.
- Drug pipeline:rxnorm_searchfor a brand or generic name →rxnorm_conceptfor the canonical record →rxnorm_ingredientsandrxnorm_classesfor downstream analysis.
- Cross-terminology scaffolding:find_equivalentwith a clinical term searches ICD-11, LOINC, RxNorm, MeSH, and (when enabled) SNOMED in one call. Use it to bootstrap mappings; the pairwisemap_tools refine them.
- ICD-10 → ICD-11 (text search, not authoritative):map_icd10_to_icd11does honest text search against WHO ICD-11. Real WHO transition tables are tracked inPROGRESS.md Phase 13.1.

{ "mcpServers": { "medical-terminologies": { "command": "npx", "args": ["-y", "medical-terminologies-mcp"], "env": { "WHO_CLIENT_ID": "...", "WHO_CLIENT_SECRET": "...", "ENABLE_SNOMED_TOOLS": "true", "SNOMED_BASE_URL": "https://my-snowstorm.example.com/snowstorm/snomed-ct", "SNOMED_LANGUAGE": "en" } } } }

- Required citation:"International Classification of Diseases, Eleventh Revision (ICD-11), World Health Organization (WHO) 2019https://icd.who.int/browse11. Licensed under the Creative Commons Attribution-NoDerivatives 3.0 IGO licence (CC BY-ND 3.0 IGO)."
- This server always serves ICD-11 codes and titles together with their URIs, verbatim; non-English labels are WHO's own official translations (never machine-translated)
- WHO may terminate the license at any time by notice (§4.7)
- API access requires registration athttps://icd.who.int/icdapi

SNOMED CT use requires an IHTSDO (SNOMED International) license. The SNOMED tools in this server are disabled by default and only enabled by operators with a valid license and a self-hosted Snowstorm instance — seeSNOMED CT setup (advanced).

- Member countries have national licenses
- Affiliate licenses available for others (Brazil is not a member country)
- More info:https://www.snomed.org/get-snomed

This material contains content from LOINC (http://loinc.org). LOINC is copyright © Regenstrief Institute, Inc. and the Logical Observation Identifiers Names and Codes (LOINC) Committee and is available at no cost under the license athttp://loinc.org/license. LOINC® is a registered United States trademark of Regenstrief Institute, Inc.

ATC classification © WHO Collaborating Centre for Drug Statistics Methodology (https://atcddd.fhi.no/), retrieved via NLM RxClass and served verbatim. This server never redistributes the WHOCC ATC/DDD index.

MeSH is a U.S. government work served under theNLM Terms and Conditions. Courtesy of the U.S. National Library of Medicine.

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

npx @modelcontextprotocol/inspector node dist/index.js

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

Note: While this software is MIT licensed, the medical terminologies accessed through it have their own licenses (seeTerminology Licensesabove).