# Metriport MCP by usefulapi

> Metriport MCP by usefulapi is an MCP server for health and science. Read and write patients, facilities, medical documents, and consolidated FHIR records in Metriport. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/metriport/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/metriport
- **MCP Registry name:** io.usefulapi/metriport
- **Categories:** health and science
- **Listing updated:** 2026-11-13

## About

Read and write patients, facilities, medical documents, and consolidated FHIR records in Metriport.

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `metriport_list_facilities`: List all Facilities under your Metriport Organization (id, name, npi, address). Medical API: GET /medical/v1/facility.
- `metriport_get_facility`: Get a single Facility by its Metriport ID. Medical API: GET /medical/v1/facility/{id}.
- `metriport_list_patients`: List Patients — all Patients, or only those at a given Facility if facilityId is supplied. Medical API: GET /medical/v1/patient.
- `metriport_get_patient`: Get a single Patient by its Metriport ID (demographics + facility IDs). Medical API: GET /medical/v1/patient/{id}.
- `metriport_list_documents`: List the document references currently available for a Patient at Metriport (optionally filtered by date range and content search). Medical API: GET /medical/v1/document.
- `metriport_get_document_query_status`: Check the progress/status of a Patient's document query (download + FHIR conversion counts). Medical API: POST /medical/v1/document/query with only patientId (no facilityId) returns current status without starting a new query.
- `metriport_get_document_url`: Get a temporary, downloadable URL for a document by its file name (optionally converting XML/CDA to html or pdf). Medical API: GET /medical/v1/document/download-url.
- `metriport_list_consolidated_queries`: Get the status of the Patient's consolidated-data (FHIR) queries. Medical API: GET /medical/v1/patient/{id}/consolidated/query.
- `metriport_get_medical_record_summary`: Get a URL to the Patient's medical record summary rendered as pdf or html. Medical API: GET /medical/v1/patient/{patientId}/medical-record.
- `metriport_create_patient`: Creates a Patient in Metriport (writes PHI and initiates health-information-exchange queries). Medical API: POST /medical/v1/patient (facilityId is a required query param).
- `metriport_start_document_query`: Starts a document query — retrieves the patient's medical documents from connected HIE networks. Returns a requestId; results arrive asynchronously. Medical API: POST /medical/v1/document/query (patientId and facilityId are required query params).
- `metriport_start_consolidated_query`: Starts a consolidated-data (FHIR) query for the patient. Returns a requestId; the bundle is delivered asynchronously (webhook). Medical API: POST /medical/v1/patient/{id}/consolidated/query.

## FAQ

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

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

### What are the best alternatives to Metriport MCP by usefulapi?

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

## 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/metriport-mcp-by-usefulapi
