# HealthData.gov MCP for AI Agents AI Agent Connect

> HealthData.gov (HHS Open Data) MCP. Connect your AI agent to the HHS open data portal to query public health, Medicare, and Medicaid datasets. It allows you to browse the catalog and perform deep data analysis using SoQL directly through your AI client.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_9hH9x3I3xYDtuRVdHrNvSKjPXym6qffdCH9gPg6d/ai-agent-connect
- **Tags:** open-data, public-health, datasets, data-query, research, soql

## Description

HealthData.gov provides your AI agent with a direct line to the U.S. Department of Health & Human Services open data. Instead of hunting through messy government portals or downloading massive CSV files that crash your browser, you can just ask your agent to find specific information. You can search the entire HHS ecosystem for datasets on things like hospital capacity, COVID-19 stats, or provider directories. It handles the heavy lifting of Socrata Query Language (SoQL), letting you filter by state, sort by date, or aggregate numbers on the fly. It makes research feel like a conversation rather than a data mining project. Since Vinkius hosts this Connector, you can jump from high-level catalog browsing to granular data extraction in a single interface. It's built for people who need accurate, official numbers without the manual overhead of navigating government websites.

## Tools

### get_catalog
Browse the full list of datasets available on HealthData.gov. This helps you find the right data source before querying.

### query_dataset
Run SoQL queries on a specific dataset to filter, sort, and aggregate data. Use this to get exact records for your research.

## Prompt Examples

**Prompt:** 
```
Find datasets about hospital capacity in the HealthData.gov catalog.
```

**Response:** 
```
I've searched the **HealthData.gov** catalog and found several relevant datasets. Here are the top matches:

* **COVID-19 Reported Patient Impact and Hospital Capacity by State** (ID: 6xf2-c3ie)
* **Hospital Capacity and Bed Availability**
* **State-level Healthcare Infrastructure**

Would you like me to run a specific query on one of these for you?
```

**Prompt:** 
```
Show me the top 5 states with the highest ICU utilization from dataset 6xf2-c3ie.
```

**Response:** 
```
I've queried the dataset for ICU utilization. Here are the top 5 states currently reporting the highest percentages:

| Rank | State | ICU Utilization |
| :--- | :--- | :--- |
| 1 | Alabama | 88.4% |
| 2 | Georgia | 82.1% |
| 3 | Texas | 79.5% |
| 4 | Florida | 77.2% |
| 5 | Mississippi | 76.8% |

Would you like to see the specific raw records for any of these states?
```

**Prompt:** 
```
What are the latest public health metrics for COVID-19?
```

**Response:** 
```
I can pull the latest **COVID-19 public health metrics** from the HHS open data. Based on the most recent updates:

* **Hospitalizations:** Trends are currently being tracked by state.
* **Vaccination Rates:** Available by region and age group.
* **Capacity:** Real-time bed availability is updated weekly.

Which specific metric or state would you like me to dig into further?
```

## Capabilities

### Browse the HHS dataset catalog
Search and list thousands of available datasets and resources across the HHS ecosystem.

### Query specific health datasets
Use SoQL to filter, sort, and aggregate data from specific datasets like hospital capacity.

### Apply precision filtering
Extract specific records using parameters like state or date without downloading large files.

### Fetch real-time metrics
Get the latest updates on public health metrics directly into your chat.

### Perform data aggregation
Summarize large datasets into usable stats using natural language prompts.

## Use Cases

### Tracking ICU Capacity
A researcher asks for the top 5 states with high ICU use. The agent uses query_dataset to sort the results and list them instantly.

### Finding Provider Data
A developer needs to find a list of Medicare providers in a specific zip code to test an app using the query_dataset tool.

### COVID-19 Trend Analysis
A public health official asks for the latest state-level hospital capacity updates for a briefing and gets the data in one prompt.

### Catalog Exploration
A data scientist wants to see what HHS data exists before deciding which one to analyze by using get_catalog.

## Benefits

- Stop downloading huge files by using query_dataset to pull only the records you need.
- Find relevant public health information faster by browsing the catalog with get_catalog.
- Get real-time updates on health metrics without refreshing multiple government tabs.
- Perform complex filtering on Medicare and Medicaid data using natural language prompts.
- Speed up research by letting your agent handle Socrata Query Language (SoQL) syntax.
- Access official HHS data sources directly within your existing AI workflow.

## How It Works

The bottom line is you get instant access to official U.S. health data without manual downloads.

1. Subscribe to this Connector in the Vinkius catalog.
2. Enter your Socrata App Token in your configuration to get higher rate limits.
3. Ask your AI client to find or query specific HHS health data.

## Frequently Asked Questions

**What can I do with the HealthData.gov MCP?**
You can use it to search the official HHS open data catalog and query specific datasets like Medicare, Medicaid, and public health stats using natural language.

**Can the HealthData.gov MCP access private patient records?**
No, this Connector only provides access to public, aggregated health data provided by the Department of Health & Human Services.

**How do I use the HealthData.gov MCP to find Medicare data?**
Simply ask your AI client to search the catalog for Medicare-related datasets and then ask it to query specific records using your preferred filters.

**Does the HealthData.gov MCP require a subscription?**
The Connector is available through Vinkius. You can also optionally provide a Socrata App Token to increase your query rate limits.

**Can I filter specific states using the HealthData.gov MCP?**
Yes, you can ask your agent to filter data by any state, region, or specific parameter using natural language.

**Is the HealthData.gov MCP good for data science research?**
It's excellent for researchers who need to quickly prototype queries and fetch specific subsets of official health data for analysis.

**How do I find a specific dataset about 'Medicare'?**
Use the `get_catalog` tool and provide 'Medicare' in the `q` parameter. This will return a list of relevant datasets along with their unique identifiers (dataset_id).

**Can I filter results to only show data from a specific state?**
Yes! When using `query_dataset`, use the `$where` parameter with a SoQL filter like `state='NY'`. You can also use `$select` to pick specific columns.

**Is an API key required to access this data?**
No, the data is public. However, providing a `HEALTHDATA_APP_TOKEN` is recommended for higher rate limits if you plan to perform many queries.