Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http medical-codes-mcp-server https://medical-codes-mcp-server--cyanheads.run.tools
Open on GitHub

What 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.csv and flag the ones that aren't billable
  • Find the ICD-10-CM code that matches “lower back pain”
  • Map RXCUI 1191 to 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.tools

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-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.

Similar MCP servers

All MCP servers for Data and databases →

Project sponsors

Companies that keep this analytics open