get_hospital_quality

What it answers

1. 1Returns one hospital's CMS Care Compare quality record by CCN: the overall star rating (1-5) with hospital type / ownership; every Care Compare measure for the hospital (mortality and complication rates, unplanned readmission / ED-return rates, timely and effective care, healthcare-associated infections SIRs, outpatient imaging efficiency, maternal health) with the score, CMS's compared-to-national verdict where published, denominator, confidence bounds and measurement window; the HCAHPS patient-experience summary (summary star + per-dimension star ratings and linear mean scores) for the latest reporting year the hospital has; and the HRRP excess readmission ratios per condition for the latest fiscal year (ratio > 1 = more readmissions than nationally expected).
2. 2Inputs: ccn (required, 6-char CMS certification number); optional measure_group (alias: measure_source) to get ONE group's measure rows (complications_deaths | unplanned_visits | timely_care | healthcare_assoc_infections | outpatient_imaging_efficiency | maternal_health); optional limit and offset to page the measure rows (default limit 25 once detail is asked for).
3. 3THE DEFAULT CALL IS A SUMMARY: ccn alone returns the overall rating, the HCAHPS and HRRP blocks, and the measure GROUPS with a count each (summary.measure_groups: measure_count / available / not_available / vs_national per group) — NOT the ~108 measure rows, which exceed the response budget for a single hospital.
4. 4Totals are still reported (summary.measure_count) and row_counts.measures names what was withheld; ask again with measure_group, or limit / offset, for the rows.
5. 5RETURNS a detail payload: value.summary (facility, overall_rating with status + footnote, hcahps_summary_star, counts, measure_groups, measure_detail_mode, and a `blocks` map saying which of overall_rating / measures / hcahps / hrrp are available for THIS hospital); value.measures, value.hcahps, value.hrrp row lists.
6. 6Every row carries status = available | not_available (with the CMS footnote or reason), source_table and source_vintage (asserted_at).
7. 7Nothing is fabricated: a suppressed or unreported measure is not_available, never a zero; an unrated hospital reports overall_rating null with the CMS footnote.
8. 8All four sources are read WHERE is_current = true.
9. 9An unknown CCN returns found=false.
10. 10SOURCE: CMS Provider Data Catalog (Care Compare) Hospital General Information, hospital measure files, HCAHPS, and the HRRP hospital file.

Inputs (5)

Call it

# MCP (https://mcp.vladahealth.com/mcp): the tool by name
get_hospital_quality(ccn="070005", limit=5)

curl -X POST https://api.vladahealth.com/v1/tools/get_hospital_quality \
  -H "Authorization: Bearer $VLADA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ccn":"070005","limit":5}'

# the schema, no key
curl https://api.vladahealth.com/v1/tools/get_hospital_quality/schema

A real answer

{
 "value": {
  "found": true,
  "not_found_reason": null,
  "summary": {
   "ccn": "070005",
   "facility_name": "WATERBURY HOSPITAL",
   "city": "WATERBURY",
   "state": "CT",
   "hospital_type": "Acute Care Hospitals",
   "hospital_ownership": "Proprietary",
   "emergency_services": true,
   "overall_rating": 2,
   "overall_rating_status": "available",
   "overall_rating_not_available_reason": null,
   "overall_rating_footnote": null,
   "overall_rating_vintage": "2026-09-22",
   "measure_count": 106,
   "measures_available": 79,
   "measures_not_available": 27,
   "measures_by_source": {
    "complications_deaths": {
     "available": 18,
     "not_available": 2
    },
    "healthcare_assoc_infections": {
     "available": 33,
     "not_available": 3
    },
    "maternal_health": {
     "available": 0,
     "not_available": 4
    },
    "outpatient_imaging_efficiency": {
     "available": 1,
     "not_available": 1
    },
    "timely_care": {
     "available": 16,
     "not_available": 14
    },
    "unplanned_visits": {
     "available": 11,
     "not_available": 3
    }
   },
   "measure_groups": [
    {
     "measure_group": "complications_deaths",
     "measure_count": 20,
     "available": 18,
     "not_available": 2,
     "vs_national": {
      "No Different Than the National Rate": 11,
      "No Different Than the National Value": 1
     }
    },
    {
     "measure_group": "healthcare_assoc_infections",
     "measure_count": 36,
     "available": 33,
     "not_available": 3,
     "vs_national": {
      "No Different than National Benchmark": 24,
      "Better than the National Benchmark": 6
     }
    },
    {
     "measure_group": "maternal_health",
     "measure_count": 4,
     "available": 0,
     "not_available": 4
    },
    {
     "measure_group": "outpatient_imaging_efficiency",
     "measure_count": 2,
     "available": 1,
     "not_available": 1
    },
    {
     "measure_group": "timely_care",
     "measure_count": 30,
     "available": 16,
     "not_available": 14
    },
    {
     "measure_group": "unplanned_visits",
     "measure_count": 14,
     "available": 11,
     "not_available": 3,
     "vs_national": {
      "No Different Than the National Rate": 1,
      "Number of Cases Too Small": 2,
      "No Different than expected": 1
     }
    }
   ],
   "measure_group_count": 6,
   "measure_detail_mode": "rows",
   "measure_detail_hint": "measures: 106 rows returned 5 from offset 0 (limit 5); next_offset=5.",
   "measures_vs_national": {
    "No Different Than the National Rate": 12,
    "No Different Than the National Value": 1,
    "No Different than National Benchmark": 24,
    "Better than the National Benchmark": 6,
    "Number of Cases Too Small": 2,
    "No Different than expected": 1
   },
   "hcahps_reporting_year": 2025,
   "hcahps_summary_star": 3.0,
   "hcahps_row_count": 17,
   "hrrp_fiscal_year": 2026,
   "hrrp_measure_count": 6,
   "hrrp_available": 5,
   "blocks": {
    "overall_rating": "available",
    "measures": "available",
    "hcahps": "available",
    "hrrp": "available"
   },
   "unit": "quality_rows"
  },
  "measures": [
   {
    "measure_source": "complications_deaths",
    "measure_id": "COMP_HIP_KNEE",
    "measure_name": "Rate of complications for hip/knee replacement patients",
    "condition": null,
    "value": null,
    "score_raw": null,
    "compared_to_national": null,
    "denominator": null,
    "sample": null,
    "lower_estimate": null,
    "higher_estimate": null,
    "footnote": "1",
    "period_start": "04/01/2023",
    "period_end": "03/31/2025",
    "status": "not_available",
    "not_available_reason": "cms_footnote:1",
    "source_vintage": "2026-09-30"
   },
   {
    "measure_source": "complications_deaths",
    "measure_id": "Hybrid_HWM",
    "measure_name": "Hybrid Hospital-Wide All-Cause Risk Standardized Mortality Rate",
    "condition": null,
    "value": 3.6,
    "score_raw": "3.6",
    "compared_to_national": null,
    "denominator": "2023",
    "sample": null,
    "lower_estimate": null,
    "higher_estimate": null,
    "footnote": null,
    "period_start": "07/01/2024",
    "period_end": "06/30/2025",
    "status": "available",
    "not_available_reason": null,
    "source_vintage": "2026-09-30"
   },
   {
    "measure_source": "complications_deaths",
    "measure_id": "MORT_30_AMI",
    "measure_name": "Death rate for heart attack patients",
    "condition": null,
    "value": 11.7,
    "score_raw": "11.7",
    "compared_to_national": null,
    "denominator": "90",
    "sample": null,
    "lower_estimate": null,
    "higher_estimate": null,
    "footnote": null,
    "period_start": "07/01/2022",
    "period_end": "06/30/2025",
    "status": "available",
    "not_available_reason": null,
    "source_vintage": "2026-09-30"
   },
   {
    "measure_source": "complications_deaths",
    "measure_id": "MORT_30_CABG",
    "measure_name": "Death rate for CABG surgery patients",
    "condition": null,
    "value": null,
    "score_raw": null,
    "compared_to_national": null,
    "denominator": null,
    "sample": null,
    "lower_estimate": null,
    "higher_estimate": null,
    "footnote": "1",
    "period_start": "07/01/2022",
    "period_end": "06/30/2025",
    "status": "not_available",
    "not_available_reason": "cms_footnote:1",
    "source_vintage": "2026-09-30"
   },
   {
    "measure_source": "complications_deaths",
    "measure_id": "MORT_30_COPD",
    "measure_name": "Death rate for COPD patients",
    "condition": null,
    "value": 12.1,
    "score_raw": "12.1",
    "compared_to_national": null,
    "denominator": "97",
    "sample": null,
    "lower_estimate": null,
    "higher_estimate": null,
    "footnote": null,
    "period_start": "07/01/2022",
    "period_end": "06/30/2025",
    "status": "available",
    "not_available_reason": null,
    "source_vintage": "2026-09-30"
   }
  ],
  "hcahps": [
   {
    "reporting_year": 2025,
    "measure_id": "H_CLEAN_LINEAR_SCORE",
    "question": "Cleanliness
…

What comes back

Sources

Known limits (4)

1. 1overall_rating is null for hospitals CMS does not rate (~40% of CCNs) — unrated, not 0.
2. 2score_numeric is null for suppressed / categorical / footnoted measures; the row is returned as not_available with the footnote.
3. 3HCAHPS answer-percent distribution rows are not returned (star + linear mean summary only); HRRP is the latest fiscal year only.
4. 4Measure semantics differ per measure_id; do not compare scores across unlike measures.