# HealthCare.gov MCP MCP

> HealthCare.gov MCP gives your AI client direct access to the official HealthCare.gov Marketplace data. You can search for health plans, check drug coverage against specific policies, and verify if doctors or hospitals are in network—all through natural conversation. It automates complex ACA research tasks that used to require navigating multiple government portals.

## Overview
- **Category:** government-public-data
- **Price:** Free
- **Tags:** aca-plans, health-insurance, provider-network, drug-coverage, public-data, marketplace-api

## Description

Handling health plan research shouldn't feel like a full-time job. This MCP connects your AI client directly to the core data of the HealthCare.gov Marketplace, letting you ask detailed questions and get immediate answers. Instead of manually filtering through endless tabs for plans or providers, you just talk to your agent about what you need—like finding all available dental coverage options in a specific ZIP code or checking if a parent's medication is covered by an existing plan. It handles the messy details, like figuring out county codes first so it can give accurate pricing data. Connecting this MCP through Vinkius means you get full control over everything from listing insurance companies operating in a state to analyzing how coverage changes year-to-year. You stop wasting time on tedious manual portal searches and start getting actionable health plan intelligence.

## Tools

### get_counties_by_zip
Looks up the official county codes needed for a specific ZIP code.

### get_plan_crosswalk
Provides details on how health plans change or transition between different enrollment years.

### get_drug_coverage
Checks if any given medication is covered by a specified insurance plan.

### get_api_metadata
Pulls general information about the Marketplace API data structure.

### get_plan_details
Retrieves detailed, specific information about a particular health plan.

### get_provider_coverage
Verifies if a healthcare provider is in-network for a specific insurance policy.

### list_issuers
Lists all the main insurance companies operating within an entire state.

### list_market_states
Provides a list of states that are currently served by the Marketplace.

### search_drugs
Searches the database for information on specific medications.

### search_plans
Finds health and dental plans based on household size, demographics, and location data.

### search_providers
Searches for healthcare providers like doctors or facilities in a given area.

## Prompt Examples

**Prompt:** 
```
Search for health plans in ZIP code 22102.
```

**Response:** 
```
I've started the search for ZIP 22102. I first need to retrieve the County FIPS code for this area. It belongs to Fairfax County (FIPS: 51059). Should I now proceed to list available Silver plans for a 30-year-old individual?
```

**Prompt:** 
```
Check if 'Lipitor' is covered by plan ID 12345VA001.
```

**Response:** 
```
Checking drug coverage... I found 'Atorvastatin' (Generic Lipitor) in the database. For plan 12345VA001, it is covered as a Tier 1 (Generic) drug with a $10 copay. Would you like to check any other medications?
```

**Prompt:** 
```
List all insurance companies operating in Virginia.
```

**Response:** 
```
Accessing issuer data... In Virginia (VA), there are 8 main issuers operating in the Marketplace, including 'Anthem Health', 'CareFirst BlueCross BlueShield', and 'Kaiser Permanente'. Would you like to see the available plan counts for each?
```

## Capabilities

### Find Available Health Plans
Search for health or dental plans using household demographics and a location to see what options are available.

### Verify Drug Coverage Status
Check if a specific medication is covered by a particular insurance plan and at what cost tier.

### Confirm Provider Network Status
Search for doctors, hospitals, or facilities and confirm whether they accept a given plan.

### Map Location Data
Retrieve the necessary county codes from a ZIP code to ensure pricing and regional data are accurate.

### List State Issuers
Get a list of all insurance companies that operate within a specific state.

## Use Cases

### A new family needs coverage.
The agent first uses `get_counties_by_zip` to confirm location codes. It then runs `search_plans` using household details and the ZIP code, delivering a curated list of available plans tailored exactly to their situation.

### A client has an existing condition.
Instead of searching general plan info, you ask: 'Is Drug X covered by Plan Y?' The agent uses `get_drug_coverage` and replies with the specific tier status and copay amount.

### A patient needs a specialist.
You simply tell your agent the ZIP code and specialty. It runs `search_providers` to find local doctors, then uses `get_provider_coverage` to confirm that they accept the required insurance.

### A consultant needs a state overview.
You ask for all carriers in Texas. The agent executes `list_issuers`, providing an instant list of every major insurer operating there, allowing you to quickly assess market density.

## Benefits

- You eliminate the manual work of cross-referencing state portals. By using `search_plans`, your agent automatically handles location coding and demographic inputs to give you immediate plan options for any given ZIP code.
- Never guess about coverage again. Using `get_drug_coverage` lets you check if a specific medication is covered by an existing policy, including knowing the copay tier upfront.
- Stop worrying about network gaps. If you use `get_provider_coverage`, your agent confirms in real-time whether a doctor or facility actually accepts the client's plan before they make an appointment.
- Track changes without getting lost. The `get_plan_crosswalk` tool helps you understand how coverage requirements shift between enrollment years, which is crucial for advising clients.
- Get a full market view: You can use `list_issuers` to list all major insurance companies in a state, giving your client a complete picture of the local competition.

## How It Works

The bottom line is, your AI client acts like a dedicated benefits specialist for ACA research, automating multi-step queries into one conversation.

1. First, connect your AI client to this MCP and provide the required Marketplace API Key.
2. Next, describe your goal in plain English—for example, 'I need to find plans for a family of four in zip code 90210.'
3. Your agent runs the necessary tools sequentially (like getting county codes first) and provides you with a verified list of plan options or coverage details.

## Frequently Asked Questions

**How do I obtain a HealthCare.gov API Key?**
You must request a free API key through the **CMS Marketplace API** portal (developer.cms.gov/marketplace-api). Keys are typically sent via email and must be renewed every 60 days.

**Can I check if my doctor is in-network for a specific plan?**
Yes! Use the `get_provider_coverage` tool by providing the plan ID and the provider ID. The agent will confirm the network status for that specific combination.

**What geographic information is required for plan searches?**
Most searches require a 5-digit ZIP code and a 5-digit County FIPS code. You can use the `get_counties_by_zip` tool to retrieve the FIPS code for any ZIP code.

**Is the integration secure for searching health data?**
Absolutely. The integration uses official CMS API keys over HTTPS. Your credentials are encrypted and stored securely within the Vinkius Cloud infrastructure.

**How does using the `get_plan_crosswalk` tool help me track coverage changes over time?**
It gives you specific information on how a plan transitions between enrollment years. This is crucial for comparing year-over-year benefits and ensuring continuity of care, which isn't available through simple current searches.

**Should I run `get_api_metadata` first to understand the full scope of data I can query?**
Yes. Running this metadata call confirms the exact fields and parameters you can use in subsequent calls. It helps prevent wasted queries and ensures your agent knows the API's capabilities upfront.

**What is the correct workflow for checking drug coverage using `search_drugs`?**
First, run `search_drugs` to locate the medication's official database ID. Then, you pass that specific ID along with the plan details when verifying coverage.

**What should my agent do if it hits rate limits while using `list_issuers`?**
The API will return a standard HTTP 429 error. Your client must be programmed to implement an exponential backoff strategy, waiting progressively longer between retries.