MCP server

Particle Health MCP by usefulapi

io.usefulapi/particlehealth

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

Query Particle Health patient records across connected clinical networks.

Website Source

At a glance

Type

MCP server

Publisher

usefulapi.io (verified by the MCP Registry)

Status

Working at last check

Tools

11

Token cost

About 2,706 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http particlehealth https://particlehealth.usefulapi.io/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.particlehealth]
url = "https://particlehealth.usefulapi.io/mcp"

Gemini CLI

{"mcpServers":{"particlehealth":{"httpUrl":"https://particlehealth.usefulapi.io/mcp"}}}

Cursor

{"mcpServers":{"particlehealth":{"url":"https://particlehealth.usefulapi.io/mcp"}}}

VS Code

{"servers":{"particlehealth":{"type":"http","url":"https://particlehealth.usefulapi.io/mcp"}}}

Antigravity

agy mcp add particlehealth https://particlehealth.usefulapi.io/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"particlehealth","server_url":"https://particlehealth.usefulapi.io/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"particlehealth","server_url":"https://particlehealth.usefulapi.io/mcp"}

Tools

• particle_create_query ~244 tokens
  ⚠️ WRITE: initiate a nationwide clinical-record retrieval for a patient. Returns a query_id — poll particle_get_query_status for progress. Endpoint: POST /api/v2/patients/{particle_patient_id}/query.
• particle_get_ccda ~134 tokens
  Retrieve the patient's C-CDA clinical document(s). May be large and returned as XML/text — parsed if JSON, otherwise passed through as-is. Endpoint: GET /api/v2/patients/{particle_patient_id}/ccda.
• particle_get_fhir ~227 tokens
  Retrieve the patient's complete clinical record as a FHIR searchset Bundle. Supports incremental sync and pagination. Endpoint: GET /api/v2/patients/{particle_patient_id}/fhir.
• particle_get_fhir_by_type ~289 tokens
  Retrieve only one FHIR resource type for a patient (e.g. Condition, MedicationRequest, Observation) as a Bundle. Supports the same pagination as particle_get_fhir. Endpoint: GET /api/v2/patients/{particle_patient_id}/fhir/{type}.
• particle_get_flat ~198 tokens
  Retrieve the patient's clinical data in Particle's flattened (de-nested) format, easier to read than raw FHIR. Optionally filter to one domain. Endpoint: GET /api/v2/patients/{particle_patient_id}/flat.
• particle_get_patient ~116 tokens
  Fetch a single patient record by its Particle patient id. Endpoint: GET /api/v2/patients/{particle_patient_id}.
• particle_get_patient_documents ~107 tokens
  List the documents uploaded / available for a patient. Endpoint: GET /api/v1/documents/{patient_id}.
• particle_get_query_status ~165 tokens
  Get the status of a clinical-record retrieval query (state, timing, demographics, files). Omit query_id to get the latest COMPLETE query. Endpoint: GET /api/v2/patients/{particle_patient_id}/query.
• particle_search_network_participants ~210 tokens
  List the health-data network participants (organizations Particle can query). Optionally filter by state or zipcode, and page with continuation_token. Endpoint: GET /api/v1/networkparticipants (with /state/{state} and /zipcode/{zip} variants).
• particle_search_patient ~508 tokens
  Search for an existing patient by demographics (non-mutating). Returns an array of matching patient objects (or a 204 message when none match). Endpoint: POST /api/v2/patients/search.
• particle_submit_patient ~508 tokens
  ⚠️ WRITE: register a new patient with Particle Health. Returns the patient with a system-generated particle_patient_id (use it for subsequent queries). Endpoint: POST /api/v2/patients.

Browse

• Health and medicine

Related MCP servers

• Health Gorilla MCP by usefulapi
  Query Health Gorilla FHIR patients, conditions, medications and lab results.
• Metriport MCP by usefulapi
  Read and write patients, facilities, medical documents, and consolidated FHIR records in Metriport.
• Halaxy MCP by usefulapi
  Read Halaxy patients, appointments, slots and invoices; create patients, appointments and notes.
• splose MCP by usefulapi
  Read splose patients, appointments, invoices, cases; book and cancel appointments, record payments.
• Akute Health MCP by usefulapi
  Read Akute Health patients, appointments, tasks, notes, medications, allergies and observations.
• Hint Health MCP by usefulapi
  Read Hint Health patients, memberships, plans, invoices and payments for direct primary care.
• Photon Health MCP by usefulapi
  Read Photon Health patients, prescriptions, orders, pharmacies and medications; screen interactions.
• Elation Health MCP by usefulapi
  Read Elation Health patients, appointments, problems, allergies, medications, notes and vitals.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.usefulapi/particlehealth.svg)](https://aptlynx.net/servers/io.usefulapi/particlehealth)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents