Bring Financial Transparency
to Claude Code
Learn how to connect HHS Open Payments to Claude Code and start using 6 AI agent tools in minutes. Fully managed, enterprise secure, and ready to use without writing a single line of code.
GDPR Free for SubscribersCompatible with every major AI agent and IDE
Gemini
What is the HHS Open Payments MCP Server?
Connect to the HHS Open Payments database to explore financial transparency in healthcare. This server allows you to query datasets, search for specific physicians or teaching hospitals, and analyze payments made by drug and device companies.
What you can do
- Dataset Discovery — List all available Open Payments datasets and inspect their metadata, including column definitions and update timestamps.
- Physician & Hospital Search — Search for specific healthcare providers or teaching hospitals by name to find their associated records.
- Advanced Querying — Use Socrata Query Language (SoQL) to filter, sort, and limit data for precise financial analysis.
- Data Export — Download specific datasets in CSV, JSON, or XML formats for external processing or reporting.
- Metadata Inspection — Fetch detailed information about specific datasets to understand the underlying data structure.
How it works
- Subscribe to this server
- Enter your HHS/Socrata API Key (optional but recommended for higher rate limits)
- Start auditing healthcare financial data directly from Claude, Cursor, or any MCP-compatible client
Who is this for?
- Researchers & Journalists — Uncover financial ties between the medical industry and healthcare professionals for investigative reporting.
- Compliance Officers — Monitor and verify the accuracy of reported financial transfers within healthcare organizations.
- Healthcare Consumers — Check for potential conflicts of interest or financial relationships of their medical providers.
Built-in capabilities (6)
JSON is recommended for programmatic access. Download a specific Open Payments dataset
Get metadata for a specific Open Payments dataset
List all available Open Payments datasets
Query specific records within a dataset using SoQL
Search for specific teaching hospitals
Search for specific physicians
Why Claude Code?
Claude Code registers HHS Open Payments as an MCP server in a single terminal command. Once connected, Claude Code discovers all 6 tools at runtime and can call them headlessly. ideal for CI/CD pipelines, cron jobs, and automated workflows where HHS Open Payments data drives decisions without human intervention.
- —
Single-command setup:
claude mcp addregisters the server instantly. no config files to edit or applications to restart - —
Terminal-native workflow means MCP tools integrate seamlessly into shell scripts, CI/CD pipelines, and automated DevOps tasks
- —
Claude Code runs headlessly, enabling unattended batch processing using HHS Open Payments tools in cron jobs or deployment scripts
- —
Built by the same team that created the MCP protocol, ensuring first-class compatibility and the fastest adoption of new protocol features
HHS Open Payments in Claude Code
HHS Open Payments and 4,000+ other MCP servers. One platform. One governance layer.
Teams that connect HHS Open Payments to Claude Code through Vinkius don't need to source, host, or maintain individual MCP servers. Every tool call runs inside a hardened runtime with credential isolation, DLP, and a signed audit chain.
Raw MCP | Vinkius | |
|---|---|---|
| Server catalog | Find and host yourself | 4,000+ managed |
| Infrastructure | Self-hosted | Sandboxed V8 isolates |
| Credential handling | Plaintext in config | Vault + runtime injection |
| Data loss prevention | None | Configurable DLP policies |
| Kill switch | None | Global instant shutdown |
| Financial circuit breakers | None | Per-server limits + alerts |
| Audit trail | None | Ed25519 signed logs |
| SIEM log streaming | None | Splunk, Datadog, Webhook |
| Honeytokens | None | Canary alerts on leak |
| Custom domains | Not applicable | DNS challenge verified |
| GDPR compliance | Manual effort | Automated purge + export |
Why teams choose Vinkius for HHS Open Payments in Claude Code
The HHS Open Payments MCP Server runs on Vinkius-managed infrastructure inside AWS — a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts. All 6 tools execute in hardened sandboxes optimized for native MCP execution.
Your AI agents in Claude Code only access the data you authorize, with DLP that blocks sensitive information from ever reaching the model, kill switch for instant shutdown, and up to 60% token savings. Enterprise-grade infrastructure, zero maintenance.
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
How Vinkius secures
HHS Open Payments for Claude Code
Every tool call from Claude Code to the HHS Open Payments MCP Server is protected by DLP redaction, cryptographic audit chains, V8 sandbox isolation, kill switch, and financial circuit breakers.
Frequently asked questions
Can I search for a specific doctor by name to see their financial records?
Yes! Use the search_physicians tool with the doctor's name. The agent will return matching profiles and their associated payment data from the Open Payments database.
How do I filter data for a specific state or payment amount?
You can use the query_dataset tool and provide a SoQL filter in the where parameter (e.g., recipient_state = 'NY' or total_amount_of_payment_usdollars > 1000).
What formats can I use to download the datasets?
The download_dataset tool supports 'csv', 'json', and 'xml' formats. JSON is generally recommended for programmatic access and AI analysis.
How do I add an MCP server to Claude Code?
Run claude mcp add <name> --transport http "<url>" in your terminal. Claude Code registers the server and discovers all tools immediately.
Can Claude Code run MCP tools in headless mode?
Yes. Claude Code supports non-interactive execution, making it ideal for scripts, cron jobs, and CI/CD pipelines that need MCP tool access.
How do I list all connected MCP servers?
Run claude mcp in your terminal to see all registered servers and their status, or type /mcp inside an active Claude Code session.
Command not found: claude
Ensure Claude Code is installed globally: npm install -g @anthropic-ai/claude-code
Connection timeout
Check your internet connection and verify the Edge URL is reachable
Explore More MCP Servers
View all →
DataDive
10 toolsEquip your AI agent to retrieve Amazon seller insights, keyword rankings, and niche analytics directly via the DataDive API.
Douyin Local Life API / 抖音生活服务
8 toolsChina's leading local life platform — manage shops, process orders, and verify coupons via AI.
Freshsales
10 toolsClose deals faster with AI-powered lead scoring, visual deal pipelines, and built-in phone and email in one sales CRM.
Mailjet
12 toolsDeliver emails at scale with collaborative template editing, real-time monitoring, and deliverability analytics in one platform.