usefulapi

Health Gorilla MCP server. Query Health Gorilla FHIR patients, conditions, medications and lab results.

Claude

  1. Open Settings → Connectors → Add custom connector
  2. Paste this URL:
    https://health-gorilla.usefulapi.io/mcp
  3. Authenticate with Health Gorilla when prompted

Cursor · VS Code · Windsurf · Cline

Add to your MCP config, then reload & authorize:

{
  "mcpServers": {
    "health-gorilla": {
      "url": "https://health-gorilla.usefulapi.io/mcp"
    }
  }
}
live16 toolsFree 100 tool calls / monthPro $9/mo · $90/yr

Tools 16

ToolTypeWhat it does
healthgorilla_find_patientsread
Find patients
Search for patients by demographics. FHIR: GET /Patient?given=&family=&birthdate=&identifier=. Returns a FHIR searchset Bundle. Use the returned Patient id with the other tools.
healthgorilla_get_patientread
Get patient
Read a single patient by id. FHIR: GET /Patient/{id}. Returns a FHIR Patient resource.
healthgorilla_get_patient_everythingread
Get patient $everything
Fetch the comprehensive record for a patient as a FHIR Bundle. FHIR: GET /Patient/{id}/$everything. Optionally scope by _since and page with _count.
healthgorilla_list_conditionsread
List conditions
List a patient's conditions/problems. FHIR: GET /Condition?patient={id}. Returns a FHIR searchset Bundle.
healthgorilla_list_medicationsread
List medications
List a patient's medication requests/prescriptions. FHIR: GET /MedicationRequest?patient={id}. Returns a FHIR searchset Bundle.
healthgorilla_list_allergiesread
List allergies
List a patient's allergies/intolerances. FHIR: GET /AllergyIntolerance?patient={id}. Returns a FHIR searchset Bundle.
healthgorilla_list_immunizationsread
List immunizations
List a patient's immunizations. FHIR: GET /Immunization?patient={id}. Returns a FHIR searchset Bundle.
healthgorilla_list_observationsread
List observations
List a patient's observations (labs, vitals). FHIR: GET /Observation?patient={id}. Filter by category (e.g. laboratory, vital-signs), LOINC code, or date. Returns a FHIR searchset Bundle.
healthgorilla_list_diagnostic_reportsread
List diagnostic reports
List a patient's diagnostic reports (lab panels, imaging). FHIR: GET /DiagnosticReport?patient={id}. Returns a FHIR searchset Bundle.
healthgorilla_list_documentsread
List documents
List a patient's document references (C-CDA, notes, etc). FHIR: GET /DocumentReference?patient={id}. Each entry points at a Binary you can fetch with healthgorilla_get_binary.
healthgorilla_get_coverageread
Get coverage
List a patient's insurance coverage. FHIR: GET /Coverage?patient={id}. Returns a FHIR searchset Bundle.
healthgorilla_get_binaryread
Get binary (document content)
Retrieve raw document content by Binary id. FHIR: GET /Binary/{id}. Content may be a FHIR Binary JSON resource, XML C-CDA, or base64 — returned as-is (raw text if not JSON).
healthgorilla_poll_query_statusread
Poll query status
Poll a RequestResult URL returned by healthgorilla_start_patient360_query. HTTP 202 = still processing, 200 = done (returns retrieval metrics: organizationsTotal, documentsFound, documentsImported, documentsSkipped, documentsFailed). Returns { status, body }.
healthgorilla_fhir_searchread
Generic FHIR search
Escape hatch: run an arbitrary FHIR search. GET /{resource_type}?{query}. e.g. resource_type='Observation', query='patient=123&category=laboratory&_count=5'. Use when a dedicated tool does not cover your query.
healthgorilla_create_patientwrite
Create patient
Registers a NEW patient record in your Health Gorilla tenant. FHIR: POST /Patient with a minimal FHIR R4 Patient resource built from the given args. State-changing.
healthgorilla_start_patient360_querywrite
Start Patient360 query
Initiates an asynchronous national-network records retrieval (CommonWell / Carequality / QHINs) that imports external documents into your tenant. FHIR: GET /DocumentReference/$p360-retrieve?patient={id} with header 'Prefer: respond-async'. Returns the RequestResult poll URL (Location header); poll it with healthgorilla_poll_query_status. State-changing.

Pricing

PlanPriceLimit
Free$0100 tool calls / month
Pro$9/mo · $90/yrUnlimited

This is a Model Context Protocol endpoint — meant to be connected from an AI client, not opened in a browser. An invalid_token response at the URL is the auth gate working as designed; clients authenticate automatically.