Skip to content
MCP server

Medical Terminologies MCP

Look up ICD-11, ICD-10 mappings, LOINC, RxNorm, MeSH, ATC and CID-10 codes

Install
Pricing
Open source
Platforms
API, CLI, self-hosted
Runs
Locally or Remotely
Version
2.4.0
Listing updated
3 days ago

About Medical Terminologies MCP

Medical Terminologies MCP is an open-source MCP server for health and science. It can run locally on your machine or as a hosted remote server.

One server covers six medical coding systems and the mappings between them, pulling live from WHO and NLM sources. Typical questions are the ICD-11 code for type 2 diabetes, how ICD-10 code E11 maps to ICD-11 using the WHO's own transition table, or what LOINC 2339-0 measures. ATC is served through NLM's RxClass, and the Brazilian CID-10 (DataSUS V2008) is bundled, so those lookups make no network call and have no rate limit.

Labels in Portuguese come from the WHO and NLM themselves, never from machine translation. Several calls work across systems: find_equivalent, and validate_codes, which checks up to 100 codes over six terminologies in one request. Each response includes a provenance block per source with URL, data vintage, retrieval time and licence. The README also describes three prompts (find-medical-code, drug-info, cid10-portuguese-lookup) and four info:// resources.

The ICD-11 tools need free WHO API credentials (WHO_CLIENT_ID and WHO_CLIENT_SECRET) when you self-host; the other terminologies work without them. The README says this is not a clinical decision tool and is aimed at researchers, public-health analysts, informatics developers and educators.

Install

Run in a terminal

claude mcp add --transport http medical-terminologies-mcp https://medical.sidneybissoli.com/mcp

Add to Settings → Connectors → Add custom connector

https://medical.sidneybissoli.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "medical-terminologies-mcp": {
      "url": "https://medical.sidneybissoli.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "medical-terminologies-mcp": {
      "type": "http",
      "url": "https://medical.sidneybissoli.com/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "medical-terminologies-mcp": {
      "serverUrl": "https://medical.sidneybissoli.com/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "medical-terminologies-mcp": {
      "type": "http",
      "url": "https://medical.sidneybissoli.com/mcp"
    }
  }
}

Configuration

  • WHO_CLIENT_IDWHO 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_SECRETWHO ICD-11 API Client Secret. Required only for ICD-11 tools.
  • WHO_ICD11_RELEASE_IDICD-11 release to query (e.g. 2024-01, 2025-01). Optional; defaults to 2026-01.
  • LOG_LEVELpino log level (debug, info, warn, error, fatal). Optional; defaults to 'info'. Logs go to stderr only — never stdout (which is the MCP stdio transport).
  • WHO_CLIENT_IDWHO ICD-11 API Client ID. Required only for ICD-11 tools.
  • WHO_CLIENT_SECRETWHO ICD-11 API Client Secret. Required only for ICD-11 tools.
  • WHO_ICD11_RELEASE_IDICD-11 release to query (e.g. 2024-01, 2025-01). Optional; defaults to 2026-01.
  • LOG_LEVELpino log level. Optional; defaults to 'info'.

Tools this server provides (8)

Taken from the project documentation; the running server may differ.

icd11_search
Search ICD-11 for a diagnosis code.
map_icd10_to_icd11
Map an ICD-10 code to ICD-11.
loinc_details
Return details of a LOINC code.
cid10_search
Search the Brazilian CID-10.
find_equivalent
Find equivalent codes across terminologies.
validate_codes
Validate codes across terminologies in batch.
search
Search for ChatGPT Deep Research.
fetch
Fetch a result for ChatGPT Deep Research.

What it does

Six terminologies
ICD-11, LOINC, RxNorm, MeSH, ATC and Brazilian CID-10 in one server.
ICD-10 to ICD-11 mapping
Uses the authoritative WHO transition mapping.
Bundled CID-10
DataSUS V2008 ships inside the package, offline and unlimited.
Batch validation
Check up to 100 codes across six terminologies per call.
Official translations
Portuguese labels come from WHO and NLM, not machine translation.
Provenance per source
Source, vintage, licence and citation on every response.

Good for

  • Find the right ICD-11 code for a diagnosis
  • Convert a legacy ICD-10 list to ICD-11
  • Identify what a lab LOINC code measures
  • Validate a spreadsheet of mixed medical codes
  • Look up Brazilian CID-10 chapters and codes

Pricing

Open source

Free; MIT licensed, hosted endpoint available

Prices change. Check medical.sidneybissoli.com before you buy.

Medical Terminologies MCP FAQ

Do I need credentials?

Only for the five ICD-11 tools when self-hosting; the hosted endpoint is at https://medical.sidneybissoli.com/mcp and other terminologies need none.

Is it for clinical decisions?

No. The README says it is not a clinical-care decision tool.

Where does CID-10 come from?

The DataSUS V2008 version, bundled in the package.

How many tools are there?

33: 31 terminology tools plus search and fetch.

Is Medical Terminologies MCP free?

Yes. Medical Terminologies MCP is open source, so you can use and self-host it for free.

How do I add Medical Terminologies MCP to Claude Code?

Run this command in your terminal: claude mcp add --transport http medical-terminologies-mcp https://medical.sidneybissoli.com/mcp

What are the best alternatives to Medical Terminologies MCP?

The closest alternatives to Medical Terminologies MCP are Tooluniverse, Oya Browser, Later Stages, MedXpert 标准检索连接器 and MedXpert 全球法规连接器 (reg-connector).

Alternatives to Medical Terminologies MCP

  1. Tooluniverse

    MCP server

    MCP server giving AI agents access to thousands of scientific research tools

    Runs locally
    • Open source
    • 1.8K GitHub stars
    • Health and science
  2. Oya Browser

    MCP server

    HIPAA-oriented agentic browser with replayable playbooks, reachable over MCP

    • 32 tools
    • Remote
    • Freemium
    • 349 GitHub stars
    • Browser automation
  3. Later Stages

    MCP server

    California senior living and care provider records from state licensing and Medicare

    • 6 tools
    • Remote
    • Free
    • Health and science
  4. Read-only local index of medical-device standards with official links, no standard text

    Runs locally
    • 4 tools
    • Free
    • Legal and government
  5. Splyt

    MCP server

    Let Claude or ChatGPT read your Splyt workouts, records, plan, habits and sleep

    • Remote
    • Free
    • Health and science