# medical-codes-mcp-server

A local index of US medical codes your agent can query: decode, search by description, check billability, crosswalk between systems.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 422 installs · ★ 4 repo stars
- Author: cyanheads
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cyanheads/medical-codes-mcp-server
- Updated: 2026-10-08
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/medical-codes-mcp-server

## What it 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.

## Requirements
- Remote server: `https://medical-codes-mcp-server--cyanheads.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http medical-codes-mcp-server https://medical-codes-mcp-server--cyanheads.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add medical-codes-mcp-server --url https://medical-codes-mcp-server--cyanheads.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "medical-codes-mcp-server": {
            "url": "https://medical-codes-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "medical-codes-mcp-server": {
            "type": "http",
            "url": "https://medical-codes-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http medical-codes-mcp-server https://medical-codes-mcp-server--cyanheads.run.tools
```

## When to use it
- 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
- 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

## Similar
- [Medical Terminologies MCP](https://affpapa.org/en/nevibecode/mcp/medical-terminologies-mcp.md) — MCP server · ★ 16 repo stars
- [agency-medical-billing-coding-specialist](https://affpapa.org/en/nevibecode/skills/agency-medical-billing-coding-specialist.md) — skill · ★ 85 repo stars
- [local-first](https://affpapa.org/en/nevibecode/skills/local-first.md) — skill · 173 installs
- [Horosa Skill](https://affpapa.org/en/nevibecode/mcp/horosa-skill.md) — MCP server · ★ 525 repo stars
- [omophub-mcp](https://affpapa.org/en/nevibecode/mcp/omophub-mcp.md) — MCP server · ★ 7 repo stars
- [OraFabric Medical Ontology Knowledge Base](https://affpapa.org/en/nevibecode/mcp/orafabric-medical-ontology-knowledge-base.md) — MCP server · ★ 1 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
