US Core Profile Gap Check (USCDI v3)

Finds the FHIR R4 resources still pinned to US Core 3.1.1 or 5.0.1, and the USCDI v3 Patient elements they never carried.

Install

npx @readystack/uscore-profile-gap-lint file

Node 18+. The same 10 rules as the VS Code extension, from a terminal or CI.

Free

• Scan every FHIR JSON resource in the workspace and see each US Core profile gap on its own line, with the USCDI version that pin actually meets.
• --rules lists every rule

With a licence ($29 once)

• Export the whole workspace as one conformance report file: every resource, its profile pin, and the USCDI v3 element it misses.

@readystack/uscore-profile-gap-lint --dir ./templates --report html --out report.html

A US FHIR consultant averages $49.72/hour (ZipRecruiter, 31 July 2026); reading a resource set by hand takes hours.

Use from an AI agent (MCP)

Claude Code · Cursor · Windsurf · any MCP client - add to your MCP config:

{ "mcpServers": { "uscore-profile-gap-lint": { "command": "npx", "args": ["-y", "@readystack/uscore-profile-gap-lint", "--mcp"] } } }

Tools: check_text and check_file (free) · check_dir (licence). The agent gets every finding with the line number.

Use in CI

- name: US Core Profile Gap Check (USCDI v3)
  run: npx -y @readystack/uscore-profile-gap-lint --dir . --ci

(container: docker run --rm -v "$PWD:/work" getreadystack/uscore-profile-gap-lint --dir /work --ci)

The folder sweep, reports and CI mode need one licence — one payment, no subscription. Set READYSTACK_LICENSE=<key> or run --license <key> once.

Get a licence