io.github.SidneyBissoli/medical-terminologies-mcp icon
io.github.SidneyBissoli

medical-terminologies-mcp

Medical Terminologies MCP

Unified MCP lookup server for ICD-11, SNOMED, LOINC, RxNorm, MeSH, ATC, CID-10. 37 tools, MIT.

Hosted
communityknowledge

Deployment

Hosted
streamable-httphttps://medical-terminologies-mcp.sidneybissoli.workers.dev/mcp

Package Details

medical-terminologies-mcp

1.5.0•https://www.npmjs.com/package/medical-terminologies-mcp
Transportstdio

Environment Variables

WHO_CLIENT_ID

WHO ICD-11 API Client ID. Required only for ICD-11 tools (5 tools); the server starts without it and other terminologies (LOINC, RxNorm, MeSH, ATC, CID-10) work unauthenticated. Get credentials at https://icd.who.int/icdapi.

WHO_CLIENT_SECRET
Secret

WHO ICD-11 API Client Secret. Required only for ICD-11 tools.

WHO_ICD11_RELEASE_ID

ICD-11 release to query (e.g. 2024-01, 2025-01). Optional; defaults to 2024-01.

ENABLE_SNOMED_TOOLS

Set to 'true' to register the 6 SNOMED-dependent tools (snomed_search, snomed_concept, snomed_hierarchy, snomed_descriptions, snomed_ecl, plus map_snomed_to_icd10). Disabled by default because the historical public IHTSDO Snowstorm endpoint was retired (HTTP 410 Gone). Requires SNOMED_BASE_URL pointing at a working self-hosted Snowstorm.

SNOMED_BASE_URL

Base URL of a self-hosted Snowstorm instance (e.g. https://my-snowstorm.example.com/snowstorm/snomed-ct). Required only when ENABLE_SNOMED_TOOLS is true.

SNOMED_LANGUAGE

Accept-Language tag(s) for SNOMED responses (e.g. pt, pt-BR, es). Optional; defaults to 'en'. Composite values with q-weights depend on the upstream Snowstorm instance.

LOG_LEVEL

pino log level (debug, info, warn, error, fatal). Optional; defaults to 'info'. Logs go to stderr only — never stdout (which is the MCP stdio transport).

medical-terminologies-mcp

1.5.0•https://www.npmjs.com/package/medical-terminologies-mcp
TransportStreamable HTTP

Package Arguments

Named
--http
--port
3000TCP port to listen on. Update the transport URL above if you change this.
--host
0.0.0.0Bind address. Defaults to 127.0.0.1 in CLI; 0.0.0.0 here so containers can route in.

Environment Variables

WHO_CLIENT_ID

WHO ICD-11 API Client ID. Required only for ICD-11 tools.

WHO_CLIENT_SECRET
Secret

WHO ICD-11 API Client Secret. Required only for ICD-11 tools.

WHO_ICD11_RELEASE_ID

ICD-11 release to query (e.g. 2024-01, 2025-01). Optional; defaults to 2024-01.

ENABLE_SNOMED_TOOLS

Set to 'true' to register the 6 SNOMED-dependent tools. Requires SNOMED_BASE_URL.

SNOMED_BASE_URL

Base URL of a self-hosted Snowstorm instance. Required only when ENABLE_SNOMED_TOOLS is true.

SNOMED_LANGUAGE

Accept-Language tag(s) for SNOMED responses (e.g. pt, pt-BR, es). Optional; defaults to 'en'.

LOG_LEVEL

pino log level. Optional; defaults to 'info'.