Medical Codes MCP Server - install & status [2026]

01 · Install Medical Codes MCP Server

before you install - you'll need

Set MCP_TRANSPORT_TYPE, MCP_LOG_LEVEL before connecting.

Claude Code

claude mcp add cyanheads-medical-codes-mcp-server --transport http https://medical-codes.caseyjhand.com/mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "cyanheads-medical-codes-mcp-server": {
      "url": "https://medical-codes.caseyjhand.com/mcp"
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

https://medical-codes.caseyjhand.com/mcp

transport: streamable-http

endpoint alive - responded to MCP initialize · probed 2026-08-25

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions · remote - your agent's requests go to medical-codes.caseyjhand.com

endpoint auth accepted our unauthenticated MCP initialize - no credentials needed to connect

license Apache-2.0 - declared in the repository

npm package @cyanheads/medical-codes-mcp-server - published under the repo owner's npm scope (@cyanheads)

registry namespace io.github.cyanheads is GitHub-verified and matches the repo owner

03 · What Medical Codes MCP Server can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can validate a code's existence, currency, and billability, with a whyNot for non-billable/terminated cases, and list bundled systems with release identifiers, effective dates, and code counts (provenance).

The 6 tools it gives your agent

Extracted from the project's README - what medical-codes-mcp-server lets an agent do.

medcode_get_code: - Decode 1–50 codes to their official descriptions. Auto-detects the system per code; partial-success found / notFound.
medcode_search_codes: - Full-text search over official descriptions - go from a clinical description to the code.
medcode_check_code: - Validate a code's existence, currency, and billability, with a whyNot for non-billable/terminated cases.
medcode_map_codes: - Crosswalk a code within its hierarchy (parents/children) or a drug across RxNorm (name ↔ RXCUI, NDC ↔ RXCUI, RXCUI → ingredients/brands).
medcode_browse_hierarchy: - Walk a system's hierarchy for discovery without a search term.
medcode_list_systems: - List bundled systems with release identifiers, effective dates, and code counts (provenance).

Latest releases

v0.2.7 · 2026-08-09

cross-system disclosure on collided ICD-10-CM/PCS codes · Adds alsoInSystems to medcode_get_code, medcode_check_code, and · medcode_map_codes (hierarchy directions) - names the other bundled system · when a resolved…

v0.2.6 · 2026-08-09

RxNorm concept types, unmapped-source and header-row fixes · medcode_map_codes tags rxcui_to_ingredients/rxcui_to_brands hits with conceptType (IN/PIN/MIN/BN), separating a combination product's substances from its…

v0.2.5 · 2026-08-09

Hierarchy rendering and PCS/FTS input hardening · medcode_get_code text render gates empty children and a complete childrenTruncated:false on presence instead of truthiness, so a genuinely empty-and-complete hierarchy…

04 · Who maintains Medical Codes MCP Server

medical-codes-mcp-server is maintained by cyanheads. We track 125 MCP servers from cyanheads - 124 actively maintained, 1,730 combined GitHub stars, oldest repo from Dec 2024. Full record: all servers from cyanheads.

05 · Facts

repository: github.com/cyanheads/medical-codes-mcp-server
category: science & health - ranked #36 of 60 actively-maintained science & health servers as of 2026-08-25.
release cadence: 10+ releases in the last 90 days (latest 2026-08-09)
registry: io.github.cyanheads/medical-codes-mcp-server (active, first published 2026-06-13 · 14 versions)
packages: npm:@cyanheads/medical-codes-mcp-server · npm:@cyanheads/medical-codes-mcp-server

06 · Medical Codes MCP Server FAQ

Is Medical Codes MCP Server still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-09 and it shipped 10+ releases in the last 90 days. We re-verify nightly.

What can Medical Codes MCP Server do?

With this server connected, an agent can validate a code's existence, currency, and billability, with a whyNot for non-billable/terminated cases, and list bundled systems with release identifiers, effective dates, and code counts (provenance).

How do I install Medical Codes MCP Server?

Run `npx -y @cyanheads/medical-codes-mcp-server`. The README documents 2 environment variables (MCP_TRANSPORT_TYPE, MCP_LOG_LEVEL) to set first. Set MCP_TRANSPORT_TYPE, MCP_LOG_LEVEL before connecting. You can also paste the ready-made client config above.

Does Medical Codes MCP Server require authentication?

No - the endpoint accepted our unauthenticated MCP initialize when probed on 2026-08-25; you can connect without credentials.

07 · Alternatives to Medical Codes MCP Server

Alternatives to Medical Codes MCP Server

Maintained science & health servers if Medical Codes MCP Server isn't the fit.

More science & health MCP servers · Oecd MCP Server · Pubchem MCP Server · Who Gho MCP Server · Cytoscape Desktop MCP

More TypeScript MCP servers · Met Museum MCP Server · Noaa Cdo MCP Server · Nonprofit Explorer MCP Server · Ntfy MCP Server · Obsidian MCP Server · see all