Skip to main content
Glama

Metriport MCP by usefulapi

by io.usefulapi
OverviewDiscussionsAdmin

Server Details

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

If you are the author of this connector, you can claim ownership by verifying the domain or GitHub account it belongs to. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Uptime
79.1% over 55 days
Last Tested
Transport
Streamable HTTP · MCP 2025-06-18
URL
Repository
m190/usefulapi-mcp
GitHub Stars
0

TDQS

A3.8/5.0

Scored across 12 tools

Disambiguation5/5

Each tool has a clearly distinct purpose: patient creation, document and query status, facility retrieval, listing patients/facilities/documents, and starting queries. No overlap or ambiguity.

Naming Consistency5/5

All tools follow a consistent 'metriport_verb_noun' pattern with 'get' for single items, 'list' for multiples, and 'start' for initiating asynchronous queries. No mixing of conventions.

Tool Count5/5

12 tools appropriately cover the core medical data operations: patient management, facility management, document queries, and consolidated data queries. The scope is well-balanced.

Completeness2/5

The tool set lacks update and delete operations for patients and facilities, which are essential for full lifecycle management. Key CRUD actions are missing, creating potential dead ends.

Available Tools

12 tools
metriport_create_patientCreate patient
Destructive
Inspect

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

ParametersJSON Schema
NameRequiredDescriptionDefault
dobYesDate of birth, yyyy-mm-dd.
addressYesOne or more addresses for the Patient.
contactNoOptional contact info (phone / email).
lastNameYesThe Patient's last name(s).
firstNameYesThe Patient's first name(s).
facilityIdYesREQUIRED. The Facility ID where the Patient receives care.
middleNameNoThe Patient's middle name(s).
genderAtBirthYesGender at birth: M, F, O (other), or U (unknown).
personalIdentifiersNoOptional personal IDs (driver's license / SSN).
metriport_get_document_query_statusGet document query status
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
patientIdYesThe Patient ID whose document-query status to check.
metriport_get_document_urlGet document download URL
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
fileNameYesThe file name of the document (from metriport_list_documents).
conversionTypeNoOptional doc type to convert to, e.g. pdf, html, xml (for XML/CDA files).
metriport_get_facilityGet facility
Read-only
Inspect

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

ParametersJSON Schema
NameRequiredDescriptionDefault
idYesThe Metriport Facility ID.
metriport_get_medical_record_summaryGet medical record summary
Read-only
Inspect

Get a URL to the Patient's medical record summary rendered as pdf or html. Medical API: GET /medical/v1/patient/{patientId}/medical-record.

ParametersJSON Schema
NameRequiredDescriptionDefault
patientIdYesThe Metriport Patient ID.
conversionTypeYesThe format to render: pdf or html.
metriport_get_patientGet patient
Read-only
Inspect

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

ParametersJSON Schema
NameRequiredDescriptionDefault
idYesThe Metriport Patient ID.
metriport_list_consolidated_queriesList consolidated queries
Read-only
Inspect

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

ParametersJSON Schema
NameRequiredDescriptionDefault
idYesThe Metriport Patient ID.
metriport_list_documentsList documents
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
dateToNoInclusive end date yyyy-mm-dd.
contentNoText to search within the document reference and contents (min 3 chars).
dateFromNoInclusive start date yyyy-mm-dd.
patientIdYesThe Patient ID whose available documents to list.
metriport_list_facilitiesList facilities
Read-only
Inspect

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

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

metriport_list_patientsList patients
Read-only
Inspect

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

ParametersJSON Schema
NameRequiredDescriptionDefault
facilityIdNoOptional Facility ID to filter by. Omit to list all patients.
metriport_start_consolidated_queryStart consolidated query
Destructive
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
idYesThe Metriport Patient ID.
dateToNoInclusive end date yyyy-mm-dd.
dateFromNoInclusive start date yyyy-mm-dd.
metadataNoOptional custom string key-value pairs returned in the webhook.
resourcesNoComma-separated, case-sensitive list of FHIR resource types. Omit for all.
conversionTypeNoOutput format: json, pdf, or html.
metriport_start_document_queryStart document query
Destructive
Inspect

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

ParametersJSON Schema
NameRequiredDescriptionDefault
metadataNoOptional custom string key-value pairs returned in the webhook.
patientIdYesREQUIRED. The Patient ID to query documents for.
facilityIdYesREQUIRED. The Facility ID where the patient receives care.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 12 tool updates
    • Changedmetriport_create_patient1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedmetriport_get_document_query_status1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedmetriport_get_document_url1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedmetriport_get_facility1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedmetriport_get_medical_record_summary1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedmetriport_get_patient1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedmetriport_list_consolidated_queries1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedmetriport_list_documents1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedmetriport_list_facilities1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedmetriport_list_patients1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedmetriport_start_consolidated_query1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedmetriport_start_document_query1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
  2. 12 tool updates
    • First observedmetriport_create_patient
    • First observedmetriport_get_document_query_status
    • First observedmetriport_get_document_url
    • First observedmetriport_get_facility
    • First observedmetriport_get_medical_record_summary
    • First observedmetriport_get_patient
    • First observedmetriport_list_consolidated_queries
    • First observedmetriport_list_documents
    • First observedmetriport_list_facilities
    • First observedmetriport_list_patients
    • First observedmetriport_start_consolidated_query
    • First observedmetriport_start_document_query

Related MCP Connectors

Related MCP Servers

  • MCP FHIR Server

    mrosata
    F
    license
    A
    quality
    D
    maintenance
    Provides read/write access to any FHIR-compliant healthcare API with built-in validation, supporting resource management, search operations, and granular permissions through natural language.
    5
    1
    -

  • FHIR MCP Server

    sumithasb
    A
    license
    Not graded
    quality
    Not graded
    maintenance
    Enables seamless integration with FHIR APIs for healthcare applications, allowing users to search, retrieve, create, update, and analyze clinical information through natural language interactions. Supports SMART-on-FHIR authentication and works with various healthcare systems like EPIC and HAPI FHIR servers.
    Apache 2.0
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources