Fhirhydrant MCP Server
by faulkjio.github.faulkj/fhirhydrantv0.17.3
FHIR MCP server with SMART Backend Services, response compaction, FHIRPath, and guarded writes.
context tax
queued
security
queued
cold start
queued
freshness
Active25d ago
Install Fhirhydrant MCP server
Install in Claude Code
claude mcp add fhirhydrant -e MCP_TRANSPORT='<mcp-transport>' -e FHIR_AUTH=smart -e FHIR_SERVER_URL='<fhir-server-url>' -e FHIR_ACTIVE_KEY='<fhir-active-key>' -- npx -y fhirhydrantInstall in Cursor
{
"mcpServers": {
"fhirhydrant": {
"command": "npx",
"args": [
"-y",
"fhirhydrant"
],
"env": {
"MCP_TRANSPORT": "<mcp-transport>",
"FHIR_AUTH": "smart",
"FHIR_SERVER_URL": "<fhir-server-url>",
"FHIR_ACTIVE_KEY": "<fhir-active-key>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"fhirhydrant": {
"command": "npx",
"args": [
"-y",
"fhirhydrant"
],
"env": {
"MCP_TRANSPORT": "<mcp-transport>",
"FHIR_AUTH": "smart",
"FHIR_SERVER_URL": "<fhir-server-url>",
"FHIR_ACTIVE_KEY": "<fhir-active-key>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"fhirhydrant": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"fhirhydrant"
],
"env": {
"MCP_TRANSPORT": "<mcp-transport>",
"FHIR_AUTH": "smart",
"FHIR_SERVER_URL": "<fhir-server-url>",
"FHIR_ACTIVE_KEY": "<fhir-active-key>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"fhirhydrant": {
"command": "npx",
"args": [
"-y",
"fhirhydrant"
],
"env": {
"MCP_TRANSPORT": "<mcp-transport>",
"FHIR_AUTH": "smart",
"FHIR_SERVER_URL": "<fhir-server-url>",
"FHIR_ACTIVE_KEY": "<fhir-active-key>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| MCP_TRANSPORT | yes | — | Run the installed package over MCP stdio. |
| FHIR_AUTH | yes | — | FHIR authentication mode. Use none only for an unauthenticated FHIR endpoint. |
| FHIR_SERVER_URL | yes | — | Full base URL of the FHIR API, such as https://fhir.example.org/fhir/R4. |
| FHIR_TOKEN_URL | — | — | SMART Backend Services token endpoint. Required when FHIR_AUTH=smart unless it can be derived from FHIR_BASE_URL. |
| FHIR_CLIENT_ID | — | — | SMART Backend Services client ID. Required when FHIR_AUTH=smart. |
| FHIR_ACTIVE_KEY | — | yes | Base64-encoded PKCS#8 private signing key. Required when FHIR_AUTH=smart. |
| FHIR_JWKS_URL | — | — | Externally reachable JWKS URL for the signing key. Recommended for SMART authentication over stdio. |
| FHIR_VERSION | — | — | FHIR release used for FHIRPath and response shaping. |
Freshness
Active — last maintenance signal 25d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-09-15 · 25d ago · GitHub
Latest release
2026-08-27 · 43d ago · GitHub · v0.17.3
Package published
no data · npm/PyPI
Registry entry updated
2026-08-27 · 43d ago · official registry · v0.17.3
FAQ
›How do I install the Fhirhydrant MCP server in Claude Code?
Run: claude mcp add fhirhydrant -e MCP_TRANSPORT='<mcp-transport>' -e FHIR_AUTH=smart -e FHIR_SERVER_URL='<fhir-server-url>' -e FHIR_ACTIVE_KEY='<fhir-active-key>' -- npx -y fhirhydrant. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Fhirhydrant require an API key?
Yes. It expects MCP_TRANSPORT, FHIR_AUTH, FHIR_SERVER_URL, FHIR_ACTIVE_KEY, of which 1 is a secret.
›Can I use Fhirhydrant as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Fhirhydrant in the official MCP registry?
Yes, as io.github.faulkj/fhirhydrant.