metriport

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

使うべきか

品質と安全性

A
説明の品質
100%
スキーマの完全性
93%
命名の品質
73%
ポイズニングのリスク
100%
権限の一致
100%
プロトコルへの準拠
100%

検出事項(4)

  • LOWTool 'metriport_get_document_query_status' name length outside 3-30 rangemetriport_get_document_query_status 内
  • LOWTool 'metriport_list_consolidated_queries' name length outside 3-30 rangemetriport_list_consolidated_queries 内
  • LOWTool 'metriport_get_medical_record_summary' name length outside 3-30 rangemetriport_get_medical_record_summary 内
  • LOWTool 'metriport_start_consolidated_query' name length outside 3-30 rangemetriport_start_consolidated_query 内

ツール定義とプロトコルへの準拠に関する自動分析に基づいています。

コンテキストコスト

~2,155トークン数(ツール定義)
~1.3 KB一般的なレスポンスサイズ
注意への影響は中程度(128k コンテキストの 1.68%)

これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。

インストール

ワンクリックインストール

これを `claude_desktop_config.json` ファイルに追加してください:

{
  "mcpServers": {
    "metriport": {
      "url": "https://metriport.usefulapi.io/mcp"
    }
  }
}

リモートエンドポイント

https://metriport.usefulapi.io/mcpstreamable-http

できること

ツール一覧

ツール(12)

🟢 読み取り専用🟡 書き込み🔴 削除⚪ 不明
🟢metriport_list_facilities

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

入力スキーマ

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢metriport_get_facility(id)

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

入力スキーマ

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The Metriport Facility ID."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢metriport_list_patients(facilityId)

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

入力スキーマ

{
  "type": "object",
  "properties": {
    "facilityId": {
      "description": "Optional Facility ID to filter by. Omit to list all patients.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢metriport_get_patient(id)

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

入力スキーマ

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The Metriport Patient ID."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢metriport_list_documents(patientId, dateFrom, dateTo, content)

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.

入力スキーマ

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

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.

入力スキーマ

{
  "type": "object",
  "properties": {
    "patientId": {
      "type": "string",
      "description": "The Patient ID whose document-query status to check."
    }
  },
  "required": [
    "patientId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢metriport_get_document_url(fileName, conversionType)

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.

入力スキーマ

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

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

入力スキーマ

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The Metriport Patient ID."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢metriport_get_medical_record_summary(patientId, conversionType)

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

入力スキーマ

{
  "type": "object",
  "properties": {
    "patientId": {
      "type": "string",
      "description": "The Metriport Patient ID."
    },
    "conversionType": {
      "type": "string",
      "enum": [
        "pdf",
        "html"
      ],
      "description": "The format to render: pdf or html."
    }
  },
  "required": [
    "patientId",
    "conversionType"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🔴metriport_create_patient(facilityId, firstName, lastName, dob, genderAtBirth, ...)

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

入力スキーマ

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

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

入力スキーマ

{
  "type": "object",
  "properties": {
    "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."
    },
    "metadata": {
      "description": "Optional custom string key-value pairs returned in the webhook.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "string"
      }
    }
  },
  "required": [
    "patientId",
    "facilityId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🔴metriport_start_consolidated_query(id, resources, dateFrom, dateTo, conversionType, ...)

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.

入力スキーマ

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

コミュニティ

このサーバーを評価する

エビデンス

最近の観測

検証済みバージョンは記録されていませんツール 12 件