Photon Health MCP by usefulapi

Server Details

Read Photon Health patients, prescriptions, orders, pharmacies and medications; screen interactions.

If you are the author of this connector, you can claim ownership by verifying the domain or GitHub account it belongs to. Claimed connector authors can inspect health checks, view analytics, and manage their listing.

Status: Healthy
Last Tested: 2026-10-10 19:11
Transport: Streamable HTTP · MCP 2025-06-18
URL
Repository: m190/usefulapi-mcp
GitHub Stars: 0

TDQS

Score is being calculated.

Available Tools

21 tools

photonhealth_get_catalogGet a catalog

Read-onlyIdempotent

Inspect

Get one treatment catalog by id with its treatments and prescription templates (quantity, refills, days supply, directions). Photon GraphQL: catalog.

ParametersJSON Schema

Name	Required	Description	Default
`catalog_id`	Yes	Catalog id (from list_catalogs).

photonhealth_get_fillGet a fill

Read-onlyIdempotent

Inspect

Get one fill (a single dispensing of a prescription within an order) by id: state (SCHEDULED, NEW, SENT, CANCELED), requested/filled times, medication, prescription and order. Photon GraphQL: fill.

ParametersJSON Schema

Name	Required	Description	Default
`fill_id`	Yes	Photon fill id (fil_…).

photonhealth_get_medication_by_ndcLook up a medication by NDC

Read-onlyIdempotent

Inspect

Find the medication matching a package NDC (11-digit National Drug Code). Photon GraphQL (clinical API): medicationFromNdc.

ParametersJSON Schema

Name	Required	Description	Default
`package_ndc`	Yes	Package NDC.

photonhealth_get_orderGet an order

Read-onlyIdempotent

Inspect

Get one order by id: state, patient, pharmacy, address, fulfillment status/tracking and its fills. Photon GraphQL: order.

ParametersJSON Schema

Name	Required	Description	Default
`order_id`	Yes	Photon order id (ord_…).

photonhealth_get_organizationGet the organization

Read-onlyIdempotent

Inspect

Get the Photon organization these API keys belong to: id, name, type, NPI, address and contact details. Photon GraphQL (clinical API): organization.

ParametersJSON Schema

Name	Required	Description	Default
No parameters

photonhealth_get_patientGet a patient

Read-onlyIdempotent

Inspect

Get one patient by Photon id, with allergies, medication history, preferred pharmacies, and their prescriptions and orders (ids + states). Photon GraphQL: patient.

ParametersJSON Schema

Name	Required	Description	Default
`patient_id`	Yes	Photon patient id (pat_…).

photonhealth_get_pharmacyGet a pharmacy

Read-onlyIdempotent

Inspect

Get one pharmacy by Photon id: name, NPI, NCPDP, address, phone, fax and fulfillment types. Photon GraphQL: pharmacy.

ParametersJSON Schema

Name	Required	Description	Default
`pharmacy_id`	Yes	Photon pharmacy id (phr_…).

photonhealth_get_prescriptionGet a prescription

Read-onlyIdempotent

Inspect

Get one prescription by id: state, prescriber, patient, medication (with RxCUI/NDC codes), quantity, refills and fills remaining, days supply, directions, notes, diagnoses, dates and fills. Photon GraphQL: prescription.

ParametersJSON Schema

Name	Required	Description	Default
`prescription_id`	Yes	Photon prescription id (rx_…).

photonhealth_list_catalogsList catalogs

Read-onlyIdempotent

Inspect

List the organization's treatment catalogs (the medications it prescribes) with their treatments and prescription templates. Photon GraphQL: catalogs.

ParametersJSON Schema

Name	Required	Description	Default
No parameters

photonhealth_list_dispense_unitsList dispense units

Read-onlyIdempotent

Inspect

List the dispense units Photon accepts on a prescription (e.g. Each, Milliliter, Tablet). Photon GraphQL: dispenseUnits.

ParametersJSON Schema

Name	Required	Description	Default
No parameters

photonhealth_list_medication_packagesList medication packages

Read-onlyIdempotent

Inspect

List the packages (package NDCs) of a PRODUCT-level medication from list_medication_products. Photon GraphQL: medicationPackages.

ParametersJSON Schema

Name	Required	Description	Default
`medication_id`	Yes	Medication id of a PRODUCT (from list_medication_products).

photonhealth_list_medication_productsList medication products

Read-onlyIdempotent

Inspect

List the prescribable products (strength + form) of a DRUG-level medication from search_medications. Photon GraphQL: medicationProducts.

ParametersJSON Schema

Name	Required	Description	Default
`medication_id`	Yes	Medication id of a DRUG concept (from search_medications).

photonhealth_list_ordersList orders

Read-onlyIdempotent

Inspect

List pharmacy orders, filterable by patient and state (ROUTING, PENDING, PLACED, COMPLETED, CANCELED, ERROR). Each has the pharmacy, delivery address, fulfillment (type, state, carrier, tracking number) and fills. Photon GraphQL: orders.

ParametersJSON Schema

Name	Required	Description
`after`	No	Cursor: the id of the last item of the previous page.
`first`	No	Page size (forward pagination).
`state`	No	Order state.
`patient_id`	No	Only this patient's orders (pat_…).
`patient_name`	No	Filter by patient name.

photonhealth_list_patientsList patients

Read-onlyIdempotent

Inspect

List the organization's patients (id, external id, name, date of birth, sex, contact, address), optionally filtered by name. Photon GraphQL: patients.

ParametersJSON Schema

Name	Required	Description
`name`	No	Filter by patient name (partial match).
`after`	No	Cursor: the id of the last item of the previous page.
`first`	No	Page size (forward pagination).

photonhealth_list_prescriptionsList prescriptions

Read-onlyIdempotent

Inspect

List the organization's prescriptions, filterable by patient, prescriber and state (ACTIVE, EXPIRED, DEPLETED, CANCELED). Each has the medication, quantity, refills/fills remaining, directions, diagnoses and fills. Photon GraphQL: prescriptions.

ParametersJSON Schema

Name	Required	Description
`after`	No	Cursor: the id of the last item of the previous page.
`first`	No	Page size (forward pagination).
`state`	No	Prescription state.
`patient_id`	No	Only this patient's prescriptions (pat_…).
`patient_name`	No	Filter by patient name.
`prescriber_id`	No	Only prescriptions written by this prescriber (Photon user id).

photonhealth_list_usersList users

Read-onlyIdempotent

Inspect

List the organization's users (prescribers and staff): id, name, email, NPI, credentials and roles — use an id as prescriber_id in list_prescriptions. Photon GraphQL (clinical API): users.

ParametersJSON Schema

Name	Required	Description
`name`	No	Filter by user name.
`page_num`	No	Page number (1-based).
`page_size`	No	Page size (default 50, max 100).

photonhealth_screen_interactionsScreen for drug interactions

Read-onlyIdempotent

Inspect

Screen proposed medications for a patient against drug-drug and drug-allergy (and diagnosis) interactions, using the patient's allergies, medication history and existing prescriptions. READ-ONLY: nothing is written or prescribed. Returns alerts with type (DRUG, ALLERGEN, CONDITION), severity (MINOR, MODERATE, MAJOR), a description and the involved medications/allergens. Photon GraphQL (clinical API): prescriptionScreen.

ParametersJSON Schema

Name	Required	Description
`patient_id`	Yes	Photon patient id (pat_…).
`treatment_ids`	Yes	Medication/treatment ids to screen (med_…, from search_medications or a catalog).
`diagnosis_codes`	No	Optional ICD-10 codes to screen against, e.g. ['I10'].

photonhealth_search_allergensSearch allergens

Read-onlyIdempotent

Inspect

Search Photon's allergen list by name (fuzzy), e.g. to map a patient's reported allergy to an allergen id/RxCUI. Photon GraphQL: allergens.

ParametersJSON Schema

Name	Required	Description	Default
`name`	Yes	Allergen name, e.g. 'penicillin'.

photonhealth_search_medical_equipmentSearch medical equipment

Read-onlyIdempotent

Inspect

Search prescribable medical equipment/supplies (e.g. glucose test strips) by name. Photon GraphQL: medicalEquipment.

ParametersJSON Schema

Name	Required	Description
`name`	No	Equipment name (partial).
`after`	No	Cursor: the id of the last item of the previous page.
`first`	No	Page size (forward pagination).

photonhealth_search_medicationsSearch medications

Read-onlyIdempotent

Inspect

Search Photon's medication database by drug name (partial) or code (RxCUI, NDC or SKU). Returns DRUG-level concepts with RxCUI/NDC codes, schedule, controlled flag, strength and form; drill down with list_medication_products / list_medication_packages. Photon GraphQL: medications.

ParametersJSON Schema

Name	Required	Description
`code`	No	RxCUI, NDC or SKU.
`name`	No	Drug name (partial), e.g. 'amoxicillin'.
`after`	No	Cursor: the id of the last item of the previous page.
`first`	No	Page size (forward pagination).

photonhealth_search_pharmaciesSearch pharmacies

Read-onlyIdempotent

Inspect

Search pharmacies by name and/or near a location (latitude/longitude + radius in miles), by fulfillment type (PICK_UP = retail, MAIL_ORDER). Returns NPI, NCPDP, address, phone, fax. Photon GraphQL: pharmacies.

ParametersJSON Schema

Name	Required	Description
`name`	No	Pharmacy name (partial).
`type`	No	Fulfillment type (Photon's default is PICK_UP).
`first`	No	Page size (forward pagination).
`offset`	No	Number of results to skip (offset pagination).
`latitude`	No	Search center latitude.
`longitude`	No	Search center longitude.
`radius_miles`	No	Search radius in miles (with latitude/longitude).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

21 tool updatesOct 9, 2026
- First observedphotonhealth_get_catalog
- First observedphotonhealth_get_fill
- First observedphotonhealth_get_medication_by_ndc
- First observedphotonhealth_get_order
- First observedphotonhealth_get_organization
- First observedphotonhealth_get_patient
- First observedphotonhealth_get_pharmacy
- First observedphotonhealth_get_prescription
- First observedphotonhealth_list_catalogs
- First observedphotonhealth_list_dispense_units
- First observedphotonhealth_list_medication_packages
- First observedphotonhealth_list_medication_products
- First observedphotonhealth_list_orders
- First observedphotonhealth_list_patients
- First observedphotonhealth_list_prescriptions
- First observedphotonhealth_list_users
- First observedphotonhealth_screen_interactions
- First observedphotonhealth_search_allergens
- First observedphotonhealth_search_medical_equipment
- First observedphotonhealth_search_medications
- First observedphotonhealth_search_pharmacies

Related MCP Connectors

FinchNode Health Records
com.finchnode
Read patient-authorized EHR records: medications, labs, conditions, allergies. Consent-bounded.
Biology & Medicine Health & Wellness
1
Health Gorilla MCP by usefulapi A
io.usefulapi
Query Health Gorilla FHIR patients, conditions, medications and lab results.
Biology & Medicine Health & Wellness
161
Metriport MCP by usefulapi A
io.usefulapi
Read and write patients, facilities, medical documents, and consolidated FHIR records in Metriport.
Biology & Medicine Data Platforms
122
DrChrono MCP by usefulapi A
io.usefulapi
Read and write DrChrono patients, appointments, offices and clinical notes.
Biology & Medicine Calendar Management
151

Related MCP Servers

practice-fusion-mcp
Biology & Medicine Databases
CDVolvik
A
license
A
quality
A
maintenance
Enables read-only FHIR access to Practice Fusion EHR to search patients, appointments, conditions, medications, and lab results.
Updated a month ago (2026-09-10 16:35 UTC)
13
7 npm
4
MIT
Health Record Agent
Biology & Medicine Databases
Liuwen-bin
A
license
Not graded
quality
B
maintenance
Enables read-only access to Chinese FHIR electronic health records, including patient summaries, medication review context, record queries, and attachment reading, along with controlled CSV import and status tools.
Updated a month ago (2026-09-04 20:45 UTC)
MIT
@flexpa/mcp-fhir
Biology & Medicine Health & Wellness
DoctorCare
A
license
Not graded
quality
D
maintenance
Enables interaction with FHIR servers to access, search, and manage FHIR resources, including appointment scheduling and cancellation.
Updated 2 years ago (2025-02-26 20:38 UTC)
1
MIT
medplum-mcp
Biology & Medicine Security Databases
LiamDGray
A
license
Not graded
quality
B
maintenance
Connects frontier AI agents to HL7 FHIR R4 electronic health record repositories, enabling patient, observation, condition, medication, allergy, and diagnostic report queries plus draft-only clinical writes. Enforces mathematical safety gates, HIPAA-compliant tamper-evident audit logging, and token distillation of bulky FHIR payloads.
Updated 5 days ago (2026-10-05 21:14 UTC)
Apache 2.0

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Server Details

TDQS

Available Tools

Tool Schema Changelog

Related MCP Connectors

Related MCP Servers

practice-fusion-mcp

Health Record Agent

@flexpa/mcp-fhir

medplum-mcp

Glama MCP Gateway

Resources