How to Use the HHS Open Payments MCP in Vercel AI SDK

Q: How do I search for a physician using the HHS Open Payments API with the AI SDK?

You pass the searchphysicians tool to your streamText function. The AI client handles the query execution and maps the returned records directly to your component state.

Q: Can the AI SDK handle large datasets from the HHS Open Payments source?

Yes, but you should use querydataset to filter data before it hits the frontend. This ensures your app stays performant while displaying relevant financial transparency records.

Stream HHS Open Payments data directly into your AI SDK frontend. Build live-updating financial transparency dashboards for users.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect HHS Open Payments MCP to Vercel AI SDK

Create your Vinkius account to connect HHS Open Payments to Vercel AI SDK 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 HHS Open Payments with Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Real-time dataset streaming

Feed government payment records straight into your UI components. Using `download_dataset` and `get_dataset`, you bypass intermediate storage and render financial disclosures as they arrive from the source. Your users watch the data populate in real-time. By coupling `query_dataset` with streaming responses, you provide immediate visibility into complex healthcare payment structures without waiting for backend processing cycles.

Direct physician and hospital lookups

Connect your interface to live search functions. When a user types a name, your AI client invokes `search_physicians` or `search_hospitals` to pull verified NPI and financial profile data directly into the view. This creates a tight feedback loop. Instead of static search results, your app presents context-aware payment histories and entity details the moment they are requested.

Structured financial auditing

Filter large-scale payment records programmatically using `query_dataset`. Your frontend sends specific parameters, and the server returns exactly the slices of data needed for your dashboard visualizations. This keeps your payload small and your UI responsive. You maintain control over the data flow while ensuring your users always interact with the most recent HHS records.

Setup guide

Set up HHS Open Payments MCP in Vercel AI SDK

Prerequisites

Node.js 18+ and a TypeScript project
ai + @modelcontextprotocol/sdk packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies

Run npm install ai @modelcontextprotocol/sdk plus your preferred model provider (e.g. @ai-sdk/openai).
2

Create the Streamable HTTP transport

Use StreamableHTTPClientTransport with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and use tools

Call mcpClient.tools() to auto-discover all HHS Open Payments tools. Pass them directly to generateText() or streamText() — no manual schema definitions needed.
4

Works with any model provider

Swap openai("gpt-4o") for any AI SDK provider — Anthropic, Google, Mistral. The MCP tools work identically across all supported models.

index.ts

import { experimental_createMCPClient as createMCPClient } from "ai";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";

const transport = new StreamableHTTPClientTransport(
  new URL("https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
);

const mcpClient = await createMCPClient({ transport });
const tools = await mcpClient.tools();

const { text } = await generateText({
  model: openai("gpt-4o"),
  tools,
  prompt: "List recent HHS Open Payments transactions",
});

console.log(text);
await mcpClient.close();

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 HHS Open Payments. 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 HHS Open Payments 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 HHS Open Payments MCP in Vercel AI SDK

You pass the `search_physicians` tool to your `streamText` function. The AI client handles the query execution and maps the returned records directly to your component state.

Yes, but you should use `query_dataset` to filter data before it hits the frontend. This ensures your app stays performant while displaying relevant financial transparency records.

It does. By using streaming transport, the results from your server tools appear instantly as they are processed, giving your users a live window into the data.

You handle them within your tool call logic. If a request fails, you can catch the error and display a clear message to the user immediately.

The server only touches public financial records. No sensitive user credentials or private health data are transmitted or stored by this MCP connection.

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