# HHS Open Payments MCP for AI Agents AI Agent Connect > HHS Open Payments lets you pull financial data from the government's healthcare transparency database. You can search for specific doctors, teaching hospitals, and the money flowing from pharma and medical device companies into their pockets. It's a direct line to the CMS Open Payments records for anyone auditing healthcare ties or looking for transparency in the medical industry. ## Overview - **Category:** government-public-data - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_7u23vXwhxnAQUVTHtJVGNkWOGXYiG0Rpr2DQtEqC/ai-agent-connect - **Tags:** financial-transparency, healthcare-data, compliance, public-records, data-analysis ## Description Imagine trying to figure out which pharma companies are funding which local doctors. Usually, this involves digging through massive government spreadsheets, filtering by zip code, and trying to make sense of messy CSV files. This Connector changes that by letting your AI client do the heavy lifting. Instead of manual hunting, you can just ask your agent to find every payment a specific hospital received from a drug manufacturer in a certain year. It handles the Socrata Query Language for you, so you don't have to learn a new syntax to get the data. You can also grab the raw files for your own reports or just peek at the metadata to see what's available. It's a massive shortcut for anyone who needs to see who's paying whom in the medical world. You'll find it's a lot easier to spot patterns of influence when your AI can query thousands of records in seconds. Since Vinkius hosts this, you can plug it into your existing workflow and start auditing immediately. It turns a tedious research project into a few quick prompts. You get a clear picture of the financial landscape without having to open a single spreadsheet or deal with broken formatting. It's about getting to the truth of healthcare spending without the manual labor. ## Tools ### list_datasets See every available Open Payments dataset currently hosted in the database. Use this to find the correct ID for your research. ### download_dataset Pull a specific Open Payments dataset in CSV, JSON, or XML format for your own local analysis. This is useful for keeping your own records updated. ### get_dataset View the metadata for a specific Open Payments dataset. This helps you understand the underlying data structure before you query it. ### query_dataset Use SoQL to filter and sort specific records based on your exact criteria. This allows for precise financial analysis of payments. ### search_physicians Look up individual doctors by name to uncover their payment history. This helps identify specific relationships in the medical field. ### search_hospitals Find specific teaching hospitals to see their associated financial records. It's a fast way to group payments by institution. ## Prompt Examples **Prompt:** ``` Who are the top 5 doctors in California who received payments from pharma companies? ``` **Response:** ``` I've analyzed the payments for California. Here are the top 5 physicians based on total reported payments from drug manufacturers: | Physician Name | Primary Specialty | Total Payments | | :--- | :--- | :--- | | Dr. Sarah Chen | Oncology | $450,000 | | Dr. Marcus Vane | Cardiology | $380,000 | | Dr. Elena Rodriguez | Neurology | $310,000 | | Dr. James Wu | Immunology | $295,000 | | Dr. Linda Smith | Rheumatology | $275,000 | Would you like to see the specific companies that made these payments? ``` **Prompt:** ``` Search for 'St. Jude' and show me the total payments from medical device companies. ``` **Response:** ``` Searching for 'St. Jude' in the teaching hospital records... I found records for **St. Jude Children's Research Hospital**. **Summary of Medical Device Payments:** * **Total Payments:** $12,450,000 * **Primary Device Type:** Imaging & Diagnostics * **Recent High-Value Payment:** $1,200,000 (Medical Imaging Systems) I can provide a breakdown of the top 3 device manufacturers if you'd like. ``` **Prompt:** ``` List all the datasets available so I can see which year is the most recent. ``` **Response:** ``` Here are the available Open Payments datasets currently in the database: * **General Payments 2023** (ID: pgaw-6u8r) * **Research Payments 2023** (ID: 5930-21ab) * **General Payments 2022** (ID: pgaw-5v9x) * **Research Payments 2022** (ID: 4412-99bc) The most recent data available is for **2023**. Which one would you like to explore further? ``` ## Capabilities ### List all available datasets See every Open Payments dataset currently hosted in the database. ### Get metadata for specific datasets View the structure and column definitions for a specific dataset. ### Query records using SoQL Filter and sort specific records using Socrata Query Language. ### Search for specific teaching hospitals Find records for specific hospitals to see their associated payments. ### Search for specific physicians Look up individual doctors by name to see their payment history. ### Download datasets in CSV, JSON, or XML Pull raw data files for your own local analysis or reporting. ## Use Cases ### Tracking Pharma Influence A journalist wants to see which pharma companies paid the most to doctors in Florida. They ask their agent to find the top 10 payments from the last year. ### Regulatory Compliance Check A compliance officer needs to verify if a hospital's payments match reported figures. They use query_dataset to filter for specific amounts. ### Medical Research Mapping A researcher is mapping the financial relationship between drug makers and teaching hospitals. They use search_hospitals to aggregate data. ### Patient Conflict of Interest Check A patient wants to see if their primary care physician has received significant funding from a specific medical device maker. They use search_physicians. ## Benefits - Skip manual CSV downloads by using list_datasets and get_dataset to see exactly what's available before you start. - Find specific doctors instantly with search_physicians instead of scrolling through thousands of rows of data. - Run complex filters on payments using query_dataset to isolate specific amounts, dates, or regions. - Export raw data for your own reports using download_dataset to keep your records updated and portable. - Map out hospital funding patterns quickly by using search_hospitals to group records by institution. ## How It Works The bottom line is you get instant access to government healthcare records without manual searching. 1. Connect the HHS Open Payments MCP to your AI client via Vinkius. 2. Add your Socrata API key to the configuration to hit higher rate limits. 3. Ask your agent to find specific payments or list hospital records. ## Frequently Asked Questions **What does the HHS Open Payments MCP actually do?** It connects your AI client to the government's public database of healthcare payments. This allows you to search for financial ties between pharma companies and doctors or hospitals directly through your agent. **Can I use the HHS Open Payments MCP to find specific doctors?** Yes, you can use it to search for physicians by name to see their reported financial ties. This is great for checking for potential conflicts of interest. **Does the HHS Open Payments MCP include private patient info?** No, it only contains public financial records about payments from drug and device companies. It does not contain any private medical records or patient health information. **How does the HHS Open Payments MCP help with research?** It allows you to query large datasets to find patterns in healthcare spending. You can filter by amount, location, or provider to gather data for reports or audits. **Can I export data using the HHS Open Payments MCP?** Yes, you can download specific datasets in formats like CSV or JSON for your own use. This is perfect if you need to move the data into your own spreadsheet or analysis tool. **Is the HHS Open Payments MCP good for investigative journalism?** It's a great tool for uncovering financial relationships between the medical industry and healthcare providers. It helps you find the facts quickly without manual data hunting. **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.