Vlada
Work with Vlada

Home / Tools

42 tools, one connection.

This is what an AI agent can do once it is connected to the Vlada MCP server: query and join the US healthcare public record, with the source file, its vintage and a replayable hash on every answer. Each tool page shows its inputs, how to call it over MCP or REST, what comes back, the sources behind it, and its known limits, exactly as the server describes itself to the agent.

Connect your AI →REST quickstart →Every data point Vlada has →The data behind the tools →

Medicare Advantage, Part D, Medicaid 10

get_enrollmentv0.2.0 · L2 · needs contract_id
Returns CMS monthly enrollment for a Medicare Advantage plan or contract: the member count, the trend over time, and, at contract level, the MA-only vs Part-D split, plus org/parent and plan type.
get_hosv0.2.0 · L2 · needs contract_id
Returns a Medicare Advantage contract's CMS Health Outcomes Survey (HOS) rates across the four survey topics (fall_risk_management, urinary_incontinence, osteop
get_landscapev0.2.0 · L2 · needs contract_id
Returns the CMS Landscape view of a Medicare plan: monthly consolidated premium, in-network MOOP, overall star rating, plan type, and the county/state service-area breadth.
get_market_sharev0.2.0 · L2 · needs contract_id
Returns a Medicare Advantage plan's or contract's county-level enrollment and its SHARE of the local MA market: for each county, the plan's enrollees, the count
get_medicaid_mco_enrollmentv0.1.0 · L2 · needs state
Returns Medicaid managed-care enrollment for ONE state: the annual CMS 'Enrollment by Program and Plan' roster (each managed-care program x plan with SEPARATE M
get_pbp_benefitv0.3.0 · L2 · needs contract_id, plan_id, payment_year, category
Returns Plan Benefit Package (PBP) benefit detail for an MA plan for a specific category (dental, inpatient_hospital, ER, etc.).
get_starsv0.2.0 · L2 · needs contract_id
Returns a Medicare Advantage contract's CMS Star Ratings: the Overall, Part C, and Part D summary stars for a rating year, each with the year-over-year change vs the prior year.
get_stars_cutpointsv0.1.0 · L2 · needs rating_year
Returns CMS-published per-measure star-level cutpoints (threshold boundaries) for a rating_year.
medicare_allowedv0.1.0 · L2 · needs billing_code
Returns the Medicare allowed amount for ONE billing code (CPT/HCPCS, or an MS-DRG for inpatient) from every Medicare fee schedule that prices it: PFS (professio
prove_ma_enrollment_trendv0.1.0 · L2 · needs parent_org, year_range_start, year_range_end
Execute a bounded MA enrollment-trend proof.

Hospital price transparency 5

compare_hospital_ratesv1.10.0 · L2 · needs billing_code
Compares what a billing code costs ACROSS hospitals (cheapest real price first) with a p10/median/p90 benchmark AND a per-(payer x line-of-business) breakdown.
get_hospital_qualityv0.1.0 · L2 · needs ccn
Returns one hospital's CMS Care Compare quality record by CCN: the overall star rating (1-5) with hospital type / ownership; every Care Compare measure for the
plan_hospital_pricev1.3.0 · L2 · needs hospital_ccn, billing_code
Dry-run a bounded hospital fact_hospital_chargemaster proof.
prove_hospital_pricev1.3.0 · L2 · needs hospital_ccn, billing_code
Execute a bounded hospital chargemaster price proof and return rate summary values plus a receipt with source snapshot, filters, raw byte provenance, caveats, i
replay_hospital_pricev1.3.0 · L2 · needs receipt
Replay a hospital price-proof receipt by re-running its recorded tool inputs and comparing response hash, Iceberg snapshot, plan hash, row count, status, and raw-byte source descriptor.

Commercial payer rates 8

get_exchange_plan_profilev1.0.0 · L2
One ACA Marketplace (healthcare.gov / HIX) plan's profile for a plan year, every field tagged with the CCIIO PUF it came from.
get_negotiated_ratev2.1.0 · L2 · needs npi, code, payer
Get the negotiated rate a specific payer pays a specific NPI for a specific billing code, in a state.
lookup_rates_for_npiv1.1.0 · L2 · needs payer, npi, state
Look up the negotiated rates a payer pays a specific provider (NPI), resolved at query time through the canonical graph: NPI → provider groups → pg_sets → rates (no precomputed edge table).
lookup_rates_for_tinv1.1.0 · L2 · needs payer, tin, state
Look up the negotiated rates a payer attaches to a tax entity (TIN/EIN), resolved at query time through the canonical graph: TIN → provider groups (idx_tin_provider_group) → pg_sets → rates.
plan_commercial_price_proofv1.3.0 · L2 · needs payer, version_id
Dry-run a bounded commercial fact_rate proof.
prove_commercial_pricev1.3.0 · L2 · needs payer, version_id
Execute a bounded commercial fact_rate price proof and return rate summary values plus a receipt with source snapshot, filters, row count, caveats, input hash, response hash, and replay pointer.
query_substratev1.1.0 · L1 · needs sql
Run a read-only SQL SELECT directly over the Vlada cost-data substrate (Athena/Iceberg) and get the rows back, with provenance.
replay_commercial_price_proofv1.3.0 · L2 · needs receipt
Replay a commercial price-proof receipt by re-running its recorded tool inputs and comparing response hash, Iceberg snapshot, plan hash, status, and row count.

Provider identity 1

resolve_providerv1.0.0 · L2
Resolve a provider's identity: an NPI, an EIN, or an organisation name (+ state) -> the Medicare CCN(s) it maps to, the CCN's provider type from the CCN authori

Drugs and formularies 8

asp_pricing_lookupv1.0.0 · L2
Given an HCPCS code or short-description search, returns Medicare Part B ASP quarterly payment-limit rows from drug_silver.fact_drug_asp_quarterly with trend aggregates.
excluded_prescriber_payment_screenv1.2.0 · L2 · needs npi
Given an NPI (10-digit), returns OIG LEIE exclusion status and — if excluded — any Open Payments received OR Part D prescribing activity recorded AFTER the excl
formulary_churnv1.0.0 · L2 · needs report_quarter_from, report_quarter_to
Given a quarter-pair (report_quarter_from, report_quarter_to) AND a formulary or plan filter, returns the formulary delta: drugs added, drugs dropped, drugs re-
get_drug_source_inventoryv1.0.0 · L2
Discover the drug substrate.
ira_drug_label_risk_screenv1.0.0 · L2
Given an optional drug_name (brand or generic substring), returns IRA-Selected Drugs with their CURRENT FDA structured-label posture (boxed warning / REMS / pre
ira_mfp_exposurev1.0.0 · L2 · needs drug_name
Returns the cross-payer federal exposure for an IRA-eligible drug: IRA Maximum Fair Price (when in the IPAY-2026 cohort) + Part D total spend + Part B total spe
pbm_compensation_rollupv2.0.0 · L2 · needs pbm_name
Sums Form 5500 Schedule C direct + indirect compensation for a named PBM across one or more plan years.
recall_spend_windowv2.0.0 · L2 · needs recall_number
Given an FDA-assigned recall_number, returns recall metadata plus Medicare Part D and Medicaid SDUD federal spend on the recalled drug during the recall window

Curated datasets 10

certified_measurev1.0.0 · L2
Run a GOVERNED KPI by name from the certified measures registry.
describe_data_sourcev1.1.0 · L1 · needs source_fqn
Return the catalog record for one substrate data source.
describe_schemav1.0.0 · L1
Return the semantic layer: marts, columns, invariants, canonical payers, and the tools YOU can call (the same list tools/list returns for you, never a wider catalog).
fetch_queryv1.0.0 · L2 · needs job_id
Fetch the result of an async job once it is done.
find_data_sourcesv1.0.0 · L1
Search the Vlada substrate catalog by keyword.
how_to_joinv1.3.0 · L2 · needs table_a
Return the fail-closed measured way to join two Vlada substrate tables, including an explicit DIRECT_OK, DIRECT_DECLARED_KEY, NEEDS_GRAIN, ROUTE_THROUGH_DIM, ROUTE_MULTIHOP, or DO_NOT_SERVE directive.
poll_queryv1.0.0 · L2 · needs job_id
Poll the status of an async job submitted with submit_query.
queryv0.3.0 · L1 · needs source_fqn
SAFE STUB. Given a catalog source FQN, return HOW to query it FROM THIS MCP -- and only paths executable here: query_substrate (sync, small) or submit_query ->
state_expertv1.0.0 · L2 · needs state_code
The callable STATE EXPERT — the data-availability + regulation X-ray for a US state.
submit_queryv1.1.0 · L2 · needs tool
Submit a heavy/long-running query to run OFF the request path and get a job_id back immediately, instead of blocking (and risking a timeout) on a statewide/cross-hospital scan.

Served surface as of the 2026-09-19 build · machine-readable catalog · schemas without auth at https://api.vladahealth.com/v1/tools · every answer traced to its public source.