How to Use the HealthCare.gov MCP in Mastra AI

Q: How do I configure the HealthCare.gov tools in Mastra AI?

Install @mastra/mcp. Create a new MCPClient and pass your Vinkius server URL in the servers object. Mastra auto-detects the transport layer and loads the tools.

Q: Can Mastra AI require human approval for HealthCare.gov searches?

Yes. You can enable requireToolApproval on the MCP client. The workflow will pause before executing searchplans, letting a human review the household JSON parameters first.

Automate complex open enrollment workflows. Mastra AI uses this server to search plans, verify networks, and handle API rate limits.

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 Mastra AI

Create your Vinkius account to connect HealthCare.gov to Mastra AI 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 Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build resilient HealthCare.gov workflows

The `search_plans` tool requires complex JSON strings for household and place parameters. Mastra AI structures these requests and automatically retries with exponential backoff if the government API drops the connection. You define the exact sequence of events. If a user wants a silver tier policy, your workflow calls `get_plan_details` and loops through the results. When the upstream server lags, Mastra holds the state and tries again.

Conditional branching for drug coverage

The `get_drug_coverage` tool checks if a specific plan pays for a medication. You can build a Mastra AI branch that rejects a plan immediately if this tool returns a negative result. The agent uses `search_drugs` to find the exact formulation ID first. If the drug exists, it proceeds to the coverage check. If the user spelled the medication wrong, the workflow branches to a correction prompt instead of failing.

Automate crosswalk and issuer mapping with the MCP Server

The `get_plan_crosswalk` tool tracks how policies change from one year to the next. Your agent pulls this data to warn users if their current plan is being discontinued. It combines this with `list_issuers` to see which companies still operate in the state. You pass these tools into your Mastra agent using `mcpClient.listTools()`, giving it the context to recommend a new carrier.

Setup guide

Set up HealthCare.gov MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All HealthCare.gov tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "healthcaregov-mcp-client",
  servers: {
    "healthcaregov-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "HealthCare.gov Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to HealthCare.gov tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent HealthCare.gov transactions"
);
console.log(result.text);

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 Mastra AI

Install `@mastra/mcp`. Create a new `MCPClient` and pass your Vinkius server URL in the `servers` object. Mastra auto-detects the transport layer and loads the tools.

Yes. You can enable `requireToolApproval` on the MCP client. The workflow will pause before executing `search_plans`, letting a human review the household JSON parameters first.

The government APIs throttle aggressive scraping. Mastra's built-in workflow engine catches 429 status codes and applies exponential backoff before attempting the tool call again.

Vinkius handles the authentication. You provide a single endpoint token to your Mastra client, and the server manages the underlying credentials for the external API.

The tools process specific medication names and dosage forms to verify coverage. Vinkius operates on a zero-trust architecture. The container executes the search and immediately terminates, ensuring no medical queries persist on disk.

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