get_landscape

What it answers

1. 1Returns the CMS Landscape view of a Medicare plan: monthly premium, in-network MOOP, overall star rating, plan type, and the county/state service-area breadth.
2. 2Filter by contract_id (required) + optional plan_id (1 to 3 digits, zero-padded), segment_id and year; omit plan_id to list all plans on a contract.
3. 3RETURNS a detail payload, not a plan-year count: value.plans is the actual PLAN LIST, ONE ROW PER PLAN SEGMENT (report_year, plan_id, segment_id, segment_count, plan_name, org_name, parent_org_name, plan_type, category, snp_type, total_premium, total_premium_basis, premium_as_filed, consolidated_premium, part_c_premium, part_d_premium, moop_in_network, overall_star_rating, overall_star_status, service_area_county_count / state_count), sorted premium ascending so the cheapest lead; value.summary rolls it up (plan_count = distinct plans, segment_row_count, segmented_plan_count, total premium min / median / max, zero-premium count, premium basis counts, star min / max, total distinct counties); value.row_counts carries matched / returned / truncated and value.query the filters applied.
4. 4`limit` bounds the row list (default 200, max 2000); a truncated list always carries a caveat.
5. 5READING THE PREMIUM. total_premium is the plan's monthly premium on one basis per row, named in total_premium_basis: 'consolidated' (CMS's Part C plus Part D figure), 'part_c_only_no_drug_coverage' (from CY2025 CMS prints the consolidated premium as 'Not Applicable' on every plan without drug coverage, so the Part C premium is the whole premium), 'part_d_only' (a PDP), or null when CMS filed no figure.
6. 6CMS's own text is carried in premium_as_filed; its '$-' token (CY2014, 2015, 2019-2023) is a $0 premium, never missing.
7. 7A segment is its own filed design: a segmented plan has one row per segment with its own premium and MOOP.
8. 8Covers ALL plan categories (MA, PDP, SNP, MMP, Cost), 2007-2027; the CY2027 file loaded 2026-09-28.
9. 9The Landscape drops ~early September, ahead of the October benefits drop, so it is the first official view of the upcoming plan year.
10. 10Stars for 2013-2020 are read from CMS's text form ('3.5 Stars'); a CMS message in place of a star is carried in overall_star_status.
11. 11Pair with get_pbp_benefit (benefits) for the full picture.
12. 12A contract / plan / year with no Landscape rows returns found=false with a not_found_reason.
13. 13SOURCE: CMS MA/Part-D Landscape source files.

Inputs (5)

Call it

# MCP (https://mcp.vladahealth.com/mcp): the tool by name
get_landscape(contract_id="H1036", year=2026, limit=5)

curl -X POST https://api.vladahealth.com/v1/tools/get_landscape \
  -H "Authorization: Bearer $VLADA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contract_id":"H1036","year":2026,"limit":5}'

# the schema, no key
curl https://api.vladahealth.com/v1/tools/get_landscape/schema

A real answer

{
 "value": {
  "found": true,
  "not_found_reason": null,
  "summary": {
   "contract_id": "H1036",
   "plan_id": null,
   "segment_id": null,
   "years_covered": [
    2026
   ],
   "plan_count": 86,
   "segment_row_count": 88,
   "segmented_plan_count": 2,
   "org_name": "Humana",
   "parent_org_name": "Humana Inc.",
   "categories": [
    "MA",
    "SNP"
   ],
   "plan_types": [
    "HMO",
    "HMO C-SNP",
    "HMO D-SNP",
    "HMO-POS"
   ],
   "total_premium_min": 0.0,
   "total_premium_median": 0.0,
   "total_premium_max": 38.4,
   "total_premium_basis_counts": {
    "consolidated": 85,
    "part_c_only_no_drug_coverage": 3
   },
   "consolidated_premium_min": 0.0,
   "consolidated_premium_median": 0.0,
   "consolidated_premium_max": 38.4,
   "zero_premium_plan_count": 78,
   "plans_missing_premium": 0,
   "moop_in_network_min": 500.0,
   "moop_in_network_max": 9250.0,
   "overall_star_rating_min": 4.5,
   "overall_star_rating_max": 4.5,
   "overall_star_statuses": [],
   "max_service_area_county_count": 118,
   "unit": "landscape_plan_segment_rows"
  },
  "plans": [
   {
    "report_year": 2026,
    "category": "MA",
    "contract_id": "H1036",
    "plan_id": "025",
    "segment_id": "000",
    "org_name": "Humana",
    "parent_org_name": "Humana Inc.",
    "plan_name": "Humana Gold Plus H1036-025 (HMO)",
    "plan_type": "HMO",
    "snp_type": null,
    "part_d_coverage_indicator": "Yes",
    "premium_as_filed": "$0.00",
    "consolidated_premium": 0.0,
    "part_c_premium": 0.0,
    "part_d_premium": 0.0,
    "moop_in_network": 2000.0,
    "overall_star_rating": 4.5,
    "overall_star_status": null,
    "service_area_county_count": 4,
    "service_area_state_count": 1,
    "total_premium": 0.0,
    "total_premium_basis": "consolidated",
    "segment_count": 1
   },
   {
    "report_year": 2026,
    "category": "MA",
    "contract_id": "H1036",
    "plan_id": "044",
    "segment_id": "000",
    "org_name": "Humana",
    "parent_org_name": "Humana Inc.",
    "plan_name": "Humana Gold Plus H1036-044 (HMO)",
    "plan_type": "HMO",
    "snp_type": null,
    "part_d_coverage_indicator": "Yes",
    "premium_as_filed": "$0.00",
    "consolidated_premium": 0.0,
    "part_c_premium": 0.0,
    "part_d_premium": 0.0,
    "moop_in_network": 2700.0,
    "overall_star_rating": 4.5,
    "overall_star_status": null,
    "service_area_county_count": 2,
    "service_area_state_count": 1,
    "total_premium": 0.0,
    "total_premium_basis": "consolidated",
    "segment_count": 1
   },
   {
    "report_year": 2026,
    "category": "MA",
    "contract_id": "H1036",
    "plan_id": "054",
    "segment_id": "000",
    "org_name": "Humana",
    "parent_org_name": "Humana Inc.",
    "plan_name": "Humana Gold Plus H1036-054C (HMO)",
    "plan_type": "HMO",
    "snp_type": null,
    "part_d_coverage_indicator": "Yes",
    "premium_as_filed": "$0.00",
    "consolidated_premium": 0.0,
    "part_c_premium": 0.0,
    "part_d_premium": 0.0,
    "moop_in_network": 500.0,
    "overall_star_rating": 4.5,
    "overall_star_status": null,
    "service_area_county_count": 1,
    "service_area_state_count": 1,
    "total_premium": 0.0,
    "total_premium_basis": "consolidated",
    "segment_count": 1
   },
   {
    "report_year": 2026,
    "category": "MA",
    "contract_id": "H1036",
    "plan_id": "062",
    "segment_id": "000",
    "org_name": "Humana",
    "parent_org_name": "Humana Inc.",
    "plan_name": "Humana Gold Plus H1036-062C (HMO)",
    "plan_type": "HMO",
    "snp_type": null,
    "part_d_coverage_indicator": "Yes",
    "premium_as_filed": "$0.00",
    "consolidated_premium": 0.0,
    "part_c_premium": 0.0,
    "part_d_premium": 0.0,
    "moop_in_network": 1625.0,
    "overall_star_rating": 4.5,
    "overall_star_status": null,
    "service_area_county_count": 1,
    "service_area_state_count": 1,
    "total_premium": 0.0,
    "total_premium_basis": "consolidated",
    "segment_count": 1
   },
   {
    "report_year": 2026,
    "category": "MA",
    "contract_id": "H1036",
    "plan_id": "065",
    "segment_id": "000",
    "org_name": "Humana",
    "parent_org_name": "Humana Inc.",
    "plan_name": "Humana Gold Plus H1036-065C (HMO)",
    "plan_type": "HMO",
    "snp_type": null,
    "part_d_coverage_indicator": "Yes",
    "premium_as_filed": "$0.00",
    "consolidated_premium": 0.0,
    "part_c_premium": 0.0,
    "part_d_premium": 0.0,
    "moop_in_network": 1000.0,
    "overall_star_rating": 4.5,
    "overall_star_status": null,
    "service_area_county_count": 1,
    "service_area_state_count": 1,
    "total_premium": 0.0,
    "total_premium_basis": "consolidated",
    "segment_count": 1
   }
  ],
  "row_counts": {
   "plans": {
    "matched": 88,
    "returned": 5,
    "truncated": true,
    "limit": 5,
    "kept": "head"
   }
  },
  "query": {
   "contract_id": "H1036",
   "plan_id": null,
   "segment_id": null,
   "year": 2026,
   "limit": 5
  },
  "query_id": "17f12f65-4469-41b8-ae46-fdb1d77f6311"
 },
 "unit": "landscape_detail",
 "result_status": "answered_with_caveats",
 "methodology_era": null,
 "methodology_blend_factors": null,
 "source": {
  "source_url": "medicare://get_landscape"
 },
 "vintage": "as_restated",
 "cms_vintage_sequence": 1,
 "parse_revision": 1,
 "as_of_observed": null,
 "as_of_asserted": null,
 "as_of_effective": null,
 "caveats": [
  {
   "caveat_type": "methodology_note",
   "severity": "info",
   "message": "The Landscape is the consumer view (categories MA, PDP, SNP, MMP and Cost). Premium, MOOP and star are the values the plan filed, not adjudicated experience; the benefit tool carries the cost-share detail. The total premium is the monthly premium on the basis named beside it: the consolidated figure CMS filed, the Part C premium alone where the plan has no drug coverage, or the Part D premium alone for a drug plan. The premium as filed is CMS's own text, where the token '$-' is a $0 premium. The county count is the distinct counties in the Landscape file for that pla
…

What comes back

Sources

Known limits (0)