{
  "name": "hcai-hospital-financials",
  "title": "HealthMesh · California HCAI Hospital Financials",
  "version": "0.2.0",
  "description": "California HCAI hospital annual financial disclosures and quarterly financial/utilization reports: hospital profiles, financial trends, comparisons, rankings, aggregates and permitted report detail, with reporting periods and source provenance.",
  "healthmesh_domain": "Workforce & Facilities",
  "datasets": [
    "WF-09",
    "WF-10"
  ],
  "mcp_endpoint": "https://hcai-hospital-financials.healthmesh.ai/mcp",
  "transport": "Streamable HTTP (stateless, JSON responses)",
  "authorization": "HealthMesh account required (Authorization: Bearer <API token hm_live_… or OAuth access token>); see oauth_protected_resource",
  "auth_mode": "gateway",
  "oauth_protected_resource": "https://hcai-hospital-financials.healthmesh.ai/.well-known/oauth-protected-resource",
  "docs": "https://github.com/HendrikK/healthmesh/tree/main/servers/hcai-hospital-financials-mcp#readme",
  "contact": "hendrik.kleine@gmail.com",
  "data_source": {
    "name": "California Department of Health Care Access and Information (HCAI)",
    "url": "https://hcai.ca.gov/data/cost-transparency/hospital-financials/",
    "license": "Creative Commons Attribution (data.ca.gov catalog license 'cc-by'; version not stated) and CalHHS Open Data Portal Terms of Use",
    "refresh": "Annual and quarterly source files; weekly Actions refresh after commissioning"
  },
  "tools": [
    {
      "name": "hcai_search_hospitals",
      "title": "search hospitals",
      "description": "Find hospitals by name, HCAI identifier, county or ownership in the published California HCAI snapshot. Historical names are preserved by reporting period."
    },
    {
      "name": "hcai_list_reports",
      "title": "list reports",
      "description": "List available annual or quarterly reports, explicit reporting dates and collection cohorts. Annual cohorts are not calendar-year totals. Separate partial periods remain separate reports."
    },
    {
      "name": "hcai_get_financials",
      "title": "get financials",
      "description": "Get approved principal financial measures for an exact report_id from hcai_list_reports, with units, scope and period. Null does not mean zero; regional values are not allocated to hospitals."
    },
    {
      "name": "hcai_get_financial_trend",
      "title": "get financial trend",
      "description": "Get a hospital's annual or quarterly trend for approved metrics, preserving actual reporting dates. Metric-definition changes are rejected rather than silently combined."
    },
    {
      "name": "hcai_query_financials",
      "title": "query financials",
      "description": "Compare, rank or aggregate hospitals for one annual collection cohort or calendar quarter. Defaults to facility scope and complete periods; ratios use sums of matched numerator/denominator pairs. No partial totals or overlapping reports are returned."
    },
    {
      "name": "hcai_get_report_detail",
      "title": "get report detail",
      "description": "Retrieve permitted detailed fields for an exact report, using source field identifiers and approved labels only. Licensed and unreviewed descriptive text is excluded; numeric values retain their reporting scope."
    },
    {
      "name": "hcai_describe_dataset",
      "title": "HCAI coverage and metric definitions",
      "description": "Describe loaded HCAI coverage, metric definitions, attribution and commissioning status. Reports honestly when no production snapshot has been loaded."
    }
  ]
}