# Particle Health MCP by usefulapi

> Particle Health MCP by usefulapi is a freemium MCP server for health and science. Hosted MCP server for querying Particle Health patient records from AI clients. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API, Web, vscode
- **Website:** https://usefulapi.io/particlehealth/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/particlehealth
- **MCP Registry name:** io.usefulapi/particlehealth
- **Categories:** health and science
- **Listing updated:** 2026-11-18

## About

The README describes a hosted endpoint rather than a local install, so you add one URL to an MCP client and sign in with Particle Health credentials. Once connected, an assistant can look up a patient, check the status of a record retrieval, and pull medications, conditions and documents through Particle's API. Results come back as FHIR bundles, a flattened format, or C-CDA documents, depending on the tool used.

The server exposes 15 tools in total. Nine are read-only, two can register patients or start clinical-record queries and should be confirmed before running, and four handle usage metering and subscriptions. The product page states that it is not affiliated with Particle Health and that it must not be used with protected health information because no HIPAA Business Associate Agreements are signed.

It suits developers and analysts testing Particle Health workflows from Claude, ChatGPT, Cursor, VS Code or Codex, where the free tier of 50 calls a month covers light use.

## Features

- **Hosted remote endpoint:** Connects over Streamable HTTP with OAuth login, so no local server or API key in client config is needed.
- **Patient record retrieval:** Fetches a single patient record, the full FHIR bundle, or one FHIR resource type such as Condition or MedicationRequest.
- **Clinical document access:** Lists uploaded patient documents and retrieves C-CDA documents, with flattened data available as an easier-to-read alternative to raw FHIR.
- **Query status tracking:** Reports the state and timing of a clinical-record retrieval, defaulting to the latest completed query.
- **Usage metering and plans:** Reports calls used against the monthly limit and supports upgrading or cancelling the Pro subscription from within the assistant.

## Good for

- Reviewing a patient's medications and conditions in a chat with an AI assistant
- Checking whether a clinical-record retrieval has finished before reviewing results
- Browsing available network participants by state or ZIP code
- Listing and reading patient documents for a test or integration workflow

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://particlehealth.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "particlehealth": {
      "serverUrl": "https://particlehealth.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "particlehealth": {
      "type": "http",
      "url": "https://particlehealth.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `particle_get_patient`: Fetch a single patient record by its Particle patient id.
- `particle_search_patient`: Search for an existing patient by demographics (non-mutating).
- `particle_get_query_status`: Get the status of a clinical-record retrieval query.
- `particle_get_fhir`: Retrieve the patient's complete clinical record as a FHIR searchset Bundle.
- `particle_get_fhir_by_type`: Retrieve one FHIR resource type for a patient as a Bundle.
- `particle_get_flat`: Retrieve clinical data in Particle's flattened format.
- `particle_get_ccda`: Retrieve the patient's C-CDA clinical document(s).
- `particle_search_network_participants`: List health-data network participants Particle can query.
- `particle_get_patient_documents`: List the documents uploaded or available for a patient.
- `particle_submit_patient`: Register a new patient with Particle Health (write).
- `particle_create_query`: Initiate a nationwide clinical-record retrieval for a patient (write).
- `particlehealth_usage_status`: Report the caller's current usage against the plan limit.
- `particlehealth_request_feature`: Send a request for a capability the Particle Health tools lack.
- `particlehealth_upgrade`: Get a paid Pro or Pro+ plan for Particle Health.
- `particlehealth_cancel_subscription`: Cancel the Pro subscription at the end of the paid period.

## FAQ

### Is this an official Particle Health product?

No. The product page says usefulapi is an independent service that is not affiliated with or endorsed by Particle Health.

### Can I use this server with patient data (PHI)?

No. The page says not to use it with protected health information because usefulapi does not sign HIPAA Business Associate Agreements.

### What does it cost?

The Free plan includes 50 tool calls a month. Pro is $9/mo or $90/yr for 10,000 calls a month, and Pro+ is $39/mo or $390/yr for 100,000 calls a month.

### Which AI clients can connect to it?

Any client that supports remote MCP servers over Streamable HTTP with OAuth, including Claude, Claude Code, ChatGPT, Codex, Cursor, VS Code and Windsurf.

### Is Particle Health MCP by usefulapi free?

Particle Health MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add Particle Health MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http particlehealth https://particlehealth.usefulapi.io/mcp

### What are the best alternatives to Particle Health MCP by usefulapi?

The closest alternatives to Particle Health MCP by usefulapi are Tooluniverse, Oya Browser, Later Stages, MedXpert 标准检索连接器 and MedXpert 全球法规连接器 (reg-connector).

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Tooluniverse](https://ai-powered.com/mcp/tooluniverse): Tooluniverse is an open-source MCP server for health and science.
- [Oya Browser](https://ai-powered.com/mcp/oya-browser): Oya Browser is a freemium MCP server for browser automation.
- [Later Stages](https://ai-powered.com/mcp/later-stages): Later Stages is a free MCP server for health and science.
- [MedXpert 标准检索连接器](https://ai-powered.com/mcp/medxpert-2): MedXpert 标准检索连接器 is a free MCP server for legal and government.
- [MedXpert 全球法规连接器 (reg-connector)](https://ai-powered.com/mcp/medxpert-reg-connector): MedXpert 全球法规连接器 (reg-connector) is a free MCP server for legal and government.
- [Splyt](https://ai-powered.com/mcp/splyt): Splyt is a free MCP server for health and science.
- [Health Agent](https://ai-powered.com/mcp/health-agent): Health Agent is an MCP server for health and science.
- [Pausila](https://ai-powered.com/mcp/pausila): Pausila is a free MCP server for local services.

---
Source: https://ai-powered.com/mcp/particle-health-mcp-by-usefulapi
