Metriport MCP server. Read and write patients, facilities, medical documents, and consolidated FHIR records in Metriport.
Add to your MCP config, then reload & authorize:
{
"mcpServers": {
"metriport": {
"url": "https://metriport.usefulapi.io/mcp"
}
}
}| Tool | Type | What it does |
|---|---|---|
metriport_list_facilities | read | List facilities Lists every Facility under your Metriport Organization, returning each facility's id, name, NPI, and address so you can pick where patients receive care. |
metriport_get_facility | read | Get facility Fetches a single Facility by its Metriport ID, returning its full detail record including name, NPI, and address. |
metriport_list_patients | read | List patients Lists Patients across your Organization, optionally narrowed to a single Facility, so you can find a patient's Metriport ID and demographics. |
metriport_get_patient | read | Get patient Retrieves one Patient by Metriport ID, returning demographics and the facility IDs the patient is associated with. |
metriport_list_documents | read | List documents Lists the medical document references currently available for a Patient, with optional date-range and full-text content filters to zero in on relevant records. |
metriport_get_document_query_status | read | Get document query status Reports the progress of a Patient's document query — download and FHIR-conversion counts — without kicking off a new retrieval. |
metriport_get_document_url | read | Get document url Returns a temporary, downloadable URL for a specific document by file name, optionally converting XML/CDA source into html or pdf. |
metriport_list_consolidated_queries | read | List consolidated queries Returns the status of a Patient's consolidated-data (FHIR) queries so you can tell when a requested bundle is ready. |
metriport_get_medical_record_summary | read | Get medical record summary Returns a URL to the Patient's full medical record summary rendered as pdf or html for quick human review. |
metriport_create_patient | write | Create patient Creates a Patient at a given Facility (name, DOB, gender, address, optional identifiers and contacts) and initiates health-information-exchange queries for them. |
metriport_start_document_query | write | Start document query Starts a document query that retrieves a patient's medical documents from connected HIE networks, returning a requestId while results arrive asynchronously. |
metriport_start_consolidated_query | write | Start consolidated query Starts a consolidated-data (FHIR) query for a patient — filterable by resource types, date range, and output format — with the bundle delivered asynchronously. |
metriport_usage_status | Usage status (free-tier meter) Report the caller's current free-tier usage this month: calls used, monthly limit, remaining, and whether the cap is reached. Read-only; does not count against the meter. | |
metriport_upgrade | Upgrade to Pro (unlimited) Subscribe to the Pro plan for UNLIMITED Metriport tool calls (the free tier caps monthly usage). Choose monthly ($9/month) or yearly ($90/year — 2 months free) billing. Returns a Stripe Checkout link to open in your browser; after payment your account upgrades automatically. Read-only; does not count against the meter. |
| Plan | Price | Limit |
|---|---|---|
| Free | $0 | 100 tool calls / month |
| Pro | $9/mo · $90/yr | Unlimited |
This is a Model Context Protocol endpoint — meant to be connected from an AI client, not opened in a browser. An invalid_token response at the URL is the auth gate working as designed; clients authenticate automatically.