SidneyBissoli/medical-terminologies-mcp

A Model Context Protocol (MCP) server providing unified access to major global medical terminologies:
- **ICD-11** - International Classification of Diseases (WHO)
- **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)
🇧🇷 Leia em Português
See it in action
Ask your assistant:
- *"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.
Features
- 33 tools: 31 terminology tools plus search/fetch for ChatGPT Deep Research
- 3 MCP **Prompts** that orchestrate tool calls into named workflows (find-medical-code, drug-info, cid10-portuguese-lookup) — clients render these as one-click user actions
- 4 MCP **Resources** for in-process reference content (info://server, info://cid10/chapters, info://licenses, info://stats) — sub-millisecond reads (except info://stats which 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 — in structuredContent.provenance + attribution, mirrored in _meta under com.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) and **Streamable HTTP** (the hosted Cloudflare Worker at https://medical.sidneybissoli.com/mcp, or your own instance of worker/)
📖 **Article (in Portuguese):** CID-10, CID-11 e o que muda para quem trabalha com dados do SUS — the V2008 structure in numbers, what the WHO transition tables are and are not, and the licences that differ between sources. Also published on the site, in Portuguese and English: sidneybissoli.com.
Who is this for?
This server is **not** a clinical-care decision tool — practicing clinicians have specialized assistants (UpToDate AI, OpenEvidence, EHR-integrated tools) for that. The actual audience is researchers, public-health analysts, clinical informatics developers, and educators who need programmatic access to authoritative terminology data.
| If you're a... | Start with | Why |
|----------------|------------|-----|
| **Biomedical researcher / bibliographer** | mesh_search, mesh_descriptor, mesh_tree | MeSH is PubMed's indexing vocabulary; tree numbers let you traverse the controlled hierarchy programmatically |
| **Public-health analyst (Brazil / SUS)** | cid10_search, cid10_chapters, atc_classify | CID-10 V2008 is the Brazilian operational standard; ATC pairs cleanly with DataSUS prescription data |
| **Public-health analyst (international)** | icd11_search, icd11_lookup, icd11_chapters | WHO ICD-11 is the current international revision; chapters and hierarchy support pipeline classification |
| **Clinical-informatics developer** | loinc_search, loinc_details, find_equivalent | LOINC for lab/observation interoperability; cross-terminology search to scaffold new mappings |
| **Educator / curriculum author** | mesh_descriptor, icd11_lookup, rxnorm_search | Authoritative definitions, tree numbers, and drug term-types you can drop into self-checked exercises |
What this server is not intended for — and what leaves your machine
- **It is not intended for clinical decision support.** It retrieves what the official sources publish. It does not diagnose, recommend treatment or dose.
- **It is not designed to run offline.** ICD-11, LOINC, RxNorm, MeSH and ATC are answered live by the public WHO and NLM APIs. **Every query string you send is forwarded to those services.** De-identify term lists before running them: no patient names, free-text notes or record identifiers. Two datasets are bundled and answered in-process, with no network call: **CID-10** (DataSUS V2008) and the **WHO ICD-10 → ICD-11 transition tables** (map_icd10_to_icd11).