{
  "name": "health-workforce-mcp",
  "title": "HealthMesh · Health Workforce (AHRF + NCHWA Projections) MCP",
  "version": "0.1.1",
  "description": "US health workforce supply: HRSA Area Health Resources File (AHRF 2024-2025) county and state indicators (physicians by specialty, NPs/PAs/dentists/nurses with NPI, hospitals, beds, facility staffing, utilization), with per-100k rates from Census population estimates, plus HRSA NCHWA workforce projections 2023-2038 (supply, demand and adequacy for 121 professions, national/state/metro-nonmetro).",
  "healthmesh_domain": "Workforce & Facilities",
  "datasets": [
    "WF-01",
    "WF-03"
  ],
  "mcp_endpoint": "https://health-workforce.healthmesh.ai/mcp",
  "transport": "Streamable HTTP (stateless, JSON responses)",
  "authorization": "none",
  "auth_mode": "off",
  "docs": "https://github.com/HendrikK/healthmesh/tree/main/servers/health-workforce-mcp#readme",
  "contact": "hendrik.kleine@gmail.com",
  "data_source": {
    "name": "HRSA Area Health Resources File 2024-2025 (county + state/national CSV) + HRSA NCHWA Workforce Projections full data (bundled)",
    "url": "https://data.hrsa.gov/data/download?data=AHRF",
    "license": "U.S. Government work (public)",
    "refresh": "Bundled; weekly GitHub Actions check for a new AHRF release or projections file"
  },
  "tools": [
    {
      "name": "ahrf_search_variables",
      "title": "Search AHRF variables",
      "description": "Searches the HRSA Area Health Resources File (AHRF 2024-2025) variable catalog by keyword (e.g. 'nurse practitioners', 'psychiatry', 'hospital beds', 'dentists'). Returns field codes, labels, data year, source and whether values are bundled for ahrf_get_indicators. All terms must match (field code, label, characteristics or source). County level = 4,289 variables (latest year of each health-professions/facilities/utilization/expenditure/environment series bundled); state level = 1,412 state/national workforce variables (all bundled)."
    },
    {
      "name": "ahrf_get_indicators",
      "title": "Get AHRF indicator values",
      "description": "Returns AHRF values for up to 10 variables for counties (by FIPS list or all counties in a state) or for states / the US (state/national file), optionally with per-100k rates using Census county population estimates (popn_est for the variable's year; state and US populations = sum of county estimates). Variables accept a full field code (np_npi_24) or a series code (np_npi). Use ahrf_search_variables first to find codes."
    },
    {
      "name": "workforce_get_projection",
      "title": "Get NCHWA workforce projection",
      "description": "Returns HRSA NCHWA projected supply, demand (FTE), shortage (demand - supply) and adequacy (% of demand met by supply) for a profession and geography: a single year or the full 2023-2038 series. Geography = US (default) or a state; metro/nonmetro splits exist for the US total only. Baseline scenario (status-quo supply, current-use demand)."
    },
    {
      "name": "workforce_rank_shortages",
      "title": "Rank projected workforce shortages",
      "description": "Ranks states (for one profession) or professions (for one geography) by NCHWA projected adequacy or shortage FTE in a year. rank_by=state needs occupation; rank_by=occupation optionally takes geography (default US) and group."
    },
    {
      "name": "workforce_describe_dataset",
      "title": "Describe health workforce datasets",
      "description": "Lists bundled datasets (AHRF 2024-2025 county + state/national, NCHWA projections), coverage, profession groups and known gaps."
    }
  ]
}