Skip to content
MCP server

Fhirhydrant

FHIR MCP server with SMART Backend Services, response compaction, FHIRPath, and guarded…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.17.3
Listing updated
4 days ago

About Fhirhydrant

Fhirhydrant is an open-source MCP server. It runs locally on your machine and is started by your AI client.

FHIR MCP server with SMART Backend Services, response compaction, FHIRPath, and guarded writes.

Install

Run in a terminal

claude mcp add fhirhydrant --env MCP_TRANSPORT='<MCP_TRANSPORT>' --env FHIR_AUTH='<FHIR_AUTH>' --env FHIR_SERVER_URL='<FHIR_SERVER_URL>' --env FHIR_ACTIVE_KEY='<FHIR_ACTIVE_KEY>' -- npx -y fhirhydrant

Add to claude_desktop_config.json

{
  "mcpServers": {
    "fhirhydrant": {
      "command": "npx",
      "args": [
        "-y",
        "fhirhydrant"
      ],
      "env": {
        "MCP_TRANSPORT": "<MCP_TRANSPORT>",
        "FHIR_AUTH": "<FHIR_AUTH>",
        "FHIR_SERVER_URL": "<FHIR_SERVER_URL>",
        "FHIR_ACTIVE_KEY": "<FHIR_ACTIVE_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "fhirhydrant": {
      "command": "npx",
      "args": [
        "-y",
        "fhirhydrant"
      ],
      "env": {
        "MCP_TRANSPORT": "<MCP_TRANSPORT>",
        "FHIR_AUTH": "<FHIR_AUTH>",
        "FHIR_SERVER_URL": "<FHIR_SERVER_URL>",
        "FHIR_ACTIVE_KEY": "<FHIR_ACTIVE_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "fhirhydrant": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "fhirhydrant"
      ],
      "env": {
        "MCP_TRANSPORT": "<MCP_TRANSPORT>",
        "FHIR_AUTH": "<FHIR_AUTH>",
        "FHIR_SERVER_URL": "<FHIR_SERVER_URL>",
        "FHIR_ACTIVE_KEY": "<FHIR_ACTIVE_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "fhirhydrant": {
      "command": "npx",
      "args": [
        "-y",
        "fhirhydrant"
      ],
      "env": {
        "MCP_TRANSPORT": "<MCP_TRANSPORT>",
        "FHIR_AUTH": "<FHIR_AUTH>",
        "FHIR_SERVER_URL": "<FHIR_SERVER_URL>",
        "FHIR_ACTIVE_KEY": "<FHIR_ACTIVE_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "fhirhydrant": {
      "command": "npx",
      "args": [
        "-y",
        "fhirhydrant"
      ],
      "env": {
        "MCP_TRANSPORT": "<MCP_TRANSPORT>",
        "FHIR_AUTH": "<FHIR_AUTH>",
        "FHIR_SERVER_URL": "<FHIR_SERVER_URL>",
        "FHIR_ACTIVE_KEY": "<FHIR_ACTIVE_KEY>"
      }
    }
  }
}

Configuration

  • MCP_TRANSPORTRun the installed package over MCP stdio.Required
  • FHIR_AUTHFHIR authentication mode. Use none only for an unauthenticated FHIR endpoint.Required
  • FHIR_SERVER_URLFull base URL of the FHIR API, such as https://fhir.example.org/fhir/R4.Required
  • FHIR_TOKEN_URLSMART Backend Services token endpoint. Required when FHIR_AUTH=smart unless it can be derived from FHIR_BASE_URL.
  • FHIR_CLIENT_IDSMART Backend Services client ID. Required when FHIR_AUTH=smart.
  • FHIR_ACTIVE_KEYBase64-encoded PKCS#8 private signing key. Required when FHIR_AUTH=smart.
  • FHIR_JWKS_URLExternally reachable JWKS URL for the signing key. Recommended for SMART authentication over stdio.
  • FHIR_VERSIONFHIR release used for FHIRPath and response shaping.

Pricing

Open source

Fhirhydrant FAQ

Is Fhirhydrant free?

Yes. Fhirhydrant is open source, so you can use and self-host it for free.

How do I add Fhirhydrant to Claude Code?

Run this command in your terminal: claude mcp add fhirhydrant --env MCP_TRANSPORT='<MCP_TRANSPORT>' --env FHIR_AUTH='<FHIR_AUTH>' --env FHIR_SERVER_URL='<FHIR_SERVER_URL>' --env FHIR_ACTIVE_KEY='<FHIR_ACTIVE_KEY>' -- npx -y fhirhydrant