MCP server

Medical Codes

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

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

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

Source

At a glance

Type

MCP server

Publisher

Not verified

Status

Working at last check

Tools

6

Token cost

About 4,109 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

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

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.medical-codes-mcp-server]
url = "https://medical-codes.caseyjhand.com/mcp"

Gemini CLI

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

Cursor

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

VS Code

{"servers":{"medical-codes-mcp-server":{"type":"http","url":"https://medical-codes.caseyjhand.com/mcp"}}}

Antigravity

agy mcp add medical-codes-mcp-server https://medical-codes.caseyjhand.com/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"medical-codes-mcp-server","server_url":"https://medical-codes.caseyjhand.com/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"medical-codes-mcp-server","server_url":"https://medical-codes.caseyjhand.com/mcp"}

Tools

• medcode_browse_hierarchy Browses the web · ~582 tokens
  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_check_code ~509 tokens
  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_get_code ~770 tokens
  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_list_systems ~224 tokens
  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
• medcode_map_codes ~1286 tokens
  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_search_codes ~738 tokens
  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

Browse

• GitHub tools
• GitHub and code hosting
• Maps and places
• Health and medicine

Related MCP servers

• Rxmanager
  Live US drug acquisition costs (CMS NADAC) for AI assistants. Free, no auth, weekly data.
• Medicare Pricing
  What does Medicare PAY — physician fee schedule, lab rates, and per-day unit limits.
• Medical Terminologies MCP
  Diagnoses, drugs & lab codes: ICD-11, LOINC, RxNorm, MeSH, ATC, CID-10. 33 tools, MIT.
• Medigami
  Medigami: medical bill error scan, denial decoding, appeal deadlines, hospital price lookup
• Umls
  UMLS MCP — wraps the NLM UMLS Terminology Services REST API (uts-ws.nlm.nih.gov/rest)
• Verzi Health
  Medicare DME coverage by HCPCS code and date of service, with CMS citations and signed receipts.
• Medigami Chatgpt
  Medigami patient tools: rates, markups, denial codes, deadlines, overturn rates, procedure codes
• Pinnacleblooms Ask
  Non-diagnostic child-development knowledge by Pinnacle Blooms: search, milestones, ICF crosswalk.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.cyanheads/medical-codes-mcp-server.svg)](https://aptlynx.net/servers/io.github.cyanheads/medical-codes-mcp-server)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents