How to Use the HealthData.gov (HHS Open Data) MCP in Claude Code

Q: How can I use Claude Code to monitor HealthData.gov (HHS Open Data) for updates?

You can write a shell script that uses getcatalog to fetch a dataset's metadata, then check the lastupdated field. Run this script as a cron job to get notified when new data is published.

Q: Can I pipe data from HealthData.gov (HHS Open Data) into other CLI tools with Claude Code?

Yes. The output of the querydataset tool is JSON. You can pipe it directly to tools like jq for filtering, awk for processing, or upload it somewhere with a tool like curl.

Q: How do I configure Claude Code to use the HealthData.gov (HHS Open Data) server?

Run claude mcp add --transport http health-hhs -- in your terminal, replacing with the Vinkius endpoint. This single command connects the client, and the tools are ready to use instantly.

Q: Is there a limit to how much data I can pull?

The querydataset tool respects the pagination limits of the underlying HealthData.gov API, which is typically 1000 records per request. For larger datasets, you'll need to script your calls to use the $limit and $offset SoQL parameters to page through all the data.

Pipe HealthData.gov metrics into your CI/CD pipelines and shell scripts using Claude Code.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect HealthData.gov (HHS Open Data) MCP to Claude Code

Create your Vinkius account to connect HealthData.gov (HHS Open Data) to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup HealthData.gov (HHS Open Data) with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Headless Dataset Discovery

The `get_catalog` tool lets you find HealthData.gov dataset IDs right from the command line. You don't need a browser. Just run a command to search for a term like 'hospital ratings' and pipe the output to `jq` to extract the ID you need for the next step. This is perfect for scripting. You can build tools that dynamically find datasets based on keywords, making your automation more resilient to changes in data sources. It’s all text, all in your terminal.

Automate Health Data Reporting

Use the `query_dataset` tool to pull HHS data in your cron jobs or shell scripts. You can set up a nightly job that queries hospital bed utilization, checks if it's above a certain threshold, and sends an alert if needed. Because Claude Code is headless, this can run on any server or in any container. It turns HealthData.gov into a reliable, scriptable source for your monitoring and reporting pipelines.

Integrate into CI/CD

With this MCP Server, HealthData.gov becomes just another command you can run in your CI/CD workflow. Use Claude Code inside a GitHub Action to run a `query_dataset` call, process the resulting JSON, and commit a data report back to your repository. This lets you create data-driven artifacts as part of your build process. For example, you could generate a static site with the latest public health stats every time you merge to main. This MCP connection makes that straightforward.

Setup guide

Set up HealthData.gov (HHS Open Data) MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see healthdatagov-hhs-open-data-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest HealthData.gov (HHS Open Data) transactions." It will automatically discover and invoke the available HealthData.gov (HHS Open Data) tools.

Terminal

claude mcp add --transport http healthdatagov-hhs-open-data-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the HealthData.gov (HHS Open Data) MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "healthdatagov-hhs-open-data-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by HealthData.gov. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect HealthData.gov (HHS Open Data) now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about HealthData.gov (HHS Open Data) MCP in Claude Code

You can write a shell script that uses `get_catalog` to fetch a dataset's metadata, then check the `last_updated` field. Run this script as a cron job to get notified when new data is published.

Yes. The output of the `query_dataset` tool is JSON. You can pipe it directly to tools like `jq` for filtering, `awk` for processing, or upload it somewhere with a tool like `curl`.

Run `claude mcp add --transport http health-hhs -- ` in your terminal, replacing `` with the Vinkius endpoint. This single command connects the client, and the tools are ready to use instantly.

The `query_dataset` tool respects the pagination limits of the underlying HealthData.gov API, which is typically 1000 records per request. For larger datasets, you'll need to script your calls to use the `$limit` and `$offset` SoQL parameters to page through all the data.

It's secure. Your Claude Code requests for public hospital data are stateless and proxied through Vinkius's ephemeral architecture. Your pipeline's credentials never touch the Vinkius MCP Server, and the connection token only grants access to these specific public data tools.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript