How to Use the HealthCare.gov MCP in Claude Code

Q: How do I write a script with Claude Code to monitor HealthCare.gov plan premiums?

Use the claude mcp run command in a shell script. Call the searchplans tool with your criteria and pipe the output to jq to extract the premium for your target plan. Save the result and compare it on the next run.

Q: Can I use Claude Code to check my medications against all HealthCare.gov plans in my area?

Yes. First, searchplans to get all plan IDs. Then, loop through those IDs in a script, calling getdrugcoverage for each one with your medication. You can log which plans cover it and at what tier.

Q: How do I connect Claude Code to this HealthCare.gov MCP Server?

It's one command: claude mcp add --transport http healthcaregov . Replace with the endpoint from your Vinkius dashboard. Use claude mcp list to confirm it's connected.

Q: Can I get a simple list of states that use the federal marketplace?

Yes, the listmarketstates tool is for exactly that. Just run the tool call through Claude Code and you'll get a clean array of state abbreviations.

Script and automate HealthCare.gov marketplace queries directly from your terminal with Claude Code. No browser, no GUI, just raw data.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect HealthCare.gov MCP to Claude Code

Create your Vinkius account to connect HealthCare.gov 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 HealthCare.gov with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Plan Searches in Scripts

The `search_plans` tool lets you find health plans from any shell script. You pass your household and location details as a JSON string and get back a structured list of plans. It's built for headless operation. Pipe the output directly to `jq` to filter, sort, or transform the data. You can build a cron job that emails you when a new plan matching your criteria appears. This is about repeatable, automated monitoring.

Headless Drug and Provider Lookups

Check if a plan covers a specific drug or doctor without ever opening a web page. Use `search_drugs` and `search_providers` to get entity IDs, then pass them to `get_drug_coverage` and `get_provider_coverage`. This is perfect for integration testing or data validation pipelines. You can write a script that takes a list of providers and plan IDs, then runs through every combination to generate a network coverage matrix. The entire process runs silently in your CI/CD environment.

A Command-Line HealthCare.gov MCP Server

This MCP Server connects the HealthCare.gov API to your terminal. Once you add the server, all 11 tools are available as subcommands for your Claude Code agent. You can chain commands together in any standard shell. For example, get your county FIPS with `get_counties_by_zip`, save it to a variable, and then immediately use it in a `list_issuers` call to see who operates there.

Setup guide

Set up HealthCare.gov 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 healthcaregov-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest HealthCare.gov transactions." It will automatically discover and invoke the available HealthCare.gov tools.

Terminal

claude mcp add --transport http healthcaregov-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 HealthCare.gov 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": {
    "healthcaregov-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 HealthCare.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 HealthCare.gov 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 HealthCare.gov MCP in Claude Code

Use the `claude mcp run` command in a shell script. Call the `search_plans` tool with your criteria and pipe the output to `jq` to extract the premium for your target plan. Save the result and compare it on the next run.

Yes. First, `search_plans` to get all plan IDs. Then, loop through those IDs in a script, calling `get_drug_coverage` for each one with your medication. You can log which plans cover it and at what tier.

It's one command: `claude mcp add --transport http healthcaregov `. Replace `` with the endpoint from your Vinkius dashboard. Use `claude mcp list` to confirm it's connected.

Yes, the `list_market_states` tool is for exactly that. Just run the tool call through Claude Code and you'll get a clean array of state abbreviations.

Your data is passed as a command-line argument to a stateless process. It's sent to the MCP Server for that single, isolated API call and is not logged or stored by Claude Code or the Vinkius infrastructure. The data exists only for the life of that command.

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