Medical Terminologies MCP

Command

Environment

• 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_SECRETsecret

  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).