About Metriport MCP by usefulapi
A hosted MCP server for using Metriport from MCP clients. It supports reading patient, facility, document, and consolidated FHIR data, plus creating patients and starting queries.
Key features
- 01List and retrieve facilities
- 02List and retrieve patients
- 03Read documents and query status
- 04View medical record summaries
- 05Create patients and start queries
Use cases
- 01Review a patient's medical record summary
- 02Find documents and download their URLs
- 03Create a patient in Metriport
MCP support
Exposes Metriport read and write tools to MCP clients through a hosted remote server. Clients connect to its endpoint and authenticate with OAuth using a Metriport API key.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://metriport.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-metriport https://metriport.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-metriport":{"type":"http","url":"https://metriport.usefulapi.io/mcp"}}}Open in Cursor{"servers":{"io-usefulapi-metriport":{"type":"http","url":"https://metriport.usefulapi.io/mcp"}}}Open in VS Code{"mcpServers":{"io-usefulapi-metriport":{"type":"http","url":"https://metriport.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-metriport":{"serverUrl":"https://metriport.usefulapi.io/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
12This tool takes no parameters.
Details
From the project READMEMetriport 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/mcpto log in. - VS Code: Add to VS Code.
- Cursor and other clients: add the URL as a remote MCP server:
{
"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
| Tool | Type | What it does |
|---|---|---|
metriport_list_facilities | read | List facilities |
metriport_get_facility | read | Get facility |
metriport_list_patients | read | List patients |
metriport_get_patient | read | Get patient |
metriport_list_documents | read | List documents |
metriport_get_document_query_status | read | Get document query status |
metriport_get_document_url | read | Get document download URL |
metriport_list_consolidated_queries | read | List consolidated queries |
metriport_get_medical_record_summary | read | Get medical record summary |
metriport_create_patient | write | Create patient |
metriport_start_document_query | write | Start document query |
metriport_start_consolidated_query | write | Start consolidated query |
metriport_usage_status | meta | Usage status (free-tier meter) |
metriport_request_feature | meta | Request a missing feature |
metriport_upgrade | meta | Upgrade to Pro (unlimited*) |
metriport_cancel_subscription | meta | Cancel 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
| Plan | Price | Limit |
|---|---|---|
| Free | $0 | 50 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.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.