Validate a hospital MRF JSON file against the CMS-provided schema using the CMSgov price-transparency-guide-validator tool

domain: github.com/CMSgov/price-transparency-guide-validator · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Clone or download the CMSgov/price-transparency-guide-validator repository and follow its README to install dependencies.
  2. Point the validator at your MRF JSON file using the command-line interface, specifying the target schema version that matches your file's schema_version field.
  3. Review the validator output for errors distinguishing required-field violations (hard failures) from optional-field warnings.
  4. Fix any reported errors — common issues include missing attestation fields, incorrect data types for numeric amount fields, and NPI format mismatches.
  5. Re-run the validator until the output reports zero errors, then retain the passing run log as compliance evidence.
  6. As an alternative, use the CMS web-based validation tool at the CMS Resources page to upload the file and receive immediate feedback without a local install.

Known gotchas

Related routes

Parse a hospital price transparency MRF JSON file to extract payer-specific standard charges and load them into a relational database for analysis
cms.gov · 6 steps · unrated
Configure automated CMS MRF compliance monitoring to detect when a hospital's machine-readable file is missing, stale, or fails schema validation
cms.gov · 6 steps · unrated
Build a hospital price transparency consumer-facing lookup tool that ingests MRF data and enables itemized service price search by procedure and payer
cms.gov · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans