Fhirhydrant MCP Server

A modern, fully configurable, open-source Node.js Model Context Protocol (MCP) server for R4+ FHIR APIs. It connects MCP-compatible LLM AI clients to clinical data over SMART on FHIR v2 Backend…

Local serverstdioKopimi

What is the Fhirhydrant MCP Server?

fhirhydrant is an MCP project maintained in the faulkj/fhirhydrant repository. The maintainer describes its purpose as “A modern, fully configurable, open-source Node.js Model Context Protocol (MCP) server for R4+ FHIR APIs. It connects MCP-compatible LLM AI clients to clinical data over…”. Read the project documentation for the complete scope.

Installation

The documented npm package is fhirhydrant. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares MCP_TRANSPORT, FHIR_BASE_URL, FHIR_CLIENT_ID, FHIR_ACTIVE_KEY, FHIR_JWKS_URL. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
Readonly batch Bundles (all GET entries) are allowed with just
system_historyServer advertises system history interaction and scopes allow it
capabilitiesAlways registered
paginateAlways registered
operateAt least one named operation passes gating
bundleFHIR_BUNDLE_CAPABILITIES is set
terminology_lookupLooks up one LOINC or SNOMED CT code
code_searchSearches codes by text filter with paging support
ActionRequired params
vread_id, _vid
history_id (instance) or none (type)
createbody
update_id, body
patch_id, body
delete_id

How to install the Fhirhydrant MCP Server

{
  "mcpServers": {
    "fhirhydrant": {
      "command": "npx",
      "args": [
        "-y",
        "fhirhydrant"
      ],
      "env": {
        "MCP_TRANSPORT": "stdio",
        "FHIR_BASE_URL": "https://fhir.example.org",
        "FHIR_CLIENT_ID": "your-client-id",
        "FHIR_ACTIVE_KEY": "YOUR_FHIR_ACTIVE_KEY",
        "FHIR_JWKS_URL": "https://example.org/.well-known/jwks.json"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
MCP_TRANSPORTDeclared in the maintainer’s client configuration.Check documentation
FHIR_BASE_URLDeclared in the maintainer’s client configuration.Check documentation
FHIR_CLIENT_IDDeclared in the maintainer’s client configuration.Check documentation
FHIR_ACTIVE_KEYDeclared in the maintainer’s client configuration.Check documentation
FHIR_JWKS_URLDeclared in the maintainer’s client configuration.Check documentation