Mcp Healthcare — Icd 10, Npi, Ndc, Dea Tools

by easysolutions906

400 downloads
Not rated
GitHub

About

Healthcare data tools for AI agents. Search 74,000+ ICD-10 diagnosis codes, look up providers in the NPI registry, search 111,000+ drugs in the FDA NDC directory, and validate DEA registration numbers.

Details

Author
easysolutions906
Downloads
400
Categories
Other

- 10 tools across four healthcare data categories
- ICD-10-CM lookup, search, and validation (74,260 2025 codes)
- NPI provider search and lookup via live NPPES API
- NDC drug lookup, search by name, and ingredient search
- DEA number validation and test number generation

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Mcp Healthcare — Icd 10, Npi, Ndc, Dea Tools
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Requires Node.js 18+. Install via npm install and run npm run link-data to symlink ICD-10 and NDC data files. Configure in claude_desktop_config.json or .cursor/mcp.json with the command node and the path to src/index.js.

icd10_lookup

Look up an ICD-10-CM diagnosis code. Returns the code description, formatted code, and chapter information. Example: "E11.9" returns "Type 2 diabetes mellitus without complications".

icd10_search

Search 74,260 ICD-10-CM codes by keyword. Returns matching codes sorted by relevance. Useful for finding diagnosis codes when you know the condition name but not the code.

icd10_validate

Validate whether an ICD-10-CM code exists in the 2025 code set. Returns validity status, description if found, and chapter info.

npi_search

Search the NPPES NPI Registry for healthcare providers by name, specialty, or location. Queries the live CMS registry in real-time.

npi_lookup

Look up a specific healthcare provider by their 10-digit NPI number. Returns full provider details including name, addresses, taxonomies, and identifiers from the live NPPES registry.

ndc_lookup

Look up a drug product by its National Drug Code (NDC). Searches 111,655 products from the FDA NDC directory. Returns drug name, ingredients, manufacturer, dosage form, and more.

ndc_search

Search 111,655 FDA drug products by name, generic name, or manufacturer. Returns matching products sorted by relevance.

ndc_search_ingredient

Search FDA drug products by active ingredient name. Useful for finding all formulations containing a specific drug compound.

dea_validate

Validate a DEA (Drug Enforcement Administration) registration number using the official Luhn-variant checksum algorithm. Identifies registrant type and detects formatting errors.

dea_generate_test

Generate a valid test DEA number for development and testing. The generated number passes checksum validation but is NOT a real DEA registration.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp healthcare \u2014 icd 10, npi, ndc, dea tools": {
            "healthcare": {
                "command": "npx",
                "args": [
                    "-y",
                    "@easysolutions906/mcp-healthcare"
                ]
            }
        }
    }
}

McpServers

{
    "healthcare": {
        "command": "npx",
        "args": [
            "-y",
            "@easysolutions906/mcp-healthcare"
        ]
    }
}

MCP Healthcare Server

A Model Context Protocol (MCP) server that bundles healthcare data tools for use with Claude Desktop, Cursor, and other MCP clients.

Tools (10 total)

ICD-10-CM Diagnosis Codes (74,260 codes from CMS 2025)

| Tool | Description | |------|-------------| | icd10_lookup | Look up an ICD-10-CM code by code string (e.g., E11.9) | | icd10_search | Search codes by keyword (e.g., "diabetes", "chest pain") | | icd10_validate | Check if a code exists in the 2025 code set |

NPI Provider Registry (live NPPES queries)

| Tool | Description | |------|-------------| | npi_search | Search providers by name, specialty, city, state, ZIP | | npi_lookup | Look up a provider by 10-digit NPI number |

NDC Drug Directory (111,655 FDA products)

| Tool | Description | |------|-------------| | ndc_lookup | Look up a drug by NDC code (e.g., 0002-1433-80) | | ndc_search | Search drugs by name, generic name, or manufacturer | | ndc_search_ingredient | Search drugs by active ingredient |

DEA Number Validation (algorithm-based)

| Tool | Description | |------|-------------| | dea_validate | Validate a DEA number using the official checksum algorithm | | dea_generate_test | Generate a valid test DEA number for development |

Setup

Prerequisites

- Node.js 18+ - The ICD-10 and NDC data files from sibling API directories

Install

``bash cd mcp-healthcare npm install npm run link-data # creates symlinks to ICD-10 and NDC data files `

Claude Desktop Configuration

Add to your
claude_desktop_config.json: `json { "mcpServers": { "healthcare": { "command": "node", "args": ["/absolute/path/to/mcp-healthcare/src/index.js"] } } } `

Cursor Configuration

Add to
.cursor/mcp.json in your project: `json { "mcpServers": { "healthcare": { "command": "node", "args": ["/absolute/path/to/mcp-healthcare/src/index.js"] } } } `

Data Sources

| Dataset | Source | Update Frequency | |---------|--------|-----------------| | ICD-10-CM | CMS (Centers for Medicare & Medicaid) | Annually (October) | | NDC | FDA National Drug Code Directory | Weekly | | NPI | NPPES Registry (live API) | Real-time | | DEA | Checksum algorithm (no dataset) | N/A |

Transport

This server uses stdio transport (stdin/stdout), which is the standard for local MCP integrations with Claude Desktop and Cursor. No HTTP server is started.

Architecture

The server imports pure business logic extracted from four Express-based REST APIs: -
src/tools/icd10.js — ICD-10 code lookup, search, validation (loads 6MB JSON dataset) - src/tools/ndc.js — NDC drug lookup and search (loads 53MB JSON dataset) - src/tools/npi.js — NPI provider search via live NPPES API - src/tools/dea.js` — DEA number validation (pure algorithm, no dataset) Data files are symlinked from sibling API directories to avoid duplication.
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.