FHIR MCP server with SMART Backend Services, response compaction, FHIRPath, and guarded writes.
Connect Runs on your machine
claude mcp add fhirhydrant -e MCP_TRANSPORT=<MCP_TRANSPORT> -e FHIR_AUTH=<FHIR_AUTH> -e FHIR_SERVER_URL=<FHIR_SERVER_URL> -e FHIR_TOKEN_URL=<FHIR_TOKEN_URL> -e FHIR_CLIENT_ID=<FHIR_CLIENT_ID> -e FHIR_ACTIVE_KEY=<FHIR_ACTIVE_KEY> -e FHIR_JWKS_URL=<FHIR_JWKS_URL> -e FHIR_VERSION=<FHIR_VERSION> -- npx -y [email protected]{
"mcpServers": {
"fhirhydrant": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"MCP_TRANSPORT": "<MCP_TRANSPORT>",
"FHIR_AUTH": "<FHIR_AUTH>",
"FHIR_SERVER_URL": "<FHIR_SERVER_URL>",
"FHIR_TOKEN_URL": "<FHIR_TOKEN_URL>",
"FHIR_CLIENT_ID": "<FHIR_CLIENT_ID>",
"FHIR_ACTIVE_KEY": "<FHIR_ACTIVE_KEY>",
"FHIR_JWKS_URL": "<FHIR_JWKS_URL>",
"FHIR_VERSION": "<FHIR_VERSION>"
}
}
}
}{
"mcpServers": {
"fhirhydrant": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"MCP_TRANSPORT": "<MCP_TRANSPORT>",
"FHIR_AUTH": "<FHIR_AUTH>",
"FHIR_SERVER_URL": "<FHIR_SERVER_URL>",
"FHIR_TOKEN_URL": "<FHIR_TOKEN_URL>",
"FHIR_CLIENT_ID": "<FHIR_CLIENT_ID>",
"FHIR_ACTIVE_KEY": "<FHIR_ACTIVE_KEY>",
"FHIR_JWKS_URL": "<FHIR_JWKS_URL>",
"FHIR_VERSION": "<FHIR_VERSION>"
}
}
}
}{
"servers": {
"fhirhydrant": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"MCP_TRANSPORT": "<MCP_TRANSPORT>",
"FHIR_AUTH": "<FHIR_AUTH>",
"FHIR_SERVER_URL": "<FHIR_SERVER_URL>",
"FHIR_TOKEN_URL": "<FHIR_TOKEN_URL>",
"FHIR_CLIENT_ID": "<FHIR_CLIENT_ID>",
"FHIR_ACTIVE_KEY": "<FHIR_ACTIVE_KEY>",
"FHIR_JWKS_URL": "<FHIR_JWKS_URL>",
"FHIR_VERSION": "<FHIR_VERSION>"
}
}
}
}Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
MCP_TRANSPORTRequired | Run the installed package over MCP stdio. |
FHIR_AUTHRequired | FHIR authentication mode. Use none only for an unauthenticated FHIR endpoint. |
FHIR_SERVER_URLRequired | Full base URL of the FHIR API, such as https://fhir.example.org/fhir/R4. |
FHIR_TOKEN_URLOptional | SMART Backend Services token endpoint. Required when FHIR_AUTH=smart unless it can be derived from FHIR_BASE_URL. |
FHIR_CLIENT_IDOptional | SMART Backend Services client ID. Required when FHIR_AUTH=smart. |
FHIR_ACTIVE_KEYOptional, secret | Base64-encoded PKCS#8 private signing key. Required when FHIR_AUTH=smart. |
FHIR_JWKS_URLOptional | Externally reachable JWKS URL for the signing key. Recommended for SMART authentication over stdio. |
FHIR_VERSIONOptional | FHIR release used for FHIRPath and response shaping. |
Details
| Package | [email protected] (NPM, stdio) |
| First published | 27 Aug 2026 |
| Last updated | 27 Aug 2026 |
| Registry name | io.github.faulkj/fhirhydrant |
More other servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.