mcp/charmhealth-mcp-server pulls statistics

CharmHealth MCP Server

An MCP server for CharmHealth EHR that allows LLMs and MCP clients to interact with patient records, encounters, and practice information.

What is an MCP Server?

MCP Info

Attribute	Details
Docker Image	mcp/charmhealth-mcp-server
Author	CharmHealth
Repository	https://github.com/CharmHealth/charm-mcp-server

Image Building Info

Attribute	Details
Dockerfile	https://github.com/CharmHealth/charm-mcp-server/blob/dae9f695b9ba82026959574d58db7e941703f026/Dockerfile
Commit	dae9f695b9ba82026959574d58db7e941703f026
Docker Image built by	Docker Inc.
Docker Scout Health Score
Verify Signature	COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/charmhealth-mcp-server --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub
Licence	MIT License

Available Tools (17)

Tools provided by this Server	Short Description
findPatients	Find patients.
getPracticeInfo	Get practice information.
manageAppointments	Manage appointments.
manageEncounter	Manage encounters.
manageFax	Send faxes and check fax delivery status.
manageMessages	Manage patient and provider messaging across SMS, WhatsApp, and secure messaging channels.
managePatient	Manage patients.
managePatientAllergies	Manage patient allergies.
managePatientDiagnoses	Manage patient diagnoses.
managePatientDrugs	Manage patient drugs and supplements.
managePatientFiles	Manage patient files and documents.
managePatientLabs	Manage patient laboratory results.
managePatientNotes	Manage patient notes.
managePatientRecalls	Manage patient recalls.
managePatientVitals	Manage patient vitals and vital signs.
manageTasks	Manage CharmHealth tasks.
reviewPatientHistory	Review patient history.

---

Tools Details

Tool: findPatients

Find patients.

<usecase> Find patients quickly using natural search terms or specific criteria. Handles everything from "find John Smith" to complex searches like "elderly diabetes patients in California". Essential first step for any patient-related task. </usecase> <instructions> Quick searches: Use search_type="name" with query="John Smith" for basic name searches Phone lookups: Use search_type="phone" with query="555-1234" (handles any format) Medical record: Use search_type="record_id" with query="MR123456"

Complex searches: Use search_type="advanced" with multiple criteria:

• Age ranges: age_min=65, age_max=80 for elderly patients
• Location: state="CA", city="Los Angeles" for geographic filtering
• Medical: blood_group="O+", language="Spanish" for clinical needs

Always returns patient_id needed for other tools. Start here before any patient operations.

When required parameters are missing, ask the user to provide the specific values rather than proceeding with defaults or auto-generated values. </instructions>

Parameters	Type	Description
age_max	string optional
age_min	string optional
blood_group	string optional
category_id	string optional
city	string optional
country	string optional
created_after	string optional
created_before	string optional
facility_id	string optional
gender	string optional
has_phr_account	string optional
language	string optional
limit	string optional
marital_status	string optional
modified_after	string optional
modified_before	string optional
page	string optional
postal_code	string optional
query	string optional
search_type	string optional
sort_by	string optional
sort_order	string optional
state	string optional
status	string optional

---

Tool: getPracticeInfo

Get practice information.

<usecase> Get essential practice information needed for other operations - available facilities, providers, vital signs templates, etc. Use this to understand practice setup and get IDs for other tools. </usecase> <instructions> - "facilities": List all practice locations with IDs needed for scheduling - "providers": List all providers with IDs needed for appointments and encounters - "vitals": Available vital sign templates for documentation - "overview": Summary of practice setup with key counts and recent activity - "templates": List all available SOAP templates (id, name, type) for the practice - "template_details": Full template schema (widgets + entries) for given template_ids (comma-separated)

When required parameters are missing, ask the user to provide the specific values rather than proceeding with defaults or auto-generated values. </instructions>

Parameters	Type	Description
info_type	string optional
template_ids	string optional

---

Tool: manageAppointments

Manage appointments.

<usecase> Complete appointment lifecycle management - schedule new appointments, reschedule existing ones, cancel appointments, and list appointments with flexible filtering. Handles the full appointment workflow. </usecase> <instructions> Actions: - "schedule": Create new appointment (requires patient_id, provider_id, facility_id, appointment_date, appointment_time). Check the provider's availability with manageAppointments(action='list') and provider_id, and across all facilities for the provider before suggesting a time. - "reschedule": Change existing appointment time (requires appointment_id + new scheduling details) - "cancel": Cancel appointment (requires appointment_id + cancel_reason) - "list": Show appointments with filtering (requires start_date, end_date_range, facility_ids; optionally filter by status/provider/mode)…