{
  "name": "partcd-star-ratings-mcp",
  "title": "HealthMesh · Medicare Part C & D Star Ratings MCP",
  "version": "0.1.1",
  "description": "Medicare Advantage (Part C) and Part D Star Ratings from CMS's published Star Ratings data tables (rating years 2025, 2026 and 2027; 2027 released Oct 8 2026): contract overall / Part C / Part D summary ratings with year-over-year history, domain and measure-level stars with raw scores, CMS measure weights, star cut points (MA-PD vs PDP), high/low performing flags, CAI and disaster percentages, and contract rankings by state, parent organization and rating.",
  "healthmesh_domain": "Quality & Risk",
  "datasets": [
    "QUAL-05"
  ],
  "mcp_endpoint": "https://partcd-star-ratings.healthmesh.ai/mcp",
  "transport": "Streamable HTTP (stateless, JSON responses)",
  "authorization": "none",
  "auth_mode": "off",
  "docs": "https://github.com/HendrikK/healthmesh/tree/main/servers/partcd-star-ratings-mcp#readme",
  "contact": "hendrik.kleine@gmail.com",
  "data_source": {
    "name": "CMS Part C and D Star Ratings data tables + Technical Notes",
    "url": "https://www.cms.gov/medicare/health-drug-plans/part-c-d-performance-data",
    "license": "U.S. Government work, public domain",
    "refresh": "yearly each October (bundled; GitHub Actions checks the CMS page weekly)"
  },
  "tools": [
    {
      "name": "stars_get_contract_rating",
      "title": "Star Ratings for a Medicare contract",
      "description": "Returns a Medicare Advantage or Part D contract's overall, Part C summary and Part D summary Star Ratings for a rating year (default the latest, 2027), its domain stars, high/low performing icons, CAI factors, disaster percentages, the year-over-year history across all loaded years (with whether it dropped below 4 stars) and the states where it has reported enrollment."
    },
    {
      "name": "stars_get_measure_scores",
      "title": "Measure-level stars and scores for a contract",
      "description": "Returns the measure-level Star Ratings and raw scores for one contract and rating year (e.g. C01 Breast Cancer Screening ... D13 Poly-ACH in 2027), with each measure's CMS weight, weighting category, domain, measurement period, the 4- and 5-star cut points for the contract's plan type and a 'pulling down' list of the rated measures with the largest weighted shortfall versus the contract's summary rating. Filter to one measure with measure (ID or name)."
    },
    {
      "name": "stars_get_cut_points",
      "title": "Star cut points for a measure",
      "description": "Returns CMS's Star Ratings cut points (score thresholds for 2-5 stars) for a measure and rating year, parsed into thresholds with direction (higher or lower is better) plus CMS's original strings, for MA (Part C) or MA-PD vs PDP (Part D), and the 4-star threshold for the same-named measure in the other loaded years."
    },
    {
      "name": "stars_rank_contracts",
      "title": "List and rank contracts by Star Rating",
      "description": "Lists Medicare Advantage and/or Part D contracts for a rating year filtered by state (contracts with reported enrollment there, CMS CPSC file), parent organization, name, plan kind (MA or PDP) and a rating range, sorted by rating (or enrollment), with prior-year rating and high/low performing icons. Examples: 5-star contracts in Ohio; UnitedHealth contracts below 3.5 stars (max_rating 3)."
    },
    {
      "name": "stars_describe_dataset",
      "title": "Describe the Star Ratings data",
      "description": "Explains the CMS Star Ratings data loaded (rating years, release dates, files with SHA-256, contract and measure counts, measure lists with weights per year), the state-enrollment map, the status codes CMS uses instead of stars, and the main caveats."
    }
  ]
}