medical-terminologies-mcp is a Model Context Protocol server that lets an MCP-compatible AI assistant run structured lookups against medical code systems: ICD-11, LOINC, RxNorm, MeSH, ATC, a bundled Brazilian Portuguese CID-10 table, and an optional SNOMED CT tool set. The assistant retrieves codes and records from named sources instead of recalling them from memory. Sidney Bissoli’s walkthrough, published May 12, 2026 on DEV Community, demonstrates three uses: finding a laboratory code, breaking a combination drug into ingredients and ATC classes, and drafting a MeSH-aware PubMed query. The server is a lookup layer. It does not decide diagnosis, treatment, or whether a code fits a particular patient.
What the server covers
The walkthrough describes seven systems. Each one is reached differently and carries its own licensing terms, so the table below is the starting point for any deployment decision.
As an Amazon Associate I earn from qualifying purchases.
| System | Source named in the walkthrough | Access notes |
|---|---|---|
| ICD-11 | WHO | Live lookup requires WHO credentials. |
| LOINC | LOINC | Access mode not stated in the walkthrough. |
| RxNorm | NLM | Access mode not stated in the walkthrough. |
| MeSH | NLM | Access mode not stated in the walkthrough. |
| ATC | NLM RxClass | Access mode not stated in the walkthrough. |
| CID-10 (Brazilian Portuguese) | DataSUS V2008 data | Bundled with the server; no live call needed. |
| SNOMED CT (optional) | SNOMED International | Requires a SNOMED International license and a self-hosted Snowstorm instance. The historical public endpoint has been retired. |
According to the walkthrough, the setup it describes needs WHO credentials only for live ICD-11 lookup. The other 26 functions in that configuration run without them, including the bundled ICD-10 to ICD-11 mapping. Some functions call live APIs while CID-10 is bundled, so a configuration that works offline for CID-10 may still need network access and credentials for other systems.
Setup as the walkthrough describes it
- The client configuration launches the server with
npx -y medical-terminologies-mcp. - Add WHO credentials only if you need live ICD-11 lookup.
- The walkthrough also identifies a hosted Streamable HTTP endpoint as an alternative to local launch.
- Check the current package instructions and the hosted endpoint’s availability before copying these commands. Package behavior and tool counts change between releases (see the version table below).
Walkthrough 1: Find and verify a LOINC code
The walkthrough’s clinical example asks: “What’s the LOINC code for procalcitonin in serum?” The workflow runs in two passes, a search and then a detail check.
#1 Best Overall
- Ask the assistant for the LOINC code for the analyte and specimen you need, in plain language.
- Review the search results. The walkthrough’s search returns
33959-8, labeled “Procalcitonin [Mass/volume] in Serum or Plasma.” - Run a detail lookup on the candidate code. The walkthrough shows its attributes and active status.
- Confirm the code and its attributes against the record in the system where it will be used before you rely on it.
The walkthrough also lists three further examples: lactate (2524-7), high-sensitivity troponin I (67151-1), and SpO₂ (59408-5). These are examples the author reports, and the walkthrough does not show independent testing of them.
Walkthrough 2: Break down a combination medication
The walkthrough’s medication example asks: “I need to break down Janumet for the admission med rec. What are the active ingredients and their drug classes?” The steps follow the server’s search, ingredient, and classification functions.
- Search for the brand name, Janumet.
- Retrieve the ingredients the server returns: sitagliptin and metformin.
- Look up the ATC classification for each ingredient.
| Ingredient | ATC code(s) shown in the walkthrough |
|---|---|
| Sitagliptin | A10BH |
| Metformin | A10BA and A10BD |
This is an information-retrieval workflow. The walkthrough does not establish that the output is enough for medication reconciliation, interaction assessment, or patient-specific prescribing. Those tasks need the product labeling and the clinical checks your setting requires.
Quick wins for a faster PC:
Fix the driver behind crashes, sound loss and screen glitchesFind Drivers →Clear out junk files and repair common Windows errorsFree Scan →Scan for outdated or missing drivers - takes under a minuteDriver Scan →Walkthrough 3: Build a MeSH-aware literature search
The research example is a question about primary health care interventions and avoidable hospitalizations. The walkthrough uses MeSH to shape the query before it moves to PubMed.
- Search MeSH descriptors for the concepts in your question.
- Retrieve the tree positions and allowed qualifiers for the chosen descriptor. The walkthrough uses Primary Health Care.
- Add qualifiers that fit the question. The walkthrough uses
/utilizationand/statistics & numerical data. - Draft the PubMed query from those terms and inspect how it reads before running it.
Controlled vocabulary lookup helps a researcher build and inspect a search strategy. It does not replace review-method expertise, and it does not establish that a systematic review’s search is complete. Those checks remain with the review team.
Mapping: table-backed versus guidance-only
The walkthrough distinguishes two kinds of mapping. The ICD-10 to ICD-11 tool uses bundled WHO transition tables. Where a curated mapping is not available, the server gives guidance rather than a mapping. The LOINC-to-SNOMED and SNOMED-to-ICD-10 functions are guidance only in the version the walkthrough describes, and are not curated authoritative mappings.
For scale, the author reports 11,243 ICD-10 categories in the WHO 2025-01 transition tables, and 1,461 of those categories with multiple WHO-documented ICD-11 candidates. These figures are the author’s reading of the WHO data. Check them against the WHO release before citing them.
Windows Errors? Fix Them Before They Spread
Repair common Windows errors and clear accumulated junk for a smoother, more stable PC - no reinstall needed.Free scan · no reinstallCrashes, No Sound, or Screen Glitches?
Random freezes, missing sound and display glitches usually trace back to one bad driver. Find and replace yours safely.Free scan · under a minuteOther features and their status
- Batch code validation.
- Terminology version and difference information.
- MCP Prompts and Resources, and structured output.
- API rate limits and retries.
- Two transports: local launch and hosted Streamable HTTP.
The walkthrough reports a test suite and daily integration checks. These are project-author claims that the walkthrough reports. Confirm them against the project’s own documentation for the version you install.
Licensing and upstream terms
- WHO attribution applies to ICD-11 data.
- Optional SNOMED CT tools need a SNOMED International license and a self-hosted Snowstorm backend.
- The project repository documents terminology-specific licensing differences.
Review the current upstream terms and your local policies before deployment. This matters most if you redistribute terminology data or use outputs in regulated workflows.
Versions and counts: what each source says
The walkthrough, the project repository, and the official Model Context Protocol Registry list the server with different counts and dates. Use the table to see which source reports which figure.
| Source | Date | Version | Tools | Systems |
|---|---|---|---|---|
| Walkthrough (Sidney Bissoli, DEV Community) | May 12, 2026 | Not stated | 31 | Seven, including optional SNOMED CT |
| Project GitHub repository | Inspected October 7, 2026 | Not stated | Not stated | Heading lists six; body describes optional SNOMED CT |
| Official MCP Registry listing | Updated October 6, 2026 | 2.1.1 | 33 | Short description names six: ICD-11, LOINC, RxNorm, MeSH, ATC, CID-10 |
The registry listing is current evidence of what is published. It does not prove every runtime capability. For a present-tense setup guide, confirm the installed package’s version, tool list, and system list directly.
Recommended Free Tools
Where lookup ends and clinical judgment begins
Bissoli states the boundary plainly: “None of this is a substitute for clinical judgment. It’s a lookup layer for already-known codes, not a diagnostic tool.”
Best Value
- Essential guide to the language of medicine
- Includes 1 000 new words and senses
- Covers the latest brand names and generic equivalents of common drugs
- Pronunciation provided for all entries
In practice, treat each result as a candidate that you verify before it reaches a chart, a medication list, or a protocol:
- Lab codes: check the detail record and the specimen or method against the system that will use the code.
- Drug ingredients and ATC classes: check against current product labeling and your pharmacy’s reference before using them in reconciliation.
- Mapped codes: treat table-backed mappings and guidance-only crosswalks differently, and confirm any guidance-only result with a curated source.
- Search terms: have the search strategy reviewed by the people responsible for the review or study.
Used this way, the server saves lookup time and makes the source of each code visible. It does not remove the need to verify.
Quick Recap
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
What’s actually slowing this PC down?
Pick the symptom - the matching free tool is one click away.
