Medicare.gov MCP server for AI agents
Let Claude, ChatGPT or your own agent read Medicare.gov: 7 typed functions through one MCP server. No Medicare.gov API key needed.
- Site
- medicare.gov
- Functions
- 7
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Medicare.gov alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/medicareOne MCP server for Medicare.gov and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.
Functions
Open a function to see its arguments, what it returns and how to call it.
findDoctorsSearches Medicare's Care Compare directory for doctors and clinicians by name, specialty and location, and returns each one's NPI, specialties, the…Arguments
Name Type Required zipstring5-digit US ZIP, placed via the Census Bureau's ZCTA centroid.No latitudenumberNo longitudenumberNo radiusMilesnumberStraight-line miles, default 25, max 100.No specialtystringMatched case-insensitively as a SUBSTRING against the primary specialty and against the packed secondary list, so "cardio" finds "CARDIOVASCULAR DISEASE (CARDIOLOGY)".No lastNamestringMatched as a PREFIX, which is what a caller typing a surname means.No firstNamestringNo acceptsAssignmentOnlybooleanTrue restricts to clinicians who ALWAYS take the Medicare-approved amount as payment in full.No limitnumberMax distinct clinicians returned, default 20, max 100.No Returns
medicareClinicianSearch/** Whether a clinician takes Medicare's approved amount as payment in full. * NOT a boolean, and that is load-bearing: CMS's `ind_assgn` is only ever "Y" * or "M", never "N", so "does not take Medicare" is not a state this data can * express, and mapping "M" onto false would invent it. */ type medicareAssignmentAcceptance = /** Participating: takes the Medicare-approved amount as full payment. */ | "always" /** Non-participating: may accept case by case, and when they do not they can * bill up to Medicare's limiting charge ABOVE the approved amount, which the * patient pays. Never render this as "no". */ | "mayAccept"; interface medicareClinicianAffiliation { /** One of CMS's seven: "Hospital", "Home health agency", "Hospice", "Dialysis * facility", "Nursing home", "Inpatient rehabilitation facility", * "Long-term care hospital". */ facilityType: string; /** The facility's CMS Certification Number, the join key into every other CMS * facility dataset, including this provider's own `findNursingHomes`. */ ccn: string; /** Resolved for "Hospital" rows; null for the other six types rather than * guessed from the wrong dataset. `ccn` still joins when this is null. */ name: string | null; } interface medicareClinicianGroupPractice { /** Null for a solo practitioner billing under no organisation. */ name: string | null; pacId: string | null; /** Clinicians billing under the group nationally. */ memberCount: number | null; /** The GROUP's posture, which can differ from the individual's. */ acceptsAssignment: medicareAssignmentAcceptance | null; } interface medicareClinician { /** National Provider Identifier, the id to key on. */ npi: string; pacId: string | null; firstName: string; middleName: string | null; lastName: string; suffix: string | null; /** e.g. "MD", "DO", "NP". Null means "not published", never "no credential". */ credential: string | null; gender: string | null; medicalSchool: string | null; graduationYear: number | null; /** CMS's caps-written specialty, e.g. "CARDIOVASCULAR DISEASE (CARDIOLOGY)". * Also the value the `specialty` filter matches against. */ primarySpecialty: string | null; secondarySpecialties: string[]; /** Billed Medicare for telehealth in this extract. A false is not a promise * they refuse it. */ offersTelehealth: boolean; groupPractice: medicareClinicianGroupPractice; address: string; city: string; state: string; /** 5-digit, cut from CMS's ZIP+4. */ zip: string; /** The full ZIP+4 as CMS publishes it, what the dataset is keyed on. */ zipPlus4: string; phone: string | null; /** Straight-line miles to the CENTROID OF THIS CLINICIAN'S ZIP, not to their * street address: the CMS clinician file publishes no coordinates. Everyone * sharing a ZIP shares a distance, and a large rural ZIP carries real slack. */ distanceMiles: number; /** Read `medicareAssignmentAcceptance` before rendering this. */ acceptsAssignment: medicareAssignmentAcceptance | null; /** Empty when CMS publishes no affiliation, common, not an error. */ affiliations: medicareClinicianAffiliation[]; } interface medicareClinicianSearch { origin: { zip: string | null; latitude: number; longitude: number; source: "zcta-centroid" | "caller"; }; radiusMiles: number; /** ZIP Code Tabulation Areas the Census Bureau places inside the radius. */ zipsInRadius: number; /** How many of them this call actually queried, nearest first. */ zipsSearched: number; /** FALSE when the search stopped early, normally because `limit` was already * satisfied, which in a city happens on the first ZIP of several hundred. Read * it before describing the result as everyone in the radius. */ radiusFullyScanned: boolean; /** Practice-location RECORDS matching in the ZIPs actually searched, NOT * distinct clinicians and NOT a radius-wide total. CMS's grain is (clinician, * address). */ matchesInSearchedZips: number; /** CMS's publication date for the National Downloadable File. A periodic * extract, not a live read. */ dataAsOf: string | null; /** Distinct by NPI, nearest first; a clinician with several addresses in range * appears once, at the nearest. */ clinicians: medicareClinician[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/medicare/findDoctorsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.medicare.findDoctors({ zip: "19046", radiusMiles: 10, limit: 5 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.medicare.findDoctors({"zip": "19046", "radiusMiles": 10, "limit": 5}))curl -X POST https://api.bowmark.ai/v1/sites/medicare/findDoctors \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":{"zip":"19046","radiusMiles":10,"limit":5}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.medicare.findDoctors({ zip: "19046", radiusMiles: 10, limit: 5 });findHospitalsReturns the hospitals near a location with the quality information CMS publishes about each.Arguments
Name Type Required zipstring5-digit US ZIP, placed via the Census Bureau's ZCTA centroid.No latitudenumberNo longitudenumberNo radiusMilesnumberStraight-line miles, default 25, max 100.No limitnumberMax hospitals returned, default 20. matchesInSearchedZips reports the unlimited-by-limit count for the ZIPs actually searched.No Returns
medicareHospitalSearchinterface medicareHospitalMeasureGroup { /** How many measures CMS defines for this group nationally. */ measuresInGroup: number | null; /** How many of them THIS hospital actually reported, can be fewer than * `measuresInGroup`; the gap is itself informative. */ measuresReported: number | null; /** Null for `patientExperience`/`timelyAndEffectiveCare`, CMS publishes no * national-average comparison for those two groups, only a rate. */ better: number | null; noDifferent: number | null; worse: number | null; /** CMS's own footnote code(s), verbatim, occasionally more than one, * comma-separated. */ footnote: string | null; } interface medicareHospital { /** CMS Certification Number, the same id `findNursingHomes` and * `findDoctors`'s hospital affiliations key on. */ ccn: string; name: string; address: string; city: string; state: string; zip: string; phone: string | null; county: string | null; /** Straight-line miles to the CENTROID OF THIS HOSPITAL'S OWN ZIP, not its * street address, this dataset carries no coordinates at all, the same gap * `findDoctors`'s clinician file has. Everyone sharing a ZIP shares a * distance, and a large rural ZIP carries real slack. */ distanceMiles: number; /** e.g. "Acute Care Hospitals", "Critical Access Hospitals", "Psychiatric", * "Childrens", "Rural Emergency Hospital". Never "Long-term", that type * belongs to `findRehabAndLongTermCareFacilities`. */ hospitalType: string; ownershipType: string | null; emergencyServices: boolean; birthingFriendly: boolean; /** 1-5, or null when CMS publishes none, about 40% of hospitals nationally * carry no overall rating, mostly because they don't participate in the * reporting programs this rating requires, not because they scored poorly. * A null is NOT a bad rating; read it with `overallRatingFootnote`. */ overallRating: number | null; /** Can be present even alongside a real star rating, always surface it. */ overallRatingFootnote: string | null; /** The measure GROUPS behind the star, not just the rollup. */ measureGroups: { mortality: medicareHospitalMeasureGroup; safety: medicareHospitalMeasureGroup; readmission: medicareHospitalMeasureGroup; patientExperience: medicareHospitalMeasureGroup; timelyAndEffectiveCare: medicareHospitalMeasureGroup; }; } interface medicareHospitalSearch { origin: { zip: string | null; latitude: number; longitude: number; source: "zcta-centroid" | "caller"; }; radiusMiles: number; /** ZIP Code Tabulation Areas the Census Bureau places inside the radius. */ zipsInRadius: number; /** How many of them this call actually queried, nearest-batch-first. */ zipsSearched: number; /** FALSE when the walk stopped before every ranked ZIP was queried, * normally because `limit` was already satisfied. Read it before describing * the result as "every hospital in the radius". */ radiusFullyScanned: boolean; /** Hospitals found in the ZIPs actually searched, before `limit`, NOT a * radius-wide total when `radiusFullyScanned` is false. */ matchesInSearchedZips: number; /** CMS's own publication date for this extract. Not "today", CMS refreshes * quarterly. */ dataAsOf: string | null; /** Nearest first. */ hospitals: medicareHospital[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/medicare/findHospitalsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.medicare.findHospitals({ zip: "19046", radiusMiles: 25, limit: 5 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.medicare.findHospitals({"zip": "19046", "radiusMiles": 25, "limit": 5}))curl -X POST https://api.bowmark.ai/v1/sites/medicare/findHospitals \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":{"zip":"19046","radiusMiles":25,"limit":5}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.medicare.findHospitals({ zip: "19046", radiusMiles: 25, limit: 5 });findNursingHomesReturns the Medicare- and Medicaid-certified nursing homes near a location with the ratings CMS publishes for each.Arguments
Name Type Required zipstring5-digit US ZIP, placed via the Census Bureau's ZCTA centroid.No latitudenumberNo longitudenumberNo radiusMilesnumberStraight-line miles, default 25, max 100.No limitnumberMax facilities returned, default 20. total reports the unlimited count.No Returns
medicareNursingHomeSearchinterface medicareNursingHomeRatings { /** 1-5, or null when CMS publishes none. NEVER render a null as a middling * rating: a null here skews hard toward the WORST facilities, not the unknown * ones, every one of the country's 88 Special Focus Facilities has one. */ overall: number | null; /** CMS's raw footnote code for a null rating (e.g. "18" for a Special Focus * Facility, "1" for too-few-cases / newly certified). Deliberately not mapped * to text: the PDC "Footnote Crosswalk" dataset is the HOSPITAL code set and * its wording for the same numbers is about hospitals. */ overallFootnote: string | null; /** The three components CMS computes `overall` from. They frequently * disagree, and `staffing` is the one tied to resident outcomes, a * five-star overall on a one-star staffing is a real, common combination, so * the rollup alone is a worse answer than the website's. */ healthInspection: number | null; healthInspectionFootnote: string | null; staffing: number | null; staffingFootnote: string | null; qualityMeasures: number | null; qualityMeasuresFootnote: string | null; longStayQualityMeasures: number | null; shortStayQualityMeasures: number | null; } interface medicareNursingHomeStaffing { totalNurseHoursPerResidentDay: number | null; /** Registered-nurse hours per resident per day. The number a family * comparing two facilities is usually actually comparing. */ rnHoursPerResidentDay: number | null; lpnHoursPerResidentDay: number | null; nurseAideHoursPerResidentDay: number | null; /** Weekend coverage, which routinely differs from the weekday figure. */ rnHoursPerResidentDayWeekend: number | null; totalNurseHoursPerResidentDayWeekend: number | null; /** Percent as CMS publishes it, 44.8 means 44.8%. */ totalNursingStaffTurnoverPct: number | null; rnTurnoverPct: number | null; administratorsDepartedLastYear: number | null; } interface medicareNursingHomeEnforcement { /** "SFF" (Special Focus Facility, CMS's designation for persistent serious * problems), "SFF Candidate", or null for neither. Show it WITH the stars. */ specialFocusStatus: string | null; /** Substantiated abuse cited on a recent inspection. */ abuseIcon: boolean; fines: number | null; finesTotalDollars: number | null; /** Denials of Medicare/Medicaid payment for new admissions. */ paymentDenials: number | null; totalPenalties: number | null; /** True when the last standard health inspection is over two years old, i.e. * the inspection ratings are stale, whatever they say. */ healthInspectionOlderThanTwoYears: boolean; } interface medicareNursingHome { /** CMS Certification Number, the id every other CMS nursing-home dataset * (deficiencies, penalties, ownership, MDS quality measures) joins on. */ ccn: string; name: string; legalBusinessName: string | null; address: string; city: string; state: string; zip: string; phone: string | null; county: string | null; latitude: number | null; longitude: number | null; /** Straight-line miles from the search origin, one decimal. */ distanceMiles: number; ownershipType: string | null; certifiedBeds: number | null; averageResidentsPerDay: number | null; /** "Medicare and Medicaid" / "Medicare" / "Medicaid", which programmes * certify it, and therefore who it can admit. */ providerType: string | null; residesInHospital: boolean; continuingCareRetirementCommunity: boolean; changedOwnershipInLast12Months: boolean; chainName: string | null; firstCertified: string | null; ratings: medicareNursingHomeRatings; staffing: medicareNursingHomeStaffing; enforcement: medicareNursingHomeEnforcement; } interface medicareNursingHomeSearch { origin: { zip: string | null; latitude: number; longitude: number; /** "zcta-centroid" (the Census Bureau's centre for the ZIP) or "caller". A * centroid carries real slack in a large rural ZIP. */ source: "zcta-centroid" | "caller"; }; radiusMiles: number; /** Facilities inside the radius before `limit` is applied. */ total: number; /** CMS's own processing date for these rows, the vintage of the Five-Star * data, NOT today. CMS refreshes this dataset monthly. */ dataAsOf: string | null; /** Nearest first. */ homes: medicareNursingHome[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/medicare/findNursingHomesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.medicare.findNursingHomes({ zip: "19046", radiusMiles: 10, limit: 5 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.medicare.findNursingHomes({"zip": "19046", "radiusMiles": 10, "limit": 5}))curl -X POST https://api.bowmark.ai/v1/sites/medicare/findNursingHomes \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":{"zip":"19046","radiusMiles":10,"limit":5}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.medicare.findNursingHomes({ zip: "19046", radiusMiles: 10, limit: 5 });getCostsReturns what Medicare itself costs in a given year.Arguments
None.
Returns
medicareCostsInfointerface medicareCostRow { label: string; detail: string; } interface medicareIrmaaBracket { individualIncome: string; jointIncome: string; /** Literal "Not applicable" for a bracket a separate filer cannot reach, never * coerced to null, which would make it indistinguishable from a missing value. */ marriedSeparateIncome: string; /** Part B publishes a flat total premium ("$284.10"); Part D publishes a * SURCHARGE added to the caller's own plan premium ("$14.50 + your plan * premium"). Kept verbatim on both. */ youPayEachMonth: string; } interface medicarePartCosts { rows: medicareCostRow[]; } interface medicarePartCostsWithIrmaa extends medicarePartCosts { /** The six income-bracket rows CMS publishes for this part. Part B and Part D * only, Part A, Medicare Advantage and Medigap carry no income adjustment. */ irmaa: medicareIrmaaBracket[]; } interface medicareCostsInfo { /** The plan year read off the page's own "What you pay in <year>" header. */ year: number; partA: medicarePartCosts; partB: medicarePartCostsWithIrmaa; medicareAdvantage: medicarePartCosts; partD: medicarePartCostsWithIrmaa; medigap: medicarePartCosts; sourceUrl: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/medicare/getCostsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.medicare.getCosts();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.medicare.getCosts())curl -X POST https://api.bowmark.ai/v1/sites/medicare/getCosts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.medicare.getCosts();getPlanReturns the full detail for one Medicare plan by its CMS contract/plan identifier.Arguments
Name Type Required planType"pdp" | "ma" | "mapd" | "snp""pdp" | "ma" | "mapd" | "snp".Yes contractIdstringCMS's contract id (e.g. "S5884" for Part D, "H1234" for Part C).Yes planIdstringYes segmentIdstringYes yearnumberDefaults to the current calendar year.No zipstring5-digit US ZIP. Required because the API is keyed on (fips, zip).Yes countystringNeeded only for the rare ZIP that crosses a state line.No Returns
medicarePlanDetailinterface medicarePlanDetail { /** CMS's contract-plan-segment triple joined by '-', e.g. "S5884-103-0". */ id: string; name: string; nameSpanish: string | null; organization: string; contractId: string; planId: string; segmentId: string; year: number; /** CMS's own category string: "Medicare Advantage" / "Medicare Advantage with * Prescription Drug Coverage" / "Medicare Prescription Drug Plan" / * "Special Needs Plan". */ category: string; planType: "PLAN_TYPE_PDP" | "PLAN_TYPE_MA" | "PLAN_TYPE_MAPD" | "PLAN_TYPE_SNP"; carrierUrl: string | null; contractYear: string; partcPremium: number; partdPremium: number; partbPremiumReduction: number; /** Annual drug deductible in dollars; 0 means none. PDP only. */ drugPlanDeductible: number | null; /** Annual in-network OOP maximum, verbatim. Empty when not published. */ maximumOopc: string; /** Per-visit cost strings, verbatim. Empty when CMS publishes no figure, * "$0" (a real benefit) and "" (not published) are deliberately distinct. */ primaryDoctorVisitCost: string; specialistDoctorVisitCost: string; emergencyCareCost: string; /** MA/MAPD only, null on PDP, which has no primary/specialist visits. */ primaryDoctorCostSharing: string | null; specialistDoctorCostSharing: string | null; /** 1-5 in half steps, or null when CMS publishes none (with starRatingNote * naming the reason, e.g. "too new to be rated"). */ starRating: number | null; starRatingNote: string | null; lowPerforming: boolean; highPerforming: boolean; /** All false on a PDP, supplemental benefits live on the Part C side. */ supplementalBenefits: { silverSneakers: boolean; transportation: boolean; telehealth: boolean; otcDrugs: boolean; homeSafetyDevices: boolean; inHomeSupport: boolean; supportForCaregivers: boolean; healthEducation: boolean; counselingServices: boolean; emergencyResponseDevice: boolean; worldwideEmergency: boolean; }; providerCoverage: { /** False on plans with no network (e.g. PFFS); providers is then reliably empty. */ hasProviderCoverageData: boolean; providerCount: number; }; /** Extra Help / Low-Income Subsidy dollar amounts at each LIS band. */ lis: { level100: number; level75: number; level50: number; level25: number; }; snpType: string; dsnpIntegrationLevel: string; /** When CMS marks the plan as terminated for the search year. */ terminatedWithoutCrosswalk: string | null; /** Empty when the plan is published in full; the SPA hides fields CMS marks * for redaction and the same fields arrive here. */ redactions: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/medicare/getPlanCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.medicare.getPlan({ planType: "pdp", contractId: "S5884", planId: "103", segmentId: "0", zip: "21201" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.medicare.getPlan({ "planType": "pdp", "contractId": "S5884", "planId": "103", "segmentId": "0", "zip": "21201" }))curl -X POST https://api.bowmark.ai/v1/sites/medicare/getPlan \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"arg0":{"planType":"pdp","contractId":"S5884","planId":"103","segmentId":"0","zip":"21201"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.medicare.getPlan({ planType: "pdp", contractId: "S5884", planId: "103", segmentId: "0", zip: "21201" });searchDrugPlansReturns the standalone Medicare Part D prescription drug plans sold in a ZIP's Part D region.Arguments
Name Type Required arg0{ zip, year, county, limit }Yes Returns
medicareDrugPlanSearchinterface medicareCounty { name: string; fips: string; state: string; } interface medicareDrugPlan { /** CMS's contract-plan-segment triple, e.g. "S5884-103-0". Stable within a plan * year; CMS renumbers across years, so read it with `year`. */ id: string; name: string; organization: string; contractId: string; planId: string; segmentId: string; /** Dollars per month. A 0 is a real price, several carriers sell a * zero-premium basic Part D plan, not a missing value. */ monthlyPremium: number; /** Annual drug deductible in dollars; 0 means none. */ annualDeductible: number; /** CMS's overall star rating (1-5, half steps), or null when CMS publishes * none. A null is NOT a bad rating, `starRatingNote` says why it is absent * (usually "too new to be rated"). */ starRating: number | null; starRatingNote: string | null; lowPerforming: boolean; highPerforming: boolean; carrierUrl: string | null; } interface medicareDrugPlanSearch { zip: string; /** The county actually searched. */ county: medicareCounty; /** Every county the ZIP touches. More than one is common and does not change a * Part D answer, plans are sold by region, and a region never splits a state. */ countiesConsidered: medicareCounty[]; year: number; /** How many plans Medicare.gov reports before `limit` is applied. */ total: number; plans: medicareDrugPlan[]; carriers: { name: string; count: number }[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/medicare/searchDrugPlansCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.medicare.searchDrugPlans({ zip: "21201", limit: 5 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.medicare.searchDrugPlans({"zip": "21201", "limit": 5}))curl -X POST https://api.bowmark.ai/v1/sites/medicare/searchDrugPlans \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"arg0":{"zip":"21201","limit":5}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.medicare.searchDrugPlans({ zip: "21201", limit: 5 });searchMedigapPlansReturns the Medigap (Medicare Supplement) plan TYPES sold in somebody's ZIP's state, each with the insurers selling it, their premium range, their…Arguments
Name Type Required zipstring5-digit US ZIP.Yes planTypestringOmit to fetch every plan type the state offers.No countystringOnly needed for the rare ZIP that crosses a STATE line.No Returns
medicareMedigapSearchinterface medicareCounty { name: string; fips: string; state: string; } interface medicareMedigapDiscountRange { min: number; max: number; } /** How the premium changes with the buyer's age. Attained-age premiums RISE with * age; issue-age and community-rated do not (community additionally moves with * inflation for everyone at once, regardless of age). "unknown" is a real, * intended value, see `ratingMethodRaw` on the policy it appears on, never a * parse failure. */ type medicareMedigapRatingMethod = "attainedAge" | "issueAge" | "communityRated" | "unknown"; interface medicareMedigapPolicy { /** The insurer, exactly as CMS lists it. A parenthetical suffix like * "(Standard I)" is the SAME company selling this plan type under more than one * underwriting tier, each priced separately, do not dedupe by a company name * with the parenthetical stripped. */ company: string; ratingMethod: medicareMedigapRatingMethod; /** CMS's raw rate-type string, kept ONLY when `ratingMethod` is "unknown", a * value CMS started publishing after this mapping was written. Null whenever * `ratingMethod` is one of the three known values. */ ratingMethodRaw: string | null; monthlyRateMin: number; monthlyRateMax: number; address: string; phoneNumber: string; website: string | null; /** A married/related-household discount, when this insurer offers one. Priced * SEPARATELY from `householdDiscountRoommate`, one existing does not imply * the other does. */ householdDiscountStandard: medicareMedigapDiscountRange | null; /** An unrelated-adults-sharing-a-residence discount, priced separately from * `householdDiscountStandard` and frequently absent when that one is present. */ householdDiscountRoommate: medicareMedigapDiscountRange | null; } interface medicareMedigapPlanType { /** CMS's discriminator minus its "MEDIGAP_PLAN_TYPE_" prefix, "A", "HIGH_F", or * a Minnesota/Wisconsin waiver type ("MN_BASIC", "WI_HIGH_DEDUCTIBLE", …). Pass * this back as `searchMedigapPlans`'s `planType` argument to re-fetch just * this one type. */ planType: string; /** The range Medicare.gov reports ACROSS every insurer selling this plan type * here, before picking one. Null means the `planType` filter named a type the * overview did not list as offered here, `policies` is then reliably empty * too, and null is the honest value rather than a fabricated 0. */ monthlyRateMin: number | null; monthlyRateMax: number | null; householdDiscountStandard: medicareMedigapDiscountRange | null; householdDiscountRoommate: medicareMedigapDiscountRange | null; /** Every insurer selling this plan type here. */ policies: medicareMedigapPolicy[]; } interface medicareMedigapSearch { zip: string; /** Resolved from the ZIP, never taken from the caller, Medigap is priced by * state and a wrong one silently returns an empty result rather than an error. */ state: string; county: medicareCounty; countiesConsidered: medicareCounty[]; /** Empty is a real, honest answer for a state/ZIP CMS reports no Medigap market * data for, never a sign this call failed. */ planTypes: medicareMedigapPlanType[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/medicare/searchMedigapPlansCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.medicare.searchMedigapPlans({ zip: "21201", planType: "G" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.medicare.searchMedigapPlans({"zip": "21201", "planType": "G"}))curl -X POST https://api.bowmark.ai/v1/sites/medicare/searchMedigapPlans \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"arg0":{"zip":"21201","planType":"G"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.medicare.searchMedigapPlans({ zip: "21201", planType: "G" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/medicare/<function> - OpenAPI
/v1/sites/medicare/openapi.json