Metriport MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.36.5Updated Nov 8, 2026

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

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableLocation & LifestyleData & Analytics

Overview

AI-generated overview

Hosted MCP server that lets an assistant read and write Metriport health data: facilities, patients, medical documents and FHIR records.

What you can do
  • List and look up facilities and patients, optionally filtered by facility
  • List a patient's document references and check document query progress
  • Get temporary download URLs for documents, with optional XML/CDA conversion to HTML or PDF
  • Check consolidated FHIR query status and get a medical record summary as PDF or HTML
  • Create patients and start document or consolidated-data queries
  • Report usage, request a feature, and upgrade or cancel a paid plan
When to use it
Useful when you work with Metriport as your health-information-exchange platform and want an assistant to browse facilities and patients, pull medical documents or FHIR records, or kick off retrieval queries without writing API calls yourself.
Requirements
Remote endpoint only, no local install; connect the MCP URL in your client. Sign-in is via OAuth, and on first connect you paste your Metriport API key, which is validated and stored per user. Do not add an Authorization header or API key to the client config. A paid plan is needed beyond the free monthly call allowance.
Before you install
Handles protected health information: creating patients writes PHI and triggers HIE queries, and document or consolidated queries start asynchronous retrieval. Confirm before any write tool. The API key is stored by the third-party host. Usage is metered (free tier 50 calls/month) and paid plans are billed through Stripe checkout links; cancellation gives no refund for the current period.

Installation

In SourceWeft

  1. Open Metriport MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Fmetriport/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

Metriport MCP by usefulapi

Query patients, facilities, medical documents, and FHIR records from Claude, Cursor, or any MCP client. Hosted, no local install — connect with your Metriport API key.

Live endpoint: https://metriport.usefulapi.io/mcp · Homepage: https://usefulapi.io/metriport

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://metriport.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http metriport https://metriport.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "metriport": {      "url": "https://metriport.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Metriport credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/metriport/

On first connect you'll paste your Metriport API key. It's validated, stored per-user, and scoped to you.

Tools

ToolTypeWhat it does
metriport_list_facilitiesreadList facilities
metriport_get_facilityreadGet facility
metriport_list_patientsreadList patients
metriport_get_patientreadGet patient
metriport_list_documentsreadList documents
metriport_get_document_query_statusreadGet document query status
metriport_get_document_urlreadGet document download URL
metriport_list_consolidated_queriesreadList consolidated queries
metriport_get_medical_record_summaryreadGet medical record summary
metriport_create_patientwriteCreate patient
metriport_start_document_querywriteStart document query
metriport_start_consolidated_querywriteStart consolidated query
metriport_usage_statusmetaUsage status (free-tier meter)
metriport_request_featuremetaRequest a missing feature
metriport_upgrademetaUpgrade to Pro or Pro+
metriport_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with metriport_upgrade (it returns a Stripe Checkout link). Cancel any time with metriport_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running metriport_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

Source: servers/metriport/README.md at commit 4046075

Tools

12

metriport_list_facilities

List facilities

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

Takes no parameters.

metriport_get_facility

Get facility

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

Parametersidrequired

metriport_list_patients

List patients

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

ParametersfacilityId

metriport_get_patient

Get patient

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

Parametersidrequired

metriport_list_documents

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.

ParametersdateTocontentdateFrompatientIdrequired

metriport_get_document_query_status

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.

ParameterspatientIdrequired

metriport_get_document_url

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.

ParametersfileNamerequiredconversionType

metriport_list_consolidated_queries

List consolidated queries

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

Parametersidrequired

metriport_get_medical_record_summary

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.

ParameterspatientIdrequiredconversionTyperequired

metriport_create_patient

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

ParametersdobrequiredaddressrequiredcontactlastNamerequiredfirstNamerequiredfacilityIdrequiredmiddleNamegenderAtBirthrequiredpersonalIdentifiers

metriport_start_document_query

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

ParametersmetadatapatientIdrequiredfacilityIdrequired

metriport_start_consolidated_query

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.

ParametersidrequireddateTodateFrommetadataresourcesconversionType

Version history

22
  1. v1.36.5LatestNov 8, 2026
  2. v1.36.4Nov 7, 2026
  3. v1.35.3Nov 5, 2026
  4. v1.35.2Nov 5, 2026
  5. v1.35.1Nov 4, 2026
  6. v1.35.0Nov 3, 2026
  7. v1.34.1Nov 3, 2026
  8. v1.33.0Nov 1, 2026
  9. v1.31.0Oct 31, 2026
  10. v1.30.0Oct 31, 2026
  11. v1.29.2Oct 30, 2026
  12. v1.29.0Oct 30, 2026
  13. v1.24.0Oct 26, 2026
  14. v1.21.3Oct 25, 2026
  15. v1.21.0Oct 25, 2026
  16. v1.20.0Oct 24, 2026
  17. v1.17.0Oct 23, 2026
  18. v1.16.4Oct 22, 2026
  19. v1.16.3Oct 21, 2026
  20. v1.11.1Oct 9, 2026
  21. v1.10.0Oct 9, 2026
  22. v1.0.1Sep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations

Ably MCP by usefulapi

io.usefulapiOfficial publisher

Hosted MCP server for Ably realtime messaging: inspect channel history, presence and occupancy, publish messages, and review app usage and configuration.

Streamable HTTPWeb executable
Cloud & Infrastructure15 toolsNov 8, 2026

Zomentum MCP by usefulapi

io.usefulapiOfficial publisher

Hosted MCP server that lets an assistant read Zomentum sales data — opportunities, pipelines, clients, documents, catalog items and activities — and create…

Streamable HTTPWeb executable
Productivity & Workflow25 toolsNov 8, 2026

Zero Plus One MCP by usefulapi

io.usefulapiOfficial publisher

Read-only access to Zero Plus One accounting data — invoices, quotes, contacts, financial reports and bank reconciliation — from an MCP client.

Streamable HTTPWeb executable
Finance24 toolsNov 8, 2026

Zenkit MCP by usefulapi

io.usefulapiOfficial publisher

Hosted, read-only MCP access to Zenkit: browse workspaces, lists, fields, members and entries, and search entries by text.

Streamable HTTPWeb executable
Productivity & Workflow9 toolsNov 8, 2026

Zaui MCP by usefulapi

io.usefulapiOfficial publisher

Read-only access to a Zaui booking system: activities, availability, product stock, bookings and day manifests.

Streamable HTTPWeb executable
Productivity & Workflow9 toolsNov 8, 2026