{
  "name": "eligibility-rules-mcp",
  "title": "HealthMesh · Eligibility Rules (FPL + Medicaid/CHIP limits) MCP",
  "version": "0.1.1",
  "description": "HHS poverty guidelines (FPL, 1983-2026, 48 states+DC / Alaska / Hawaii, live ASPE API) and state Medicaid, CHIP and Basic Health Program income-eligibility limits as % FPL by group (children by age, pregnant women, parents, expansion adults, aged/disabled pathways; MACPAC MACStats 2025), with %FPL conversion and a household screener that estimates LIKELY programs (not a determination).",
  "healthmesh_domain": "Eligibility & Enrollment",
  "datasets": [
    "ELIG-07",
    "ELIG-08"
  ],
  "mcp_endpoint": "https://eligibility-rules.healthmesh.ai/mcp",
  "transport": "Streamable HTTP (stateless, JSON responses)",
  "authorization": "none",
  "auth_mode": "off",
  "docs": "https://github.com/HendrikK/healthmesh/tree/main/servers/eligibility-rules-mcp#readme",
  "contact": "hendrik.kleine@gmail.com",
  "data_source": {
    "name": "HHS ASPE Poverty Guidelines API + MACPAC MACStats Exhibits 35-37 (Medicaid/CHIP income eligibility levels)",
    "url": "https://www.macpac.gov/publication/medicaid-and-chip-eligibility-exhibits-35-38/",
    "license": "U.S. Government Works (public domain): HHS/ASPE poverty guidelines; MACPAC (federal legislative-branch agency) MACStats exhibits 35-37",
    "refresh": "FPL live (24 h cache); MACPAC tables weekly check via GitHub Actions"
  },
  "tools": [
    {
      "name": "elig_get_poverty_guideline",
      "title": "HHS poverty guideline (FPL) for a year, household size and region",
      "description": "Returns the HHS poverty guideline (annual income at 100% FPL) for a year (1983–latest), household size (1–20) and region (48 states + DC, Alaska, Hawaii), plus thresholds at any percentages (e.g. 138, 200, 400) as annual and monthly dollars. Pass state to pick the region automatically."
    },
    {
      "name": "elig_compute_fpl_percent",
      "title": "Convert household income to % of the poverty guideline",
      "description": "Converts annual or monthly household income into percent of the HHS poverty guideline for a household size, year and region (or state). Use before comparing with program limits; pass purpose='marketplace' to use the prior-year guideline that premium tax credits use."
    },
    {
      "name": "elig_get_state_thresholds",
      "title": "State Medicaid / CHIP / BHP income limits by group",
      "description": "A state's Medicaid, CHIP and Basic Health Program income-eligibility limits as % FPL by group (children by age, separate CHIP, pregnant women, parents, adults 19–64 / ACA expansion, BHP, aged/disabled pathways), with MACPAC footnotes and ACA expansion status. Pass household_size to also get dollar limits at the latest poverty guideline."
    },
    {
      "name": "elig_rank_states",
      "title": "Compare states on one eligibility group's income limit",
      "description": "Lists states by their income limit (% FPL) for one group, e.g. which states cover pregnant women above 200% FPL (group='pregnant', min_pct=200), the most generous separate CHIP limits, or parent limits in non-expansion states. Includes states that do not use the pathway when include_not_covered=true."
    },
    {
      "name": "elig_screen_household",
      "title": "Screen a household for likely Medicaid / CHIP / BHP / Marketplace help",
      "description": "Estimates which programs each household member is LIKELY eligible for from state income limits (% FPL, incl. the 5-point MAGI disregard) and Marketplace premium-tax-credit rules, with the %FPL used. Pass members [{age, pregnant, disabled}] (parents are inferred when a child under 19 is present). An estimate only: ignores immigration status, assets for non-MAGI groups, other coverage and state-specific rules."
    },
    {
      "name": "elig_describe_dataset",
      "title": "What this server covers",
      "description": "Sources, coverage dates, group definitions and caveats. Lean by default; section='groups' lists every eligibility group, 'footnotes' the MACPAC notes, 'all' everything."
    }
  ]
}