# io.usefulapi/metriport (remote · metriport.usefulapi.io)

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

- Trust score: 18/100 (low)
- Change this week: −51
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `metriport.usefulapi.io`: 18/100 (this document), [markdown](https://verifymcp.io/servers/io-usefulapi-metriport/metriport.md), [page](https://verifymcp.io/servers/io-usefulapi-metriport/metriport)

## Channel facts

- Endpoint: `https://metriport.usefulapi.io/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.0.1`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 46/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not fully verified: no authorisation is required to connect, but we couldn't read the tool list to see what that exposes.
  - HTTPS not yet verified: we couldn't determine whether a plaintext access path exists.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 0/100
  - Transport check failed: declared streamable-http, but the endpoint returned HTTP 429.
- **Schema Quality & AI Usability**: 0/100
  - Schema not yet verified: we couldn't read the endpoint's schema.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 0/100
  - Tool coverage not yet verified: we couldn't read the endpoint's tools.
- **Capabilities**: 0/100
  - Capabilities not yet verified: we couldn't read the endpoint's capabilities.

**Unverified: 4 categories.** Categories scored 0 because we could not verify them: authentication we do not have, an unreachable endpoint, or not enough scan history. We only credit what we can confirm.

## Install

### Claude

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

### Codex

```toml
[mcp_servers.io-usefulapi-metriport]
url = "https://metriport.usefulapi.io/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "io-usefulapi-metriport": {
      "type": "remote",
      "url": "https://metriport.usefulapi.io/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add io-usefulapi-metriport --url https://metriport.usefulapi.io/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  io-usefulapi-metriport:
    url: "https://metriport.usefulapi.io/mcp"
```

### Other

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

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 18, −55)

- [security regression] Endpoint reachability: reachable → not serving MCP
- [security regression] Authorization: pass → unverified
- [security regression] Stability: 0.20 → unverified
- [security regression] Transport: pass → fail
- [functional regression] Tool coverage: 100 → unverified
- [functional regression] Capabilities: fail → unverified

### 2026-08-02 (score 73, +55)

- [security improvement] Authorization: unverified → pass
- [security improvement] Transport: fail → pass
- [functional regression] MCP protocol: unverified → fail
- [functional improvement] Endpoint reachability: not serving MCP → reachable
- [functional improvement] Tool coverage: unverified → 100
- [functional improvement] Stability: unverified → 0.20

### 2026-08-01 (score 18, −54)

- [security regression] Endpoint reachability: reachable → not serving MCP
- [security regression] Stability: 0.13 → unverified
- [security regression] Authorization: pass → unverified
- [security regression] Transport: pass → fail
- [functional regression] Capabilities: fail → unverified
- [functional regression] Tool coverage: 100 → unverified

### 2026-07-31 (score 72, +3)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 69, −2)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-29 (score 71, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-28 (score 70, +1)

- [functional improvement] Stability: unverified → 0.03

### 2026-07-27 (score 69, +57)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

## MCP tools (12)

### `metriport_list_facilities` (~42 tokens)

List facilities

List all Facilities under your Metriport Organization (id, name, npi, address). Medical API: GET /medical/v1/facility.

### `metriport_get_facility` (~49 tokens)

Get facility

Get a single Facility by its Metriport ID. Medical API: GET /medical/v1/facility/{id}.

Input parameters:

- `id` (string, required): The Metriport Facility ID.

### `metriport_list_patients` (~62 tokens)

List patients

List Patients — all Patients, or only those at a given Facility if facilityId is supplied. Medical API: GET /medical/v1/patient.

Input parameters:

- `facilityId` (string): Optional Facility ID to filter by. Omit to list all patients.

### `metriport_get_patient` (~53 tokens)

Get patient

Get a single Patient by its Metriport ID (demographics + facility IDs). Medical API: GET /medical/v1/patient/{id}.

Input parameters:

- `id` (string, required): The Metriport Patient ID.

### `metriport_list_documents` (~109 tokens)

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.

Input parameters:

- `content` (string): Text to search within the document reference and contents (min 3 chars).
- `dateFrom` (string): Inclusive start date yyyy-mm-dd.
- `dateTo` (string): Inclusive end date yyyy-mm-dd.
- `patientId` (string, required): The Patient ID whose available documents to list.

### `metriport_get_document_query_status` (~75 tokens)

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.

Input parameters:

- `patientId` (string, required): The Patient ID whose document-query status to check.

### `metriport_get_document_url` (~97 tokens)

Get document download 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.

Input parameters:

- `conversionType` (string): Optional doc type to convert to, e.g. pdf, html, xml (for XML/CDA files).
- `fileName` (string, required): The file name of the document (from metriport_list_documents).

### `metriport_list_consolidated_queries` (~58 tokens)

List consolidated queries

Get the status of the Patient's consolidated-data (FHIR) queries. Medical API: GET /medical/v1/patient/{id}/consolidated/query.

Input parameters:

- `id` (string, required): The Metriport Patient ID.

### `metriport_get_medical_record_summary` (~76 tokens)

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.

Input parameters:

- `conversionType` (string, required): The format to render: pdf or html.
- `patientId` (string, required): The Metriport Patient ID.

### `metriport_create_patient` (~194 tokens)

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).

Input parameters:

- `address` (array, required): One or more addresses for the Patient.
- `contact` (array): Optional contact info (phone / email).
- `dob` (string, required): Date of birth, yyyy-mm-dd.
- `facilityId` (string, required): REQUIRED. The Facility ID where the Patient receives care.
- `firstName` (string, required): The Patient's first name(s).
- `genderAtBirth` (string, required): Gender at birth: M, F, O (other), or U (unknown).
- `lastName` (string, required): The Patient's last name(s).
- `middleName` (string): The Patient's middle name(s).
- `personalIdentifiers` (array): Optional personal IDs (driver's license / SSN).

### `metriport_start_document_query` (~109 tokens)

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).

Input parameters:

- `facilityId` (string, required): REQUIRED. The Facility ID where the patient receives care.
- `metadata` (object): Optional custom string key-value pairs returned in the webhook.
- `patientId` (string, required): REQUIRED. The Patient ID to query documents for.

### `metriport_start_consolidated_query` (~156 tokens)

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.

Input parameters:

- `conversionType` (string): Output format: json, pdf, or html.
- `dateFrom` (string): Inclusive start date yyyy-mm-dd.
- `dateTo` (string): Inclusive end date yyyy-mm-dd.
- `id` (string, required): The Metriport Patient ID.
- `metadata` (object): Optional custom string key-value pairs returned in the webhook.
- `resources` (string): Comma-separated, case-sensitive list of FHIR resource types. Omit for all.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/io-usefulapi-metriport/metriport#diagnostics

## Score history

- 2026-08-03: 18
- 2026-08-02: 73
- 2026-08-01: 18
- 2026-07-31: 72
- 2026-07-30: 69
- 2026-07-29: 71
- 2026-07-28: 70
- 2026-07-27: 69
- 2026-07-26: 12

## Links

- Remote endpoint: https://metriport.usefulapi.io/mcp
- Repository: https://github.com/m190/usefulapi-mcp
- Changelog RSS feed: https://verifymcp.io/servers/io-usefulapi-metriport/metriport/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/io-usefulapi-metriport/metriport/changelog.json
- HTML version of this page: https://verifymcp.io/servers/io-usefulapi-metriport/metriport