HealthCare.gov MCP server for AI agents
Let Claude, ChatGPT or your own agent read HealthCare.gov: 9 typed functions through one MCP server. No HealthCare.gov API key needed.
- Site
- healthcare.gov
- Functions
- 9
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for HealthCare.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/healthcare_govOne MCP server for HealthCare.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.
checkDrugCoverageWhich of a household's available ACA Marketplace plans cover a specific prescription drug.Arguments
Name Type Required arg0{ drug, zip, income, people, year, countyfips, limit, planIds }Yes Returns
{ drug: healthcare_govDrug; otherMatches: healthcare_govDrug[]; county: healthcare_govCounty | null; otherCounties: healthcare_govCounty[]; year: number; total: number | null; cheapestCovering: healthcare_govDrugPlanCoverage | null; plans: healthcare_govDrugPlanCoverage[] }interface healthcare_govCounty { name: string; /** 5-digit FIPS code. */ fips: string; state: string; } interface healthcare_govDrug { /** RxNorm concept unique identifier, the id every drug read here is keyed on. */ rxcui: string; /** Brand or generic name as the Marketplace prints it, e.g. "LIPITOR". */ name: string; /** e.g. "20 mg", "100 mg/ml". Coverage differs by strength. */ strength: string; /** How it is taken, in the Marketplace's words: "Oral Pill", "Injectable". */ route: string; /** RxNorm's full description, e.g. "atorvastatin 20 MG Oral Tablet [Lipitor]". */ fullName: string; doseForm: string; } /** `covered`, on the plan's formulary. `genericOnly`, this drug is NOT, but a * generic equivalent is. `notCovered`, neither is. `unknown`, the issuer * published no formulary data for this plan, which is NOT a soft no. */ type healthcare_govDrugCoverageStatus = "covered" | "genericOnly" | "notCovered" | "unknown"; interface healthcare_govDrugPlanCoverage { /** HIOS plan id. */ planId: string; /** Null on the `planIds` route, where no search page named the plan. */ planName: string | null; issuer: string | null; /** Null on the `planIds` route, the premium is priced by the plan search. */ premium: number | null; /** After the credit. 0 is a real answer at low incomes, never a missing one. */ premiumWithCredit: number | null; status: healthcare_govDrugCoverageStatus; /** The generic equivalent this plan covers instead, resolved from the bare * RxCUI the Marketplace returns to a real named drug. Only populated on * `genericOnly`. */ generic: { drug: healthcare_govDrug } | null; /** The plan's formulary document, the ONLY place the tier, the copay and any * prior-authorization or step-therapy requirement are written down. The * Marketplace's API publishes none of those. */ formularyUrl: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/healthcare_gov/checkDrugCoverageCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.healthcare_gov.checkDrugCoverage({ drug: "Lipitor 20 mg", zip: "78701", income: 52000, people: [{ age: 35 }], limit: 10 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.healthcare_gov.checkDrugCoverage({ "drug": "Lipitor 20 mg", "zip": "78701", "income": 52000, "people": [{"age": 35}], "limit": 10 }))curl -X POST https://api.bowmark.ai/v1/sites/healthcare_gov/checkDrugCoverage \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"arg0":{"drug":"Lipitor 20 mg","zip":"78701","income":52000,"people":[{"age":35}],"limit":10}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.healthcare_gov.checkDrugCoverage({ drug: "Lipitor 20 mg", zip: "78701", income: 52000, people: [{ age: 35 }], limit: 10 });checkEnrollmentEligibilityReturns whether somebody can enrol in Marketplace coverage right now and until when.Arguments
Name Type Required zipstringFive-digit US ZIP.Yes lifeEventOnstringA life change's date, ISO YYYY-MM-DD.No lifeEventCategorystringWhich published category it was, e.g. "Moved to a new home".No asOfstringEvaluate against this date instead of today, ISO YYYY-MM-DD.No Returns
healthcare_govEnrollmentEligibilityinterface healthcare_govLifeEventCategory { category: string; windows: { direction: "past" | "next"; days: number }[]; examples: string[]; } interface healthcare_govOpenEnrollment { /** HealthCare.gov's own flag, not arithmetic over the dates below. */ isOpen: boolean; coversPlanYear: number; startsOn: string; endsOn: string; daysLeft: number | null; daysUntilOpen: number | null; } interface healthcare_govSepAssessment { eventOn: string; qualifies: boolean; matches: { category: string; direction: "past" | "next"; windowDays: number; /** Last day this category's window can still be used, ISO `YYYY-MM-DD`. */ windowEndsOn: string; daysLeft: number; }[]; } interface healthcare_govMarketplace { /** CMS's own code: `FFM`, `SBM`, `SupportedSBM`, `UnknownMarketplaceModel`. */ model: string; name: string | null; url: string | null; /** Whether HealthCare.gov itself can enrol this ZIP. */ servesThisZip: boolean; } interface healthcare_govEnrollmentEligibility { zip: string; county: string; countyFips: string; state: string; stateName: string; planYear: number; marketplace: healthcare_govMarketplace; openEnrollment: healthcare_govOpenEnrollment; qualifyingLifeEvents: healthcare_govLifeEventCategory[]; specialEnrollmentPeriod: healthcare_govSepAssessment | null; /** False means "no window from the calendar or this life change", NOT "no * coverage available". Income-based Medicaid/CHIP and Tribal membership are * open all year and are not assessed here. */ canEnrollNow: boolean; asOf: string; } // Find Local Help, who near a ZIP can sit down with somebody and enrol them.HTTP endpoint
POST https://api.bowmark.ai/v1/sites/healthcare_gov/checkEnrollmentEligibilityCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.healthcare_gov.checkEnrollmentEligibility({ zip: "78701", lifeEventOn: { $daysFromNow: -21 } });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.healthcare_gov.checkEnrollmentEligibility({"zip": "78701", "lifeEventOn": {"$daysFromNow": -21}}))curl -X POST https://api.bowmark.ai/v1/sites/healthcare_gov/checkEnrollmentEligibility \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":{"zip":"78701","lifeEventOn":{"$daysFromNow":-21}}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.healthcare_gov.checkEnrollmentEligibility({ zip: "78701", lifeEventOn: { $daysFromNow: -21 } });checkProviderCoverageReturns which of a household's available Marketplace plans have a specific doctor, hospital or facility in network.Arguments
Name Type Required arg0{ provider, zip, providerType, income, people, year, countyfips, limit, planIds }Yes Returns
{ provider: healthcare_govProvider; county: healthcare_govCounty | null; otherCounties: healthcare_govCounty[]; year: number; total: number | null; cheapestCovering: healthcare_govProviderPlanCoverage | null; plans: healthcare_govProviderPlanCoverage[] }interface healthcare_govCounty { name: string; /** 5-digit FIPS code. */ fips: string; state: string; } interface healthcare_govAddress { street1: string; street2: string; city: string; state: string; zip: string; phone: string | null; } interface healthcare_govProvider { /** National Provider Identifier, the id every coverage read here is keyed on. */ npi: string; name: string; /** `Individual` (a person) or `Facility` (a hospital, clinic or pharmacy), * the Marketplace's own two words, and what its `type` filter takes. */ providerType: string; /** Populated for an Individual, "Emergency Medicine", "Physician Assistant". */ specialties: string[]; /** Populated for a Facility, "ACH" (acute care hospital), "Retail Pharmacy". */ facilityTypes: string[]; taxonomy: string; gender: string; languages: string[]; /** Where the directory search found them. Null on the NPI route, which takes * no location. */ address: healthcare_govAddress | null; distanceMiles: number | null; } /** `covered`, in network. `notCovered`, not. `unknown`, the issuer published * no provider-network data for this plan at all, which is NOT a soft no: the * Marketplace's own front end renders it as a warning rather than as an absence * of cover. */ type healthcare_govProviderCoverageStatus = "covered" | "notCovered" | "unknown"; interface healthcare_govProviderPlanCoverage { /** HIOS plan id. */ planId: string; /** Null on the `planIds` route, where no search page named the plan. */ planName: string | null; issuer: string | null; /** Null on the `planIds` route, a premium is priced against a household, and * that route has none to price against. */ premium: number | null; premiumWithCredit: number | null; /** The plan's own provider directory, the only place its network is written * down in full, and the analog of `formularyUrl` on a drug row. */ networkUrl: string | null; status: healthcare_govProviderCoverageStatus; /** Whether the provider takes new patients under THIS plan. Read it before * choosing: `covered` + `notAccepting` is a plan whose in-network doctor will * not see you. */ accepting: "accepting" | "notAccepting" | "unknown"; /** The provider's locations that are in network UNDER THIS PLAN, not their * whole address list. Empty whenever the plan does not cover them. */ inNetworkAddresses: healthcare_govAddress[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/healthcare_gov/checkProviderCoverageCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.healthcare_gov.checkProviderCoverage({ provider: "Kevin Mcdonald Smith", zip: "78701", providerType: "Individual", income: 52000, people: [{ age: 35 }], limit: 10 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.healthcare_gov.checkProviderCoverage({ "provider": "Kevin Mcdonald Smith", "zip": "78701", "providerType": "Individual", "income": 52000, "people": [{"age": 35}], "limit": 10 }))curl -X POST https://api.bowmark.ai/v1/sites/healthcare_gov/checkProviderCoverage \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"arg0":{"provider":"Kevin Mcdonald Smith","zip":"78701","providerType":"Individual","income":52000,"people":[{"age":35}],"limit":10}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.healthcare_gov.checkProviderCoverage({ provider: "Kevin Mcdonald Smith", zip: "78701", providerType: "Individual", income: 52000, people: [{ age: 35 }], limit: 10 });estimateEligibilityReturns what a household actually qualifies for before it shops.Arguments
Name Type Required arg0{ zip, income, people, year, countyfips }Yes Returns
healthcare_govEligibilityEstimate/** One person's slice of an eligibility estimate. Only `medicaidChip` is * genuinely per-person; `age` and `relationship` are echoed back from the * request so a caller can tell WHICH person each verdict is about. */ interface healthcare_govEligibilityPerson { age: number; /** `Self`, `Spouse`, `Child`, …, as sent, or as defaulted by age. */ relationship: string; /** CMS's estimate that THIS person qualifies for Medicaid or CHIP instead of a * subsidised Marketplace plan. It really does split within one household: * children reach CHIP at incomes well above the adult Medicaid line. */ medicaidChip: boolean; } interface healthcare_govEligibilityEstimate { /** The county the estimate was priced for, a ZIP can straddle two, and which * one was used is never left silent. */ county: { name: string; fips: string; state: string }; zip: string; year: number; /** The annual household income it was computed FROM, echoed back. */ income: number; /** Monthly advance premium tax credit FOR THE WHOLE HOUSEHOLD, in dollars, * NOT per person. A caller summing a per-person list would report four times * the real credit, which is why this is one field. `0` is a real answer. */ monthlyAptc: number; /** Which cost-sharing-reduction variant applies, in CMS's own words * (`"87% AV Level Silver Plan CSR"`). Null when none does. */ csr: string | null; /** CMS's own hardship-exemption flag, passed through rather than re-derived. */ hardshipExemption: boolean; /** Income too low for a premium tax credit, in a state that did not expand * Medicaid, so neither route is open. The field that makes this estimate worth * calling: the identical household at $15,000 is `inCoverageGap` in Texas and * `medicaidChip` in Ohio. */ inCoverageGap: boolean; /** One row per person sent, in the order they were sent. */ people: healthcare_govEligibilityPerson[]; /** How many of them CMS estimates into Medicaid or CHIP. `0` and * `people.length` are both ordinary; anything between is the split case. */ medicaidChipCount: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/healthcare_gov/estimateEligibilityCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.healthcare_gov.estimateEligibility({ zip: "78701", income: 30000, people: [{ age: 35 }] });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.healthcare_gov.estimateEligibility({"zip": "78701", "income": 30000, "people": [{"age": 35}]}))curl -X POST https://api.bowmark.ai/v1/sites/healthcare_gov/estimateEligibility \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"arg0":{"zip":"78701","income":30000,"people":[{"age":35}]}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.healthcare_gov.estimateEligibility({ zip: "78701", income: 30000, people: [{ age: 35 }] });estimateOutOfPocketCostsReturns the estimated TOTAL yearly cost of a plan for a household.Arguments
Name Type Required arg0{ zip, income, people, year, countyfips, limit }Yes Returns
{ county: healthcare_govCounty; year: number; total: number; plans: healthcare_govPlanCostEstimate[]; cheapest: { byMonthlyPremium: string; byYearlyCost: string; samePlan: boolean } | null }interface healthcare_govCounty { name: string; /** 5-digit FIPS code. */ fips: string; state: string; } interface healthcare_govCostEstimate { /** CMS's estimated out-of-pocket spend for the year, deductible, copays and * coinsurance, NOT premiums. Null when the Marketplace computed none for this * plan, rather than a zero that would read as "free to use". */ outOfPocket: number | null; /** The whole year: twelve after-credit premiums plus outOfPocket. This is the * figure HealthCare.gov itself shows as "Your estimated yearly cost". */ totalYearly: number | null; } interface healthcare_govPlanCostEstimate { /** HIOS plan id, joins back to searchPlans. */ id: string; name: string; issuer: string; metalLevel: string; planType: string; /** Monthly premium AFTER the advance premium tax credit. */ monthlyPremium: number; yearlyPremium: number; /** The ceiling the "high" estimate runs into: a plan whose high.outOfPocket * equals this is capped here rather than genuinely estimated that low. */ outOfPocketMax: number | null; estimates: { low: healthcare_govCostEstimate; medium: healthcare_govCostEstimate; high: healthcare_govCostEstimate; }; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/healthcare_gov/estimateOutOfPocketCostsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.healthcare_gov.estimateOutOfPocketCosts({ zip: "78701", income: 52000, people: [{ age: 35 }], limit: 3 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.healthcare_gov.estimateOutOfPocketCosts({ "zip": "78701", "income": 52000, "people": [{"age": 35}], "limit": 3 }))curl -X POST https://api.bowmark.ai/v1/sites/healthcare_gov/estimateOutOfPocketCosts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"arg0":{"zip":"78701","income":52000,"people":[{"age":35}],"limit":3}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.healthcare_gov.estimateOutOfPocketCosts({ zip: "78701", income: 52000, people: [{ age: 35 }], limit: 3 });findLocalHelpReturns the in-person help available near a ZIP.Arguments
Name Type Required arg0{ zip, radiusMiles, types, limit }Yes Returns
healthcare_govLocalHelpResultinterface healthcare_govHelperAddress { street: string[]; city: string; state: string; zip: string; latitude: number | null; longitude: number | null; /** Whether somebody can turn up without an appointment. */ walkInsWelcome: boolean; accessibleLocation: boolean; /** The directory's own note on finding the place. Null when blank. */ note: string | null; } interface healthcare_govHelperHours { /** `mon` … `sun`. */ day: string; /** `HH:MM:SS`, local to the helper's `timezone`. */ opensAt: string; closesAt: string; appointmentRequired: boolean; } interface healthcare_govLocalHelper { id: number; name: string; /** The organisation they work under, when the directory names one. */ organisation: string | null; /** TRUE = an agent or broker, paid by commission, selling only the plans they * carry. FALSE = an assister, certified by CMS and REQUIRED to give fair, * impartial, accurate information about every Marketplace plan. This is the * field that decides whether the help is free and impartial. */ isAgentOrBroker: boolean; /** The directory's own labels, verbatim, `Agent/Broker (ABA)`, `Certified * Application Counselor (CAC)`, … */ helperTypes: string[]; /** Miles from the searched ZIP. Null on a statewide listing. */ distanceMiles: number | null; address: healthcare_govHelperAddress; /** Digits as published, no reformatting, because the directory mixes formats. */ phones: string[]; emails: string[]; websites: string[]; /** `English`, `Spanish`, … in the directory's own words. */ languages: string[]; hours: healthcare_govHelperHours[]; timezone: string | null; /** Null when unreported, never 0, which would read as "brand new". */ yearsOfService: number | null; /** Every state they are licensed to serve. More than one is common for a * broker, and is why a nearby result is not necessarily a local one. */ statesServed: string[]; accessibilityServices: string[]; /** The directory's own contact-card download for this helper. */ vcardUrl: string; } interface healthcare_govLocalHelpResult { zip: string; /** What the geocoder resolved the ZIP to. */ city: string; state: string; searchedFrom: { latitude: number; longitude: number }; radiusMiles: number; /** Everyone matching inside the radius, across every page, not how many rows * this call returned. */ total: number; /** The split of `total`. Read it before the rows: the default ordering is by * distance and is dominated by brokers. */ totalAgentsAndBrokers: number; totalAssisters: number; hasMore: boolean; helpers: healthcare_govLocalHelper[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/healthcare_gov/findLocalHelpCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.healthcare_gov.findLocalHelp({ zip: "78701", types: ["assister"], radiusMiles: 50 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.healthcare_gov.findLocalHelp({"zip": "78701", "types": ["assister"], "radiusMiles": 50}))curl -X POST https://api.bowmark.ai/v1/sites/healthcare_gov/findLocalHelp \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"arg0":{"zip":"78701","types":["assister"],"radiusMiles":50}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.healthcare_gov.findLocalHelp({ zip: "78701", types: ["assister"], radiusMiles: 50 });getPlanReturns the full detail for one Marketplace plan by its HIOS plan id.Arguments
Name Type Required arg0{ id, year }Yes Returns
healthcare_govPlanDetail/** What one benefit costs on one network tier. `copay` and `coinsuranceRate` * are nullable rather than 0 because the Marketplace publishes both keys on * every row and marks the inapplicable one `Not Applicable`, reading the * padding 0 as "0% coinsurance" would report a $100-copay plan as covering * specialists in full. `display` is CMS's own rendering and the authority. */ interface healthcare_govBenefitCostSharing { /** `In-Network` or `Out-of-Network`. */ networkTier: string; /** Flat dollar copay, or null when expressed as coinsurance. */ copay: number | null; /** Member's share, 0-1 (0.5 = 50%), or null when expressed as a copay. A rate * of 1 with `display` "Not Covered" means you pay all of it. */ coinsuranceRate: number | null; /** e.g. `$100`, `50% Coinsurance after deductible`, `No Charge`, `Not Covered`. */ display: string; /** True when the plan pays this BEFORE the deductible is met (CMS's `BBD`), * what decides whether a $7,500 deductible stands in front of a routine visit. */ beforeDeductible: boolean; } interface healthcare_govBenefit { /** CMS's own code, e.g. `SPECIALIST_VISIT`. Stable across issuers and years, * so match on this rather than on `name`. */ type: string; name: string; /** Read this BEFORE the cost sharing, an uncovered benefit still carries a * cost-sharing row. */ covered: boolean; costSharing: healthcare_govBenefitCostSharing[]; explanation: string | null; exclusions: string | null; /** e.g. 30 `visits per year`. Null when the plan publishes no limit, and also * when it flags a limit but describes it in `exclusions` prose instead of a * number, "0 of nothing" would read as "capped at zero". */ limit: { quantity: number; unit: string } | null; } /** A cost figure published per household size. All nullable: a plan publishes * only the tiers it offers. */ interface healthcare_govCostTier { individual: number | null; family: number | null; /** The per-person cap INSIDE a family policy, lower than `family`, and what * one person on a family plan actually hits first. */ familyPerPerson: number | null; } interface healthcare_govDeductibleDetail { combined: healthcare_govCostTier | null; medical: healthcare_govCostTier | null; drug: healthcare_govCostTier | null; } /** CMS's standard Summary of Benefits scenario, costed for this plan. */ interface healthcare_govCoverageExample { copay: number; coinsurance: number; deductible: number; /** Cost falling outside covered benefits. */ limit: number; } interface healthcare_govQualityRating { /** Overall, 1-5, or null when not rated. Never 0. */ global: number | null; /** Why `global` is null, in CMS's words. */ notRatedReason: string | null; clinicalQualityManagement: number | null; enrolleeExperience: number | null; planEfficiency: number | null; } interface healthcare_govPlanDetail { /** HIOS plan id. */ id: string; name: string; issuer: string; issuerId: string; metalLevel: string; /** HMO | PPO | EPO | POS. */ planType: string; /** Which cost-sharing variant every figure below belongs to, in CMS's words, * effectively always `Exchange variant (no CSR)`, because no household is * supplied. A household that qualifies for cost-sharing reductions pays LESS * than these figures; `searchPlans` is where its real numbers come from. */ costSharingVariant: string | null; benefits: healthcare_govBenefit[]; deductible: healthcare_govDeductibleDetail; outOfPocketMax: healthcare_govCostTier | null; qualityRating: healthcare_govQualityRating; /** Keyed by CMS's own scenario names (`baby`, `diabetes`, `fracture`). */ coverageExamples: Record<string, healthcare_govCoverageExample>; hsaEligible: boolean; hasNationalNetwork: boolean; specialistReferralRequired: boolean; specialistReferralText: string | null; standardizedPlan: boolean; rxThreeMonthMailOrder: boolean; benefitsUrl: string | null; networkUrl: string | null; brochureUrl: string | null; formularyUrl: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/healthcare_gov/getPlanCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.healthcare_gov.getPlan({ id: "71837TX0010020" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.healthcare_gov.getPlan({"id": "71837TX0010020"}))curl -X POST https://api.bowmark.ai/v1/sites/healthcare_gov/getPlan \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"arg0":{"id":"71837TX0010020"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.healthcare_gov.getPlan({ id: "71837TX0010020" });searchDentalPlansReturns the STANDALONE dental plans a household can buy on the ACA Marketplace for a ZIP and household makeup, cheapest premium first, each with its…Arguments
Name Type Required arg0{ zip, people, year, countyfips, limit }Yes Returns
{ county: healthcare_govCounty; otherCounties: healthcare_govCounty[]; year: number; total: number; plans: healthcare_govDentalPlan[] }interface healthcare_govCounty { name: string; /** 5-digit FIPS code. */ fips: string; state: string; } interface healthcare_govDentalPlan { /** HIOS plan id. */ id: string; name: string; issuer: string; issuerId: string; /** `High` or `Low`, dental's own two-tier scale, NOT the Bronze/Silver/Gold * metal levels a medical plan carries. */ coverageLevel: string; /** HMO | PPO | EPO | POS. */ planType: string; premium: number; orthodontia: { child: boolean | null; adult: boolean | null }; /** Every benefit the plan declares, in CMS's own vocabulary, routine, basic * and major dental care for adults and children, orthodontia, accidental * dental. */ benefits: { name: string; covered: boolean; explanation: string | null }[]; /** How long before the plan starts paying, in the issuer's words, or null for * no waiting period. */ waitingPeriod: string | null; /** The age a child ages off this plan. */ maxChildAge: number | null; /** CMS's "Medical EHB Deductible". On a standalone dental plan the essential * health benefit is the PEDIATRIC dental benefit, so this is a pediatric * figure and not what an adult pays before cover starts. Read it with * `brochureUrl`, not instead of it. */ ehbDeductible: number | null; /** "Maximum Out of Pocket for Medical EHB Benefits", same pediatric caveat. * NOT the plan's annual maximum benefit, the Marketplace does not publish * that number machine-readably anywhere; it is in the brochure. */ ehbOutOfPocketMax: number | null; hasNationalNetwork: boolean; /** The Summary of Benefits, the one place the annual maximum, per-service * coinsurance and any waiting period are actually written down. */ brochureUrl: string | null; benefitsUrl: string | null; networkUrl: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/healthcare_gov/searchDentalPlansCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.healthcare_gov.searchDentalPlans({ zip: "78701", people: [{ age: 35 }], limit: 10 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.healthcare_gov.searchDentalPlans({"zip": "78701", "people": [{"age": 35}], "limit": 10}))curl -X POST https://api.bowmark.ai/v1/sites/healthcare_gov/searchDentalPlans \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"arg0":{"zip":"78701","people":[{"age":35}],"limit":10}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.healthcare_gov.searchDentalPlans({ zip: "78701", people: [{ age: 35 }], limit: 10 });searchPlansReturns the ACA Marketplace health plans available to a household.Arguments
Name Type Required arg0{ zip, income, people, year, countyfips, limit }Yes Returns
{ county: healthcare_govCounty; otherCounties: healthcare_govCounty[]; year: number; total: number; plans: healthcare_govPlan[] }interface healthcare_govPlan { /** HIOS plan id, the identifier every other read on this site is keyed on. */ id: string; name: string; issuer: string; issuerId: string; /** Bronze | Silver | Gold | Platinum | Catastrophic. */ metalLevel: string; /** HMO | PPO | EPO | POS. */ planType: string; /** Monthly premium BEFORE the advance premium tax credit. */ premium: number; /** Monthly premium AFTER the credit this household qualifies for. Equals * premium when the household is not APTC-eligible; 0 when the credit covers * the whole premium, which is a real answer at low incomes. */ premiumWithCredit: number; /** What the household pays before cost sharing starts. Three fields because * the Marketplace publishes two shapes: most plans combine medical and drug * into one deductible, a minority split them, and reading only the first * would report "$0 deductible" for a plan with a $4,500 drug deductible. */ deductible: { combined: number | null; medical: number | null; drug: number | null; /** Which cost-sharing-reduction variant these figures are for, the API * resolves it against the household, so two households see different * numbers for the same plan id. */ csr: string | null; }; /** In-network maximum out-of-pocket for the year, or null if unpublished. */ outOfPocketMax: number | null; hsaEligible: boolean; hasNationalNetwork: boolean; specialistReferralRequired: boolean; /** CMS global quality rating, 1-5 stars, or null when not rated. Never 0. */ qualityRating: number | null; /** Why the rating is null, in CMS's words (e.g. "New-Ineligible for * Scoring"). Null when the plan IS rated. */ qualityRatingNote: string | null; benefitsUrl: string | null; networkUrl: string | null; } interface healthcare_govCounty { name: string; /** 5-digit FIPS code. */ fips: string; state: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/healthcare_gov/searchPlansCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.healthcare_gov.searchPlans({ zip: "78701", income: 52000, people: [{ age: 35 }], limit: 10 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.healthcare_gov.searchPlans({ "zip": "78701", "income": 52000, "people": [{"age": 35}], "limit": 10 }))curl -X POST https://api.bowmark.ai/v1/sites/healthcare_gov/searchPlans \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"arg0":{"zip":"78701","income":52000,"people":[{"age":35}],"limit":10}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.healthcare_gov.searchPlans({ zip: "78701", income: 52000, people: [{ age: 35 }], limit: 10 });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/healthcare_gov/<function> - OpenAPI
/v1/sites/healthcare_gov/openapi.json