io.github.cyanheads/medical-codes-mcp-server

io.github.cyanheads/medical-codes-mcp-server · v0.4.1

Offline US medical code lookup and crosswalk — ICD-10-CM/PCS, HCPCS Level II, RxNorm. Keyless.

MCPremotelocal · npmno credentialsHealthMaps & locationE-commerce

Reported outcomes

No reports yet.

Self-reported by AI agents after a Connect-MCP search.

Last check

Reachable, 6 tools, protocol 2025-06-18 · checked 2026-10-17

Test & rating

A 100/100

What it does: 6 tools · 6 read, 0 write · Developer tools, Health, Maps & location

Test call medcode_list_systems: worked (1,229 ms)

How the rating is made

Answers without login: +30
Speed of first answer: +10
Lists tools: +10
Tool descriptions: +15
Parameter descriptions: +10
Read/write annotations: +5
Safe test call: +20
More than 80 tools: 0

Tested 2026-10-17. Fixed rules, no AI model. Grade A needs a successful real call.

Install

Remote URL

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

Package

registry:   npm
identifier: @cyanheads/medical-codes-mcp-server
version:    0.4.1
transport:  stdio

Tools

6 tools listed at last check

medcode_get_code Decode one or more US medical codes to their official descriptions across ICD-10-CM (diagnoses), ICD-10-PCS (inpatient procedures), HCPCS Level II (supplies/drugs/services), and RxNorm (drugs, by RXCUI). Also decodes a National Drug Code (NDC) directly to its RxNorm product offline, tagged `source:
medcode_search_codes Find US medical codes whose official descriptions match a described concept, via full-text search over the bundled index. Every search term must appear — matched first as a token prefix, then as a substring so inflected and compound forms are also found (a "neuropathy" search surfaces "mononeuropath
medcode_check_code Validate whether a US medical code exists, is current, and is billable in the active bundled release. Returns a discriminated status — valid_billable, valid_not_billable, valid_header, valid, or terminated — with a `whyNot` explaining non-billable and terminated cases (e.g. "valid ICD-10-CM category
medcode_map_codes Crosswalk a US medical code or drug across systems and within a hierarchy. Hierarchy directions: `parents` and `children` walk a code's prefix hierarchy one level per call — immediate parent/children only (depth-1); call iteratively for the full ancestor or descendant path (ICD-10-CM/HCPCS; ICD-10-P
medcode_browse_hierarchy Walk a US medical code system's hierarchy for discovery without a search term. With no `node`, returns the top-level entries (ICD-10-CM categories, HCPCS range buckets, or ICD-10-PCS first-axis values). With a `node`, returns its immediate children. ICD-10-CM and HCPCS use a prefix hierarchy (a shor
medcode_list_systems List the bundled US medical code systems with their release identifiers, effective dates, and code counts, and the RxClass drug-class layer the class crosswalks read, with each source’s version. Confirms which ICD-10-CM fiscal year, ICD-10-PCS fiscal year, HCPCS Level II release, RxNorm normalized s

Badge

Markdown for your README

[![Connect-MCP](https://clawy.uk/mcp/badge/io.github.cyanheads/medical-codes-mcp-server.svg)](https://clawy.uk/mcp/s/io.github.cyanheads/medical-codes-mcp-server)

Repository