{
  "name": "medicare-enrollment-mcp",
  "title": "HealthMesh · Medicare Enrollment MCP",
  "version": "0.1.0",
  "description": "Medicare enrollment: monthly and yearly beneficiary counts (Original Medicare vs Medicare Advantage & other health plans, Part A/B, Part D PDP vs MA-PD, low-income subsidy, dual eligibles by QMB/SLMB category, aged/disabled/ESRD, age, sex, race) for the nation, states/territories and counties since 2013 (CMS Medicare Monthly Enrollment, live data.cms.gov API), plus Medicare Advantage & Part D enrollment by contract, plan, state and county with parent-organization market share (CMS monthly CPSC and contract enrollment files).",
  "healthmesh_domain": "Eligibility & Enrollment",
  "datasets": [
    "ELIG-02",
    "ELIG-03"
  ],
  "mcp_endpoint": "https://medicare-enrollment.healthmesh.ai/mcp",
  "transport": "Streamable HTTP (stateless, JSON responses)",
  "authorization": "none",
  "auth_mode": "off",
  "docs": "https://github.com/HendrikK/healthmesh/tree/main/servers/medicare-enrollment-mcp#readme",
  "contact": "hendrik.kleine@gmail.com",
  "data_source": {
    "name": "CMS Medicare Monthly Enrollment (data.cms.gov API) + CMS MA/Part D monthly contract & CPSC enrollment files",
    "url": "https://www.cms.gov/data-research/statistics-trends-and-reports/medicare-advantagepart-d-contract-and-enrollment-data/monthly-enrollment-contract/plan/state/county",
    "license": "U.S. Government Work (public domain) – https://www.usa.gov/government-works",
    "refresh": "MME live (6 h cache); MA/Part D monthly via GitHub Actions"
  },
  "tools": [
    {
      "name": "medicare_get_enrollment",
      "title": "Medicare beneficiaries for a nation, state or county and month/year",
      "description": "Medicare beneficiary counts from CMS Medicare Monthly Enrollment (live data.cms.gov, 2013 onward): total, Original Medicare vs Medicare Advantage & other, Part A/B, Part D (PDP vs MA-PD, LIS), dual eligibles (full/partial, QMB/SLMB/QI), aged/disabled/ESRD, age, sex, race. Defaults: latest month, headline fields + ma_penetration_pct. Pick states, county_fips, or states + county_name (e.g. 'Maricopa'). fields accepts field names, derived % metrics or groups (core, entitlement, sex, race, age, dual, parts, part_d, all)."
    },
    {
      "name": "medicare_get_enrollment_trend",
      "title": "Medicare enrollment time series",
      "description": "Monthly (2013-01 onward) or yearly person-year series of up to 5 Medicare Monthly Enrollment metrics (e.g. TOT_BENES, MA_AND_OTH_BENES, ma_penetration_pct, DUAL_TOT_BENES, PRSCRPTN_DRUG_TOT_BENES) for the nation, one state/territory or one county, with first-to-last change (percentage points for % metrics)."
    },
    {
      "name": "medicare_rank_geographies",
      "title": "Rank states or counties on a Medicare enrollment metric",
      "description": "Ranks states/territories, or counties (within one state or nationwide), on any Medicare Monthly Enrollment metric or derived % (ma_penetration_pct, dual_pct, full_dual_pct, part_d_pct, disabled_pct, lis_pct_of_part_d) for one month or year. Filters: min_value/max_value (e.g. counties with ma_penetration_pct > 60), min_total_benes. Suppressed values are excluded and counted."
    },
    {
      "name": "ma_search_contracts",
      "title": "Find MA / Part D contracts by organization, brand or parent name",
      "description": "Finds Medicare Advantage and Part D contracts by contract ID or words of the legal organization name, marketing name or parent organization (e.g. 'Humana', 'UnitedHealth', 'Kaiser', 'H5216'), with latest-month enrollment from the CMS contract report. Use the contract_id with ma_get_contract_enrollment."
    },
    {
      "name": "ma_get_contract_enrollment",
      "title": "Enrollment for one MA / Part D contract by state, county or plan, with monthly history",
      "description": "For one CMS contract (e.g. H5216): organization, parent and plan types; exact total enrollment from the latest contract report and its monthly history since 2024-01; plus a breakdown by state (default), by county within a state, or by plan (nationally or within a state). With plan_id + state: that plan's counties. With county_fips: the contract's enrollment in that county."
    },
    {
      "name": "ma_get_market_share",
      "title": "MA / Part D market share by parent organization or contract",
      "description": "Ranks parent organizations (default) or contracts by enrollment and share in the US, a state, or up to 10 counties combined, for Medicare Advantage & other plans (default), stand-alone PDPs, or both, from the latest CMS CPSC file. Shares use enrollment in published cells (>10) as the denominator; suppressed cells are counted."
    },
    {
      "name": "medicare_describe_dataset",
      "title": "What this server covers",
      "description": "Coverage and definitions: live Medicare Monthly Enrollment periods, loaded MA/Part D report month and contract history, suppression rules, gaps and sources. Lean by default; section='fields' lists every metric, 'sources' gives source files with checksums, 'all' returns everything."
    }
  ]
}