Download the v3.0 data dictionary and JSON template from the CMSgov/hospital-price-transparency GitHub repository and review the required field names for each charge type.
For any payer-specific negotiated charge expressed as a percentage or formula, calculate the median allowed amount, 10th percentile allowed amount, and 90th percentile allowed amount using EDI 835 ERA data from a lookback period of no less than 12 and no more than 15 months.
Encode the count of allowed amounts used to derive the median and percentile figures as a separate required field alongside those three amounts.
Add the attestation block to the MRF including the hospital's organizational (Type 2) NPI and the name of the CEO, president, or designated senior official who attests to accuracy and completeness.
Upload the completed JSON to the CMS free online MRF validation tool to check for schema conformance, missing required fields, and formatting errors before publishing.
Host the validated MRF at a publicly accessible URL and update the hospital's root-level TXT index file and dedicated price transparency webpage to link to the new file.
Known gotchas
The required field for the dollar amount derived from historical claims is the median allowed amount — the label 'median_contracted_rate' does not match the v3.0 schema and will fail CMS validation.
The lookback window must be at least 12 months but no longer than 15 months; using a calendar year that falls outside this window can cause the calculated figures to be non-compliant.
If the median calculation falls between two observed allowed amounts, CMS instructs hospitals to use the next highest observed value rather than interpolating.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp