Medical Terminologies MCP — Claude Code MCP server: setup guide
An MCP server for querying authoritative medical registries like ICD-11, LOINC, MeSH, and RxNorm. Ideal for health informatics projects and code cross-referencing.
claude mcp add --transport http medical-terminologies-mcp https://medical.sidneybissoli.com/mcpWhat Medical Terminologies MCP does
This integration exposes thirty-three tools to query global health standards straight from your agent. It handles lookups for ICD-11 conditions, RxNorm drug identifiers, MeSH hierarchies, and LOINC laboratory observations. The Brazilian CID-10 dataset and the official WHO transition tables reside inside the package, resolving locally without outbound network requests.
All other vocabulary searches dispatch live requests to public endpoints run by the WHO and the US National Library of Medicine. Never pass raw patient records into prompts. Plaintext input travels over the network to external APIs. The tool supplies terminology lookups, not clinical recommendations.
A hosted streamable HTTP endpoint runs on Cloudflare Workers and works without credentials. If you run the package locally through npx over stdio, you must configure WHO_CLIENT_ID and WHO_CLIENT_SECRET for direct WHO API authorization. Every response attaches origin provenance with reference links and extraction timestamps.
What it helps with
- look up diagnostic entries in the ICD-11 classification
- map legacy ICD-10 identifiers to ICD-11 codes
- inspect laboratory observation metadata using LOINC numbers
- traverse drug categories and descriptors in MeSH or ATC
Example prompts for the agent
- Find the ICD-11 code for type 2 diabetes
- Translate ICD-10 code E11 into ICD-11
- Show the test definition for LOINC code 2339-0
How to install Medical Terminologies MCP
1Platform CLI: remote server
claude mcp add --transport http medical-terminologies-mcp https://medical.sidneybissoli.com/mcp2Platform CLI
claude mcp add --env WHO_CLIENT_ID=<WHO_CLIENT_ID> --env WHO_CLIENT_SECRET=<WHO_CLIENT_SECRET> --env WHO_ICD11_RELEASE_ID=<WHO_ICD11_RELEASE_ID> --env LOG_LEVEL=<LOG_LEVEL> --transport stdio medical-terminologies-mcp -- npx -y medical-terminologies-mcpReplace <…> with your own values
1Platform CLI: remote server
codex mcp add medical-terminologies-mcp --url https://medical.sidneybissoli.com/mcp2Platform CLI
codex mcp add medical-terminologies-mcp --env WHO_CLIENT_ID=<WHO_CLIENT_ID> --env WHO_CLIENT_SECRET=<WHO_CLIENT_SECRET> --env WHO_ICD11_RELEASE_ID=<WHO_ICD11_RELEASE_ID> --env LOG_LEVEL=<LOG_LEVEL> -- npx -y medical-terminologies-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"medical-terminologies-mcp": {
"url": "https://medical.sidneybissoli.com/mcp"
}
}
}{
"mcpServers": {
"medical-terminologies-mcp": {
"command": "npx",
"args": [
"-y",
"medical-terminologies-mcp"
],
"env": {
"WHO_CLIENT_ID": "<WHO_CLIENT_ID>",
"WHO_CLIENT_SECRET": "<WHO_CLIENT_SECRET>",
"WHO_ICD11_RELEASE_ID": "<WHO_ICD11_RELEASE_ID>",
"LOG_LEVEL": "<LOG_LEVEL>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"medical-terminologies-mcp": {
"type": "http",
"url": "https://medical.sidneybissoli.com/mcp"
}
}
}{
"servers": {
"medical-terminologies-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"medical-terminologies-mcp"
],
"env": {
"WHO_CLIENT_ID": "<WHO_CLIENT_ID>",
"WHO_CLIENT_SECRET": "<WHO_CLIENT_SECRET>",
"WHO_ICD11_RELEASE_ID": "<WHO_ICD11_RELEASE_ID>",
"LOG_LEVEL": "<LOG_LEVEL>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http medical-terminologies-mcp https://medical.sidneybissoli.com/mcp2Platform CLI
gemini mcp add -e WHO_CLIENT_ID=<WHO_CLIENT_ID> -e WHO_CLIENT_SECRET=<WHO_CLIENT_SECRET> -e WHO_ICD11_RELEASE_ID=<WHO_ICD11_RELEASE_ID> -e LOG_LEVEL=<LOG_LEVEL> medical-terminologies-mcp npx -y medical-terminologies-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Medical Terminologies MCP
How do I install Medical Terminologies MCP in Claude Code?
Run claude mcp add --transport http medical-terminologies-mcp https://medical.sidneybissoli.com/mcp to connect to the hosted HTTP endpoint.
What is Medical Terminologies MCP used for?
It queries official WHO, NLM, and NIH endpoints so your assistant references verified medical classifications instead of hallucinated codes.
Are API credentials required to run this MCP server?
No credentials are required when using the hosted HTTP service at https://medical.sidneybissoli.com/mcp. Local stdio setups need WHO_CLIENT_ID and WHO_CLIENT_SECRET to query the WHO API directly.
