# Epic Fhir MCP for AI Agents AI Agent Connect

> Epic Fhir lets you pull clinical data directly into your agent. It connects to Epic's FHIR R4 API so you can search for patients, check lab results, view medications, and review clinical encounters without clicking through multiple EHR screens. It's the bridge between your patient records and your agent.

## Overview
- **Category:** data-management
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_07WMxq8my4NvzsZPkY6lYQ8jtiB06jHwWtJH34fM/ai-agent-connect
- **Tags:** electronic-health-records, fhir-r4, patient-data, clinical-observations, lab-results, ehr-integration

## Description

Navigating an electronic health record system usually means digging through endless tabs, scrolling past irrelevant data, and hunting for specific lab results or medication lists. This Connector changes that by letting your agent do the heavy lifting for you. Instead of manual searching, you can just ask your agent to pull up a patient's history or summarize their recent vitals. It connects directly to Epic's FHIR R4 API, giving your agent the ability to see what's actually happening in the clinical workflow. Whether you're looking for a specific ICD-10 code or checking a vaccination lot number, the data shows up exactly where you're working. This is a core part of the Vinkius catalog, designed to make clinical data actually usable in a conversational way. You get to focus on the patient while the agent handles the data retrieval from the EHR. This means you can move from searching to deciding in seconds. You don't have to worry about remembering which tab holds the most recent blood work or which screen lists the active prescriptions. The agent pulls the relevant records, summarizes the findings, and presents them to you in a single view. It turns a fragmented data landscape into a coherent medical history that you can actually use during a consultation or a care transition meeting.

## Tools

### list_immunizations
See full vaccination history including vaccine types, doses, sites, and lot numbers.

### get_patient
Get full patient details like race, ethnicity, phone, and email by their unique ID.

### list_encounters
Get a list of patient visits including the encounter type, date period, reason, and location.

### list_observations
Pull clinical observations like vital signs or lab work with units and reference ranges.

### list_medications
View current medication requests with dosage, frequency, route, and the prescribing provider.

### list_allergies
Get a list of patient allergies including substance types, reaction severity, and clinical status.

### list_appointments
View all patient appointments with dates, provider details, locations, and current status.

### list_diagnostic_reports
Pull diagnostic reports featuring results, conclusions, and the performing organization.

### list_conditions
See all active and resolved diagnoses with ICD-10 codes and onset dates.

### search_patients
Find patients using names, dates of birth, or medical record numbers to get basic demographics.

## Prompt Examples

**Prompt:** 
```
Find all patients named Smith born in 1985.
```

**Response:** 
```
Found 3 patients matching 'Smith' born in 1985:

| Name | ID | DOB | Gender | MRN |
| :--- | :--- | :--- | :--- | :--- |
| John Smith | e63wACU8F | 1985-03-12 | Male | 203847 |
| Sarah Smith | TnOZ.mfU4 | 1985-09-28 | Female | 410293 |
| Robert Smith | eAr3bA.mH | 1985-01-05 | Male | 587102 |

Would you like to see the full medical history for any of these patients?
```

**Prompt:** 
```
Show me the latest lab results for patient e63wACU8F.
```

**Response:** 
```
Lab results for John Smith (last 30 days):

* **Hemoglobin A1c**: 6.2% (ref: <5.7% normal, 5.7-6.4% prediabetes) ⚠️
* **Glucose (fasting)**: 118 mg/dL (ref: 70-100) ⚠️
* **Creatinine**: 0.9 mg/dL (ref: 0.7-1.3) ✅
* **eGFR**: 92 mL/min (ref: >60) ✅
* **Total Cholesterol**: 198 mg/dL (ref: <200) ✅

The A1c and fasting glucose are slightly elevated, suggesting prediabetic range. Want me to check current medications and conditions?
```

**Prompt:** 
```
List all active medications for this patient.
```

**Response:** 
```
Active medications for John Smith:

1. **Metformin 500mg** — 1 tablet twice daily with meals (Dr. Chen, prescribed 2024-11-15)
2. **Lisinopril 10mg** — 1 tablet daily (Dr. Chen, prescribed 2024-06-02)
3. **Atorvastatin 20mg** — 1 tablet at bedtime (Dr. Patel, prescribed 2024-03-10)

No known allergies documented. Want me to check the immunization record or upcoming appointments?
```

## Capabilities

### Search for patients by demographics
Find patient records instantly using names, dates of birth, or medical record numbers.

### Review clinical encounter history
See a full list of patient visits including reasons, dates, and locations.

### Pull lab results and vitals
Get clinical observations like blood work and vital signs with units and reference ranges.

### List active diagnoses and conditions
View current and resolved health conditions with ICD-10 codes and onset dates.

### View medications and allergies
Check current prescriptions, dosages, and documented allergic reactions in one place.

### Check immunization and appointment records
Access vaccination histories including lot numbers and upcoming appointment schedules.

## Use Cases

### Summarizing recent lab results
A care coordinator needs to prep for a meeting. They ask the agent to summarize the last 30 days of lab results for a specific patient using list_observations.

### Finding specific patient cohorts
A clinical informaticist wants to find all patients born in 1985. They ask the agent to search the system and list them using search_patients.

### Validating ICD-10 codes
A health IT developer wants to test a new workflow. They use the agent to pull diagnostic reports and verify the ICD-10 codes using list_diagnostic_reports.

### Checking vaccination lot numbers
A nurse wants to check a patient's vaccine lot numbers. They ask the agent to list immunizations for a specific patient ID using list_immunizations.

## Benefits

- Get patient demographics instantly using search_patients to skip manual record lookups.
- Review entire medication histories with list_medications to see dosages and prescribing providers at a glance.
- Identify patient risks quickly by pulling lab results and vitals via list_observations.
- Track clinical history with list_encounters to see the reason and location for every previous visit.
- Check patient safety with list_allergies to see reaction types and severity levels immediately.
- Manage patient schedules easily by using list_appointments to see upcoming visits and provider info.

## How It Works

The bottom line is you get direct, conversational access to Epic patient data without leaving your agent interface.

1. Subscribe to this Connector on Vinkius.
2. Provide your FHIR endpoint URL, Client ID, and Access Token from your Epic App Orchard registration.
3. Ask your agent to find patients or pull records using natural language.

## Frequently Asked Questions

**Can the Epic Fhir MCP help me see patient lab results?**
Yes, the Epic Fhir MCP allows your agent to pull clinical observations including laboratory work, vital signs, and social history with reference ranges.

**How do I connect Epic Fhir to my AI agent?**
You can connect it by subscribing on Vinkius and providing your FHIR endpoint URL along with your Client ID and Access Token from your Epic App Orchard registration.

**Does the Epic Fhir MCP support ICD-10 codes?**
Yes, it can list active and resolved diagnoses and conditions along with their specific ICD-10 codes and onset dates.

**Can I use Epic Fhir to check patient allergies?**
Yes, the Connector can pull a list of patient allergies and intolerances, including the substance type, reaction severity, and clinical status.

**What kind of clinical data can the Epic Fhir MCP pull?**
It can pull a wide range of data including patient demographics, clinical encounters, medications, immunizations, and diagnostic reports.

**Is the Epic Fhir MCP suitable for care coordinators?**
It is ideal for care coordinators who need to quickly review a patient's full medical timeline and medication history before care transition meetings.

**Can I search for a patient and instantly see their full medical timeline?**
Yes! Use `search_patients` with name or MRN to find the patient, then chain `list_encounters`, `list_conditions`, and `list_medications` to build a full clinical picture. Your agent compiles everything in seconds — no chart-clicking required.

**How do I prepare a patient summary before a care coordination meeting?**
Ask your agent to pull everything at once: 'Show me the full medical history for patient ID abc123.' It will call `get_patient` for demographics, `list_conditions` for active diagnoses, `list_medications` for current prescriptions, and `list_allergies` for safety alerts — delivering a structured briefing ready for your meeting.

**Is this integration read-only? Can it modify patient data?**
This integration is entirely read-only. All 10 tools are query operations — search, list, and retrieve. No tool can create, update, or delete any clinical data. Your Epic FHIR access token controls exactly which patients and resources are visible, enforcing your existing HIPAA access controls.