Guardrailed FHIR access for AI agents: PHI redaction, audit trail, step-up auth, tenant isolation
Guardrailed FHIR access for AI agents: PHI redaction, audit trail, step-up auth, tenant isolation. That is what the healthclaw mcp server brings to an AI assistant: the same capability, reachable through the Model Context Protocol rather than a separate app or dashboard.
The hosted demo runs synthetic data behind the full guardrail stack:
Because this one is hosted, setup is mostly authentication — you point your client at the endpoint and approve access. Nothing runs on your machine, so there is no runtime to keep patched.
The server publishes 14 tools. What each one is for:
context_get — Retrieve pre-built context envelopesfhir_read — Read a FHIR resource (redacted)fhir_search — Search with patient, code, status, date filtersfhir_validate — Structural validationfhir_stats — Observation statistics (count/min/max/mean)fhir_lastn — Most recent N observations per codefhir_interpret_labs — Lab reference-range interpretation ($interpret) — decision support, not diagnosiscare_gaps — Preventive-care gaps ($care-gaps) — screenings/immunizations that may be due, from the patient's own recordsguardrail_conformance — Run the guardrail conformance self-test — graded A–F scorecard across all seven propertiesfhir_permission_evaluate — R6 Permission access control evaluationfhir_subscription_topics — List available SubscriptionTopicsquestionnaire_populate — SDC $populate — pre-fill a Questionnaire for a subjectConfiguration is passed through the environment: MCP_AUTH_TOKEN, STEP_UP_SECRET, FHIR_UPSTREAM_URL. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.
Plenty of developer tooling servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Healthclaw's toolset — context_get, fhir_read, fhir_search and 11 more — is a fair guide to whether it matches your workflow. It is maintained by aks129; worth a glance at recent repository activity before you build anything load-bearing on it.
SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.
| Tool | What it does |
|---|---|
| context_get | Retrieve pre-built context envelopes |
| fhir_read | Read a FHIR resource (redacted) |
| fhir_search | Search with patient, code, status, date filters |
| fhir_validate | Structural validation |
| fhir_stats | Observation statistics (count/min/max/mean) |
| fhir_lastn | Most recent N observations per code |
| fhir_interpret_labs | Lab reference-range interpretation ($interpret) — decision support, not diagnosis |
| care_gaps | Preventive-care gaps ($care-gaps) — screenings/immunizations that may be due, from the patient's own records |
| guardrail_conformance | Run the guardrail conformance self-test — graded A–F scorecard across all seven properties |
| fhir_permission_evaluate | R6 Permission access control evaluation |
| fhir_subscription_topics | List available SubscriptionTopics |
| questionnaire_populate | SDC $populate — pre-fill a Questionnaire for a subject |
| curatr_evaluate | Evaluate a FHIR resource for data quality issues |
| action_status | Poll a real-world action (call/SMS) |
{
"mcpServers": {
"healthclaw-guardrails": {
"command": "npx",
"args": ["-y", "playwright"],
"env": {
"MCP_AUTH_TOKEN": "your-value",
"STEP_UP_SECRET": "your-value",
"FHIR_UPSTREAM_URL": "your-value"
}
}
}
}Add to claude_desktop_config.json, then restart Claude Desktop.
| Variable | Description | Required |
|---|---|---|
| MCP_AUTH_TOKEN | Credential the server authenticates with. | Yes |
| STEP_UP_SECRET | Credential the server authenticates with. | Yes |
| FHIR_UPSTREAM_URL | Endpoint or connection string the server talks to. | Yes |
Kill hallucinated APIs — version-accurate, up-to-date library documentation injected straight into context.
Microsoft's official browser automation server — drive a real browser through the accessibility tree, no screenshots needed.
GitHub's official server — repos, issues, pull requests, Actions and code security, straight from your assistant.
Issue tracking at the speed of conversation — Linear's official hosted server with OAuth and zero install.
Local repository surgery — status, diffs, commits, branches and history for any repo on disk.
Timezone sanity for AI — current time anywhere and correct conversions, without the model doing date math.