The server marks this tool destructive: it may delete or overwrite data

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

destructive

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

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "facilityId",
    "firstName",
    "lastName",
    "dob",
    "genderAtBirth",
    "address"
  ],
  "properties": {
    "dob": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date of birth, yyyy-mm-dd."
    },
    "address": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "addressLine1",
          "city",
          "state",
          "zip"
        ],
        "properties": {
          "zip": {
            "type": "string",
            "description": "ZIP / postal code."
          },
          "city": {
            "type": "string",
            "description": "City."
          },
          "state": {
            "type": "string",
            "description": "2-letter US state code, e.g. CA."
          },
          "country": {
            "type": "string",
            "description": "Country. Defaults to USA."
          },
          "addressLine1": {
            "type": "string",
            "description": "Street address line 1."
          },
          "addressLine2": {
            "type": "string",
            "description": "Street address line 2 (apt/suite)."
          }
        }
      },
      "minItems": 1,
      "description": "One or more addresses for the Patient."
    },
    "contact": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string",
            "description": "Email address."
          },
          "phone": {
            "type": "string",
            "description": "10-digit phone number, e.g. 1234567890."
          }
        }
      },
      "description": "Optional contact info (phone / email)."
    },
    "lastName": {
      "type": "string",
      "description": "The Patient's last name(s)."
    },
    "firstName": {
      "type": "string",
      "description": "The Patient's first name(s)."
    },
    "facilityId": {
      "type": "string",
      "description": "REQUIRED. The Facility ID where the Patient receives care."
    },
    "middleName": {
      "type": "string",
      "description": "The Patient's middle name(s)."
    },
    "genderAtBirth": {
      "enum": [
        "M",
        "F",
        "O",
        "U"
      ],
      "type": "string",
      "description": "Gender at birth: M, F, O (other), or U (unknown)."
    },
    "personalIdentifiers": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "type",
          "value"
        ],
        "properties": {
          "type": {
            "enum": [
              "driversLicense",
              "ssn"
            ],
            "type": "string",
            "description": "Identifier type."
          },
          "state": {
            "type": "string",
            "description": "2-letter state code (required for driversLicense)."
          },
          "value": {
            "type": "string",
            "description": "The ID number."
          },
          "assigner": {
            "type": "string"
          }
        }
      },
      "description": "Optional personal IDs (driver's license / SSN)."
    }
  }
}

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.

read-only

Argument	Type	Description
patientId*	string	The Patient ID whose document-query status to check.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "patientId"
  ],
  "properties": {
    "patientId": {
      "type": "string",
      "description": "The Patient ID whose document-query status to check."
    }
  }
}

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.

read-only

Argument	Type	Description
fileName*	string	The file name of the document (from metriport_list_documents).
conversionType	string	Optional doc type to convert to, e.g. pdf, html, xml (for XML/CDA files).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "fileName"
  ],
  "properties": {
    "fileName": {
      "type": "string",
      "description": "The file name of the document (from metriport_list_documents)."
    },
    "conversionType": {
      "type": "string",
      "description": "Optional doc type to convert to, e.g. pdf, html, xml (for XML/CDA files)."
    }
  }
}

metriport_get_facility

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

read-only

Argument	Type	Description
id*	string	The Metriport Facility ID.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "The Metriport Facility ID."
    }
  }
}

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.

read-only

Argument	Type	Description
patientId*	string	The Metriport Patient ID.
conversionType*	string	The format to render: pdf or html.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "patientId",
    "conversionType"
  ],
  "properties": {
    "patientId": {
      "type": "string",
      "description": "The Metriport Patient ID."
    },
    "conversionType": {
      "enum": [
        "pdf",
        "html"
      ],
      "type": "string",
      "description": "The format to render: pdf or html."
    }
  }
}

metriport_get_patient

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

read-only

Argument	Type	Description
id*	string	The Metriport Patient ID.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "The Metriport Patient ID."
    }
  }
}

metriport_list_consolidated_queries

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

read-only

Argument	Type	Description
id*	string	The Metriport Patient ID.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "The Metriport 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.

read-only

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

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "patientId"
  ],
  "properties": {
    "dateTo": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Inclusive end date yyyy-mm-dd."
    },
    "content": {
      "type": "string",
      "description": "Text to search within the document reference and contents (min 3 chars)."
    },
    "dateFrom": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Inclusive start date yyyy-mm-dd."
    },
    "patientId": {
      "type": "string",
      "description": "The Patient ID whose available documents to list."
    }
  }
}

metriport_list_facilities

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

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

metriport_list_patients

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

read-only

Argument	Type	Description
facilityId	string	Optional Facility ID to filter by. Omit to list all patients.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "facilityId": {
      "type": "string",
      "description": "Optional Facility ID to filter by. Omit to list all patients."
    }
  }
}

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.

destructive

Argument	Type	Description
id*	string	The Metriport Patient ID.
dateTo	string	Inclusive end date yyyy-mm-dd.
dateFrom	string	Inclusive start date yyyy-mm-dd.
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.
conversionType	string	Output format: json, pdf, or html.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "The Metriport Patient ID."
    },
    "dateTo": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Inclusive end date yyyy-mm-dd."
    },
    "dateFrom": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Inclusive start date yyyy-mm-dd."
    },
    "metadata": {
      "type": "object",
      "description": "Optional custom string key-value pairs returned in the webhook.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "string"
      }
    },
    "resources": {
      "type": "string",
      "description": "Comma-separated, case-sensitive list of FHIR resource types. Omit for all."
    },
    "conversionType": {
      "enum": [
        "json",
        "pdf",
        "html"
      ],
      "type": "string",
      "description": "Output format: json, pdf, or html."
    }
  }
}

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

destructive

Argument	Type	Description
metadata	object	Optional custom string key-value pairs returned in the webhook.
patientId*	string	REQUIRED. The Patient ID to query documents for.
facilityId*	string	REQUIRED. The Facility ID where the patient receives care.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "patientId",
    "facilityId"
  ],
  "properties": {
    "metadata": {
      "type": "object",
      "description": "Optional custom string key-value pairs returned in the webhook.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "string"
      }
    },
    "patientId": {
      "type": "string",
      "description": "REQUIRED. The Patient ID to query documents for."
    },
    "facilityId": {
      "type": "string",
      "description": "REQUIRED. The Facility ID where the patient receives care."
    }
  }
}

Metriport MCP by usefulapi

Try it

metriport_create_patient Destructive

Metriport MCP by usefulapi

Try it

metriport_create_patient Destructive

Tools (12)