Epic Fhir Connector for AI agents.
10 live capabilities
Query patient records and clinical data for faster medical decisions.
Waiting for input…
Why people use Epic Fhir
Epic Fhir EHR Integration for Clinical Data Retrieval
This Connector lets you skip the navigation. You can ask your agent to pull the latest vitals and medications in one go. You get a summarized view of the patient's health history without ever leaving your chat interface.
What Vinkius changes
You get direct, conversational access to Epic patient data without leaving your agent interface.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Summarizing recent lab results
A care coordinator needs to prep for a meeting.
- Real-world use case 02
Finding specific patient cohorts
A clinical informaticist wants to find all patients born in 1985.
- Real-world use case 03
Validating ICD-10 codes
A health IT developer wants to test a new workflow.
Complete set · 10capabilities
The complete Epic Fhir capability set.
These are the exact actions your AI can choose when you ask it to work with Epic Fhir.
01—04
4 capabilities in this set.
Part of 10 available through Epic Fhir.
- 01 Capability
List immunizations
See full vaccination history including vaccine types, doses, sites, and lot numbers.
- 02 Capability
Get patient
Get full patient details like race, ethnicity, phone, and email by their unique ID.
- 03 Capability
List encounters
Get a list of patient visits including the encounter type, date period, reason, and location.
- 04 Capability
List observations
Pull clinical observations like vital signs or lab work with units and reference ranges.
05—07
3 capabilities in this set.
Part of 10 available through Epic Fhir.
- 05 Capability
List medications
View current medication requests with dosage, frequency, route, and the prescribing provider.
- 06 Capability
List allergies
Get a list of patient allergies including substance types, reaction severity, and clinical status.
- 07 Capability
List appointments
View all patient appointments with dates, provider details, locations, and current status.
08—10
3 capabilities in this set.
Part of 10 available through Epic Fhir.
- 08 Capability
List diagnostic reports
Pull diagnostic reports featuring results, conclusions, and the performing organization.
- 09 Capability
List conditions
See all active and resolved diagnoses with ICD-10 codes and onset dates.
- 10 Capability
Search patients
Find patients using names, dates of birth, or medical record numbers to get basic demographics.
Set up in minutes
One URL. Then ask Epic Fhir to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Epic Fhir from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_07WMxq8my4NvzsZPkY6lYQ8jtiB06jHwWtJH34fM/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it Epic Fhir, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable Epic Fhir for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_07WMxq8my4NvzsZPkY6lYQ8jtiB06jHwWtJH34fM/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Epic Fhir URL.
- Step 03
Save and start
Save the connection and enable Epic Fhir in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"epic-fhir": {
"url": "https://edge.vinkius.com/vk_preview_07WMxq8my4NvzsZPkY6lYQ8jtiB06jHwWtJH34fM/mcp"
}
}
} - Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using Epic Fhir
Open Agent mode in chat and ask: "Using Epic Fhir, help me...". 10 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"epic-fhir": {
"url": "https://edge.vinkius.com/vk_preview_07WMxq8my4NvzsZPkY6lYQ8jtiB06jHwWtJH34fM/mcp"
}
}
} - Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using Epic Fhir
Ask Copilot: "Using Epic Fhir, help me...". 10 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"epic-fhir": {
"url": "https://edge.vinkius.com/vk_preview_07WMxq8my4NvzsZPkY6lYQ8jtiB06jHwWtJH34fM/mcp"
}
}
} - Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using Epic Fhir
Open Cascade and ask: "Using Epic Fhir, help me...". 10 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"epic-fhir": {
"url": "https://edge.vinkius.com/vk_preview_07WMxq8my4NvzsZPkY6lYQ8jtiB06jHwWtJH34fM/mcp"
}
}
} - Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using Epic Fhir
Ask Cline: "Using Epic Fhir, help me...". 10 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add epic-fhir --transport http "https://edge.vinkius.com/vk_preview_07WMxq8my4NvzsZPkY6lYQ8jtiB06jHwWtJH34fM/mcp" - Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using Epic Fhir
Ask Claude: "Using Epic Fhir, show me...". 10 tools are ready
Where the request belongs
Work Epic Fhir can move forward.
It's for healthcare professionals who are tired of the click-fatigue of traditional EHR systems. It's for people who need to see the full medical picture quickly to make better clinical decisions.
Clinical Informaticist
Extracts patient cohort data and clinical metrics without writing complex SQL queries against the data warehouse.
Care Coordinator
Quickly reviews a patient's full medical timeline in seconds before a care transition meeting.
Health IT Developer
Prototypes FHIR-based workflows and validates API responses interactively.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsDrChrono
Manage healthcare workflows via DrChrono. handle patient records, schedule appointments, and access clinical notes directly from your AI agent.
Redox
Connect to the Redox healthcare API to search patients, retrieve clinical conditions, and write back observations directly from your AI agent.
Cliniko
Manage your healthcare practice via Cliniko. handle appointments, patient records, practitioners, and treatment notes directly from any AI agent.
Truepill
Manage pharmacy operations and patient records via Truepill. create patients, find records, and track prescriptions directly from any AI agent.
Applied Epic
Manage insurance clients, policies, and activities with Applied Epic. track renewals and compliance via AI.
EasyPractice
Equip your AI agent to manage clinic appointments, track clients, and monitor invoices via the EasyPractice API.
Bring your own AI
Change the model, client or framework. Keep Epic Fhir connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about Epic Fhir.
The practical details behind the request, access and result.
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 capabilities are query operations. search, list, and retrieve. No capability 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.
One connection away
Give your agent a direct line to Epic Fhir.
Connect Epic Fhir once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available