2027 open enrollment. 3.15M must pick a new plan.

Your county →

Home / Tools / Medicare Advantage, Part D, Medicaid

Medicare Advantage, Part D, MedicaidL2 · v1.0.0 · read-only

get_contract_profile

Get Contract Profile

What it answers

Everything Vlada holds on one Medicare Advantage contract, or one of its plans, in ONE call: the contract (name, parent, plan type, plans and counties served), enrollment by year and state, plan economics (risk score, Part A/B payment and rebate per member per month, by year), Overall / Part C / Part D stars by rating year, every plan's premium, MOOP, deductibles and supplemental allowances with the change from the prior plan year, ALL 36 filed benefits for a plan (doctor, hospital, emergency, diagnostics, equipment, drugs, dental, vision, hearing, OTC) with history back to 2019, the largest counties with share of county, and the 15 contracts it competes with most in its own counties.

ARGS: contract_id (H5549, R5826, ...). Optional plan_id ('011' or 'H5549-011'): that plan's benefits come back in full with their history. Without plan_id, benefits come back for the largest `benefit_plans` individual plans offered in the benefit year (default 3, max 5). Optional sections: any of contract, enrollment, economics, stars, plans, benefits, counties, competitors (default all).

SOURCE: the same nightly build that serves vladahealth.com/ma (CMS monthly enrollment, CMS Landscape and plan benefit package filings, CMS plan payment files, CMS Star Ratings); value.build names it. Benefits are the plan's FILED design; a D-SNP member's cost is usually lower after Medicaid. Employer group plans (800-series) file placeholder cost sharing and are flagged egwp. The record holds the 40 largest plans and 40 largest counties; plan_count and county_count give the full numbers. For one benefit across many plans use get_pbp_benefit; for star measures use get_stars with include_measures.

Inputs

benefit_plans
integer · optional
contract_id
string · optional
plan_id
string · optional
sections
array · optional

Call it

From an agent: connect the Vlada MCP once (one click for Claude, ChatGPT, Cursor, VS Code) and ask in plain English; the agent selects get_contract_profile when the question fits. From code: the same tool over REST with an API key. The schema endpoint needs no key.

curl -X POST https://api.vladahealth.com/v1/tools/get_contract_profile \
  -H "Authorization: Bearer $VLADA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
curl https://api.vladahealth.com/v1/tools/get_contract_profile/schema      # the JSON schema, no auth
# MCP endpoint (Streamable HTTP): https://mcp.vladahealth.com/mcp

What comes back

Typed rows plus provenance on every answer: the public source file, its vintage, the methodology, and a response_hash you can replay. Prove and replay tools turn any number into a re-runnable receipt. A number the data cannot support comes back as “not in the data”, never as zero.

Sources behind it

Known limits

  • The record carries the 40 largest plans and 40 largest counties of a contract; plan_count and county_count are the full counts.
  • Benefits are the filed plan benefit package design (one segment's row for a segmented plan), not what a dual eligible member pays after Medicaid.
  • The plan crosswalk is not part of this record.

As of the 2026-10-19 build of the served surface · machine-readable catalog · the live server may run a different version; the schema endpoint above is authoritative for what is deployed.