What is healthcare.dev?

A developer API for US healthcare reference data: ICD-10-CM and ICD-10-PCS codes, HCPCS Level II, the FDA NDC Directory, RxNorm and, soon, NPI providers. It is available as REST, an MCP server for AI agents, a TypeScript SDK and a CLI.

Is there a free plan?

Yes. The Free plan includes 5,000 calls a month with no card. Pay as you go removes the cap and bills per call.

Does healthcare.dev handle patient data?

No. The API serves public reference data and must never receive patient information. That keeps it outside HIPAA business associate scope.

Can AI agents use it?

Yes. The remote MCP server at mcp.healthcare.dev works with Claude, Cursor, VS Code and Codex, and the docs publish llms.txt and Markdown versions of every page.

Is this medical advice?

No. healthcare.dev is reference data, not medical, coding or billing advice.

NewRemote MCP server →Remote MCP server for Claude, Cursor and Codex →

US healthcare reference data, for humans and agents.

ICD-10 HCPCS NDC RxNorm and NPI in one consistent, versioned, cited API. Free to start, no sales call.

Get a free key Quickstart

5,000 free calls a month · no card · first call in under two minutes

agent · healthcare-dev MCP connected

Is E11.22 billable? And what is NDC 0093-1048-01 in RxNorm?

toollookup_code{ "system": "icd10cm", "code": "E11.22" }

→ billable · active · cms-icd10 2026.1

toolmap_ndc_to_rxnorm{ "ndc": "0093-1048-01" }

→ RxCUI 861007 · metformin hydrochloride 500 MG Oral Tablet

Yes. E11.22 (type 2 diabetes with diabetic CKD) is billable and active in ICD-10-CM 2026.1. The NDC maps to RxCUI 861007, metformin 500 mg tablet.[cms-icd10, fda-ndc]

zsh

$ curl api.healthcare.dev/v1/codes/icd10cm/E11.22 \
    -H "Authorization: Bearer $HDEV_API_KEY"
{
  "data": {
    "code": "E11.22",
    "display": "Type 2 diabetes mellitus with diabetic chronic kidney disease",
    "billable": true,
    "status": "active"
  },
  "meta": { "source": "cms-icd10", "data_version": "2026.1" }
}

The API

One request, every answer cited.

Every response is the same envelope: the record in data, and its source, release and license in meta. Errors are RFC 9457 problem details your code and your agents can branch on.

curl https://api.healthcare.dev/v1/codes/icd10cm/E11.9 \
  -H "Authorization: Bearer $HDEV_API_KEY"

200 OK · application/json

{
  "data": {
    "system": "icd10cm",
    "code": "E11.9",
    "display": "Type 2 diabetes mellitus without complications",
    "billable": true,
    "parent": "E11",
    "status": "active",
    "effective_start": "2015-10-01",
    "effective_end": null
  },
  "meta": {
    "source": "cms-icd10",
    "data_version": "2026.1",
    "retrieved_at": "2026-10-24T12:00:00Z",
    "license": "Public domain (CMS)"
  }
}

The data

Six public datasets, kept current

Loaded from the source on every release, normalized into one schema and served with live version numbers.

ICD-10vfy2027, vfy2027

ICD-10-CM and ICD-10-PCS

CMS and CDC NCHS · Yearly (October 1), plus April updates

GET /v1/codes/icd10cm/E11.9

HCPCSv2026-10

HCPCS Level II

CMS · Quarterly

GET /v1/codes/hcpcs?q=wheelchair&limit=1

NDCv2026-10-23

FDA NDC Directory

FDA · Daily

GET /v1/drugs/ndc/0093-1048-01

RxNormv2026-10-05

RxNorm

U.S. National Library of Medicine · Monthly

GET /v1/drugs/rxnorm/861007

NPIcoming soon

NPI registry (NPPES)

CMS NPPES · Weekly

GET /v1/providers/1234567893/validate

NextFDA labels, recalls and shortages, LOINC, fee schedules, then hospital and payer price data.Data licenses →

For agents

Built for the agents that will call it.

Nine read-only MCP tools that map to what agents actually do. Compact, capped results with sources, so answers come with citations. Docs agents can read: llms.txt, a Markdown copy of every page, and a SKILL.md.

lookup_code
search_codes
explain_code_hierarchy
lookup_drug
search_drugs
map_ndc_to_rxnorm
validate_npi
list_datasets
get_dataset_changes

Set up MCP llms.txt

Claude Code

claude mcp add --transport http healthcare-dev \
  https://mcp.healthcare.dev/mcp \
  --header "Authorization: Bearer $HDEV_API_KEY"

~/.cursor/mcp.json

{
  "mcpServers": {
    "healthcare-dev": {
      "url": "https://mcp.healthcare.dev/mcp",
      "headers": { "Authorization": "Bearer hdev_live_..." }
    }
  }
}

How it stays current

A pipeline, not a spreadsheet.

01
Detect
Watch CMS, FDA and NLM for new releases
02
Validate
Schema, row counts and golden records must pass
03
Version
Publish an immutable release; keep history
04
Serve
REST, MCP, SDK and CLI, cited every time

One schema

Codes, drugs and providers from CMS, FDA and NLM come back in the same envelope, with the same lifecycle fields and the same errors.

Versioned

Every upstream release is loaded, tested and published as an immutable version. Ask for a code as it was on any date.

Cited

Every response names its source, release and license, so an agent can show its work and a person can check it.

No PHI

Public reference data only. We never accept patient information, so there's no BAA to sign and no HIPAA scope to inherit.

Free tools

Try it without a key

› 1234567893

Frequently asked

What is healthcare.dev?: A developer API for US healthcare reference data: ICD-10-CM and ICD-10-PCS codes, HCPCS Level II, the FDA NDC Directory, RxNorm and, soon, NPI providers. It is available as REST, an MCP server for AI agents, a TypeScript SDK and a CLI.
Is there a free plan?: Yes. The Free plan includes 5,000 calls a month with no card. Pay as you go removes the cap and bills per call.
Does healthcare.dev handle patient data?: No. The API serves public reference data and must never receive patient information. That keeps it outside HIPAA business associate scope.
Can AI agents use it?: Yes. The remote MCP server at mcp.healthcare.dev works with Claude, Cursor, VS Code and Codex, and the docs publish llms.txt and Markdown versions of every page.
Is this medical advice?: No. healthcare.dev is reference data, not medical, coding or billing advice.

Your first call, in two minutes.

curl https://api.healthcare.dev/v1/codes/icd10cm/E11.9 -H "Authorization: Bearer $HDEV_API_KEY"

Get a free key Pricing