{
  "name": "facilities-capacity-mcp",
  "title": "HealthMesh · Facilities & Capacity (CMS POS + HCRIS + Dartmouth HRR/HSA) MCP",
  "version": "0.1.1",
  "description": "US health facility capacity from CMS and Dartmouth public data (bundled): CMS Provider of Services (POS) file July 2026 (hospitals from QIES incl. terminated; active SNF, HHA, hospice, RHC, FQHC, ASC, ESRD, CMHC, ICF/IID and other providers from iQIES) searchable by category, hospital subtype, state, city, ZIP, county and beds; HCRIS hospital cost-report metrics FY2021-2024 (beds, days and discharges by payer, net patient revenue, operating and total margin, charity/uncompensated care, cost-to-charge ratio) per CCN with state/HRR rankings; and the Dartmouth Atlas ZIP to HSA/HRR crosswalk.",
  "healthmesh_domain": "Workforce & Facilities",
  "datasets": [
    "WF-04",
    "WF-05",
    "WF-08"
  ],
  "mcp_endpoint": "https://facilities-capacity.healthmesh.ai/mcp",
  "transport": "Streamable HTTP (stateless, JSON responses)",
  "authorization": "none",
  "auth_mode": "off",
  "docs": "https://github.com/HendrikK/healthmesh/tree/main/servers/facilities-capacity-mcp#readme",
  "contact": "hendrik.kleine@gmail.com",
  "data_source": {
    "name": "CMS Provider of Services File 2026-07 (QIES + iQIES), CMS Hospital Provider Cost Report (HCRIS) FY2021-2024, Dartmouth Atlas ZIP-HSA-HRR crosswalk 2019 (bundled)",
    "url": "https://data.cms.gov/provider-characteristics/hospitals-and-other-facilities/provider-of-services-file-hospital-non-hospital-facilities",
    "license": "CMS: U.S. Government work (public domain); Dartmouth Atlas: free public download with attribution",
    "refresh": "Bundled; weekly GitHub Actions check for new POS / HCRIS releases on data.cms.gov"
  },
  "tools": [
    {
      "name": "pos_search_facilities",
      "title": "Search CMS Provider of Services facilities",
      "description": "Searches the CMS Provider of Services (POS) file (July 2026 release, bundled) by provider category (HOSPITAL, SNF, HHA, HOSPICE, RHC, FQHC, ASC, ESRD, CMHC ...), hospital subtype (SHORT_TERM, CRITICAL_ACCESS, PSYCHIATRIC, REHABILITATION, LONG_TERM, CHILDRENS, RURAL_EMERGENCY ...), state, city, ZIP, county FIPS, name and minimum certified beds. Returns CCN, name, category/subtype, address, certified beds, original participation date, status and control type, with totals (beds summed over all matches). 'Critical access hospitals in Nebraska' = category HOSPITAL + subtype CRITICAL_ACCESS + state NE. Also accepts a list of CCNs."
    },
    {
      "name": "hcris_get_hospital_financials",
      "title": "Hospital cost-report financials (HCRIS)",
      "description": "Returns key Medicare cost-report (HCRIS, CMS-2552-10) metrics for a hospital CCN: beds, bed days, inpatient days and discharges by payer (Medicare Title XVIII, Medicaid Title XIX), FTEs, net patient revenue, operating expense, operating and total margin, other income, net income, charity and uncompensated care cost, bad debt, cost-to-charge ratio, DSH/IME, assets and liabilities. fiscal_year = CMS file year 2021-2024 = cost-reporting periods BEGINNING in that federal fiscal year (Oct 1 of the prior year to Sep 30); default 2024 (latest bundled; recent years fill in as reports are filed). all_years=true returns 2021-2024. Hospitals only (SNF/HHA/hospice cost reports are not bundled)."
    },
    {
      "name": "hcris_compare_hospitals",
      "title": "Rank/compare hospitals on a cost-report metric",
      "description": "Ranks hospitals on an HCRIS cost-report metric (operating_margin_pct, total_margin_pct, net_patient_revenue, net_income, beds, total_discharges, medicare_days_pct, medicaid_days_pct, uncompensated_care_cost, charity_care_cost, cost_to_charge_ratio, occupancy_pct, fte_employees) within a state, a Dartmouth HRR (via the hospital's POS ZIP), a facility type, or a CCN list. 'Hospitals with negative margins in Ohio' = metric operating_margin_pct, state OH, order asc, max_value 0. fiscal_year = CMS file year 2021-2024 = cost-reporting periods BEGINNING in that federal fiscal year (Oct 1 of the prior year to Sep 30); default 2024 (latest bundled; recent years fill in as reports are filed)."
    },
    {
      "name": "dartmouth_get_hrr_hsa",
      "title": "ZIP to Dartmouth HSA / HRR",
      "description": "Maps a ZIP code to its Dartmouth Atlas Hospital Service Area (HSA) and Hospital Referral Region (HRR) (2019 crosswalk), or lists the ZIPs in an HRR or HSA (with the HRR/HSA name). Optionally lists active POS hospitals in the HRR/HSA. 'HRR for ZIP 03755' = zip 03755."
    },
    {
      "name": "dartmouth_get_region_measures",
      "title": "Dartmouth Atlas regional measures (not loaded)",
      "description": "Planned: Dartmouth Atlas HRR/HSA measures (end-of-life care, hospital beds per 1,000, Medicare reimbursements). NOT LOADED in this version: always returns NOT_FOUND with the Dartmouth download page. For hospital capacity by HRR use hcris_compare_hospitals (hrr + metric beds) or dartmouth_get_hrr_hsa include_hospitals."
    },
    {
      "name": "facilities_describe_dataset",
      "title": "Describe facilities & capacity datasets",
      "description": "Lists bundled datasets (CMS POS July 2026 QIES + iQIES, HCRIS hospital cost reports, Dartmouth ZIP-HSA-HRR 2019), coverage counts, category and subtype codes, and known gaps."
    }
  ]
}