How to Use the CMS.gov Data MCP in Mastra AI

Q: How do I register the CMS.gov Data MCP Server in Mastra AI?

Instantiate a new MCPClient pointing to your Vinkius URL, then call mcpClient.listTools(). Spread those tools directly into your agent's config so it can search doctors and hospitals.

Q: How do I require manual approval for CMS.gov Data lookups in Mastra AI?

Enable requireToolApproval on your agent config for sensitive tools like getdoctorbynpi. This pauses the workflow before invoking the MCP Server.

Build resilient healthcare workflows that fetch CMS.gov Data with automatic retries using Mastra AI agents.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect CMS.gov Data MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run automated provider verification workflows

The `get_doctor_by_npi` tool retrieves official Medicare enrollment status and primary specialties using a doctor's unique 10-digit NPI. Mastra AI lets you chain this tool into a multi-step workflow that verifies credentials automatically when a new doctor registers. If the initial lookup fails due to network hiccups, the framework's built-in exponential backoff retries the query. You don't have to write custom error-handling loops just to check if a clinician is active.

Build conditional branching with MCP Server

The `get_hospital_ratings` tool pulls 1-to-5 star quality metrics and emergency service availability for facilities nationwide. You can write a Mastra workflow that checks ratings with this MCP Server and branches based on the results. When a hospital's rating drops below three stars, the agent branches to pull full metadata with `get_dataset_metadata` and alerts your quality assurance team. This lets you build complex, hands-off monitoring pipelines.

Automate nursing home quality checks

The `search_nursing_homes` tool finds long-term care facilities and extracts their official quality ratings by location. Mastra AI runs these searches inside scheduled cron workflows to keep your local healthcare directories updated. You spread the tools from `mcpClient.listTools()` directly into your agent's toolset. The agent autonomously decides whether to search by state or specific city to locate underperforming facilities.

Setup guide

Set up CMS.gov Data 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 CMS.gov Data 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: "cmsgov-data-mcp-client",
  servers: {
    "cmsgov-data-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

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

const result = await agent.generate(
  "List recent CMS.gov Data 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 CMS.gov Data. 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 CMS.gov 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 CMS.gov Data MCP in Mastra AI

Instantiate a `new MCPClient` pointing to your Vinkius URL, then call `mcpClient.listTools()`. Spread those tools directly into your agent's config so it can search doctors and hospitals.

Yes, Mastra's workflow engine features automatic retries with exponential backoff. If the government database experiences temporary lag, your agent backs off and tries the lookup again without crashing.

Enable `requireToolApproval` on your agent config for sensitive tools like `get_doctor_by_npi`. This pauses the workflow before invoking the MCP Server.

Yes, Vinkius handles the transport layer, and Mastra's client automatically detects whether it is talking to a Streamable HTTP or SSE endpoint.

Vinkius isolates every session inside an ephemeral V8 sandbox. Your queries for specific medical specialties, doctor names, and ZIP codes are never written to persistent logs or shared across accounts.

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