medical-codes-mcp-server — Claude Code MCP server: setup and tools
A local index of US medical codes your agent can query: decode, search by description, check billability, crosswalk between systems.
Apache-2.0 422 installs ★ 4 updated 2026-10-08
claude mcp add --transport http medical-codes-mcp-server https://medical-codes-mcp-server--cyanheads.run.toolsWhat medical-codes-mcp-server does
Six tools sit on top of a bundled index of US medical code sets. Search official descriptions to reach a code, decode a batch of codes, confirm whether one is current and billable, or crosswalk between codes, drugs, NDCs and drug classes.
Everything ships as one SQLite database with FTS5 search, opened read-only when the server starts. It holds ICD-10-CM diagnoses, ICD-10-PCS procedures, HCPCS Level II, RxNorm with NDC links, and an RxClass layer over those drugs. No API key, and lookups stay local.
Because the data snapshot ships with the package, medcode_list_systems is where you see which releases are actually live. Licensed class sources such as ATC and SNOMED CT are left out. Output is reference material: a billable flag does not settle reimbursement, and codes still need checking against the federal releases and the payer's rules.
What it helps with
- decode a column of diagnosis codes from an export
- turn a clinical description into a procedure code
- check whether a code is current and billable
- map a drug to its RXCUI, NDC and class memberships
- walk a code system's hierarchy without a search term
Example prompts for the agent
- Decode every code in
claims.csvand flag the ones that aren't billable - Find the ICD-10-CM code that matches “lower back pain”
- Map RXCUI
1191to its brand names and RxClass classes
How to install medical-codes-mcp-server
Platform CLI: remote server
claude mcp add --transport http medical-codes-mcp-server https://medical-codes-mcp-server--cyanheads.run.toolsPlatform CLI: remote server
codex mcp add medical-codes-mcp-server --url https://medical-codes-mcp-server--cyanheads.run.toolsConfig file
{
"mcpServers": {
"medical-codes-mcp-server": {
"url": "https://medical-codes-mcp-server--cyanheads.run.tools"
}
}
}Config file
{
"servers": {
"medical-codes-mcp-server": {
"type": "http",
"url": "https://medical-codes-mcp-server--cyanheads.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http medical-codes-mcp-server https://medical-codes-mcp-server--cyanheads.run.toolsStep 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-codes-mcp-server
How do I install medical-codes-mcp-server in Claude Code?
Run claude mcp add --transport http medical-codes-mcp-server https://medical-codes-mcp-server--cyanheads.run.tools. The connection uses HTTP.
What does medical-codes-mcp-server do?
It looks up, decodes and validates ICD-10-CM, ICD-10-PCS, HCPCS Level II and RxNorm codes against a local database. It also links drugs to RXCUI, NDC and RxClass classes.
Does it need an API key?
No. The code sets are packaged into the database that comes with the server, drawn from public federal releases.