Fhirhydrant
FHIR MCP server with SMART Backend Services, response compaction, FHIRPath, and guarded…
- 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 fhirhydrantAdd 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.RequiredFHIR_AUTHFHIR authentication mode. Use none only for an unauthenticated FHIR endpoint.RequiredFHIR_SERVER_URLFull base URL of the FHIR API, such as https://fhir.example.org/fhir/R4.RequiredFHIR_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