Skip to content
Back to search

healthchain

Official Claude Code plugins published from the HealthChain repository, versioned alongside the library they document

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/healthchainai/HealthChain with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/healthchainai/HealthChain'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/healthchainai--healthchain/badge.svg)](/listings/healthchainai--healthchain)

HTML

<a href="/listings/healthchainai--healthchain"><img src="/api/listings/healthchainai--healthchain/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

pip install healthchain

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 15 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "healthchain",
  3. "description": "Official Claude Code plugins published from the HealthChain repository, versioned alongside the library they document",
  4. "owner": {
  5. "name": "dotimplement ai",
  6. "url": "https://dotimplement.ai"
  7. },
  8. "plugins": [
  9. {
  10. "name": "healthchain",
  11. "source": "./plugins/healthchain",
  12. "description": "Build FHIR-connected Python applications with live data access, validation, and typed agent tools"
  13. }
  14. ]
  15. }
README.md · README · 266 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <!-- mcp-name: io.github.healthchainai/healthchain -->
  2. <div align="center" style="margin-bottom: 1em;">
  3. <picture>
  4. <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/healthchainai/HealthChain/main/docs/assets/brand/lockup/lockup-stacked-white.png">
  5. <img src="https://raw.githubusercontent.com/healthchainai/HealthChain/main/docs/assets/brand/lockup/lockup-stacked-black.png" alt="HealthChain" width="400">
  6. </picture>
  7. <!-- Project Badges -->
  8. [![PyPI Version][pypi-version-badge]][pypi]
  9. [![Stars][stars-badge]][stars]
  10. [![Downloads][downloads-badge]][pypistats]
  11. [![License][license-badge]][license]
  12. [![Python Versions][python-versions-badge]][pypi]
  13. [![Build Status][build-badge]][build]
  14. [![AI-Assisted Development][ai-badge]][claude-md]
  15. [![DOI](https://zenodo.org/badge/785158333.svg)](https://doi.org/10.5281/zenodo.20056729)
  16. [![Substack][substack-badge]][substack]
  17. [![Discord][discord-badge]][discord]
  18. </div>
  19. <h2 align="center" style="border-bottom: none">Open infrastructure for healthcare data applications.</h2>
  20. <div align="center">
  21. Connect Python pipelines and applications to live FHIR APIs, build and validate structured output, and deliver it through REST, CDS Hooks, CDA, MCP, or LangChain.
  22. </div>
  23. ## Installation
  24. ```bash
  25. pip install healthchain
  26. ```
  27. ## What HealthChain Does
  28. HealthChain puts a consistent FHIR boundary around your Python code: live data in, your own logic in the middle, and validated FHIR out. Built for research software, healthcare data, and AI teams.
  29. <table>
  30. <tr>
  31. <td width="50%" valign="top">
  32. <picture>
  33. <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/healthchainai/HealthChain/main/docs/assets/images/cards/hc-card-aggregation-dark.svg">
  34. <img src="https://raw.githubusercontent.com/healthchainai/HealthChain/main/docs/assets/images/cards/hc-card-aggregation-light.svg" alt="Epic, Cerner, and other FHIR sources flow through FHIRGateway into one patient record" width="100%">
  35. </picture>
  36. <div align="center">
  37. <br>
  38. <a href="https://healthchainai.github.io/HealthChain/reference/gateway/gateway/"><strong>🔌 Connect to Live FHIR APIs</strong></a>
  39. <br><br>
  40. <div>Connect to Epic, Cerner, Medplum, and other FHIR R4 servers through one interface that handles authentication, source routing, and common FHIR operations.</div><br>
  41. <a href="https://healthchainai.github.io/HealthChain/cookbook/multi_ehr_aggregation/">Getting Started →</a>
  42. <br><br>
  43. </div>
  44. </td>
  45. <td width="50%" valign="top">
  46. <picture>
  47. <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/healthchainai/HealthChain/main/docs/assets/images/cards/hc-card-fhir-dark.svg">
  48. <img src="https://raw.githubusercontent.com/healthchainai/HealthChain/main/docs/assets/images/cards/hc-card-fhir-light.svg" alt="Structured output goes through validate_resource, which reports any FHIR issues to correct" width="100%">
  49. </picture>
  50. <div align="center">
  51. <br>
  52. <a href="https://healthchainai.github.io/HealthChain/reference/utilities/fhir_helpers/"><strong>🔥 Build and Validate FHIR</strong></a>
  53. <br><br>
  54. <div>Build typed resources without hand-writing deeply nested FHIR. Structured validation identifies failing fields and invalid required codes before delivery.</div><br>
  55. <a href="https://healthchainai.github.io/HealthChain/reference/utilities/fhir_helpers/">Getting Started →</a>
  56. <br><br>
  57. </div>
  58. </td>
  59. </tr>
  60. <tr>
  61. <td width="50%" valign="top">
  62. <picture>
  63. <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/healthchainai/HealthChain/main/docs/assets/images/cards/hc-card-agent-tools-dark.svg">
  64. <img src="https://raw.githubusercontent.com/healthchainai/HealthChain/main/docs/assets/images/cards/hc-card-agent-tools-light.svg" alt="FHIRToolkit serves typed FHIR tools to Claude over MCP and to LangChain agents" width="100%">
  65. </picture>
  66. <div align="center">
  67. <br>
  68. <a href="https://healthchainai.github.io/HealthChain/reference/utilities/tools/"><strong>🤖 Use the Same Tools with Agents</strong></a>
  69. <br><br>
  70. <div>Expose the same build, validate, read, and terminology operations over MCP or LangChain, with structured errors an agent can inspect and correct.</div><br>
  71. <a href="https://healthchainai.github.io/HealthChain/reference/utilities/tools/">Getting Started →</a>
  72. <br><br>
  73. </div>
  74. </td>
  75. <td width="50%" valign="top">
  76. <picture>
  77. <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/healthchainai/HealthChain/main/docs/assets/images/cards/hc-card-fhir-qa-dark.svg">
  78. <img src="https://raw.githubusercontent.com/healthchainai/HealthChain/main/docs/assets/images/cards/hc-card-fhir-qa-light.svg" alt="A patient question plus the live FHIR record produces a grounded answer" width="100%">
  79. </picture>
  80. <div align="center">
  81. <br>
  82. <a href="https://healthchainai.github.io/HealthChain/cookbook/fhir_qa/"><strong>💬 Build FHIR-Backed Applications</strong></a>
  83. <br><br>
  84. <div>Use live or local FHIR data in research software, patient-facing applications, analytics, decision support, and AI-assisted workflows.</div><br>
  85. <a href="https://healthchainai.github.io/HealthChain/cookbook/fhir_qa/">Getting Started →</a>
  86. <br><br>
  87. </div>
  88. </td>
  89. </tr>
  90. </table>
  91. ## Why HealthChain?
  92. Every healthcare data team rebuilds the same integration layer. Whether your logic is rule-based, a logistic regression, or an agent, it needs authenticated access to real FHIR APIs and a reliable way to turn output into coded FHIR. Pipelines tied to one site's warehouse don't travel, and structural or coding errors may only be discovered downstream.
  93. HealthChain handles that layer so you can focus on your logic and your domain.
  94. - **Live data, not exports** — Connect to live FHIR APIs instead of site-specific warehouse queries and stale extracts
  95. - **Keep connection details out of pipeline logic** — Load endpoints and credentials from environment-backed configuration
  96. - **Build FHIR with less boilerplate** — Use flat, typed helpers instead of manually assembling deeply nested resources
  97. - **Catch errors early** — Get structured validation reports with failing field paths and actionable diagnostics
  98. - **Resolve codes instead of guessing them** — Map free text through a swappable terminology lookup before building a resource
  99. - **Choose how to deliver the result** — Expose output through FHIR REST services, CDS Hooks, SOAP/CDA, MCP, or LangChain
  100. ## 🏆 Recognition & Community
  101. **Featured & Presented:**
  102. - Featured in [TLDR AI Newsletter](https://tldr.tech/ai/2025-08-21) (900K+ developers)
  103. - [Featured by Medplum](https://www.medplum.com/blog/healthchain) for open source integration with Epic
  104. - Presented at [NHS Python Open Source Conference](https://github.com/nhs-r-community/conference-2024/blob/main/Talks/2024-11-21_jiang-kells_building-healthchain.md) ([watch talk](https://www.youtube.com/watch?v=_ZqlPsDUdSY&t=1967s))
  105. - [Built from NHS AI deployment experience](https://open.substack.com/pub/jenniferjiangkells/p/healthchain-building-the-tool-i-wish) – read the origin story
  106. ## 🤝 Pilots & Partnerships
  107. Exploring HealthChain for your product or organization? [Get in touch](mailto:jenniferjiangkells@gmail.com) to discuss integrations, pilots, or collaborations, or join our [Discord](https://discord.gg/UQC6uAepUz) to connect with the community.
  108. ## Usage Examples
  109. ### Build a FHIR Service
  110. #### Expose Multiple FHIR Sources [[Docs](https://healthchainai.github.io/HealthChain/reference/gateway/gateway)]
  111. ```python
  112. from healthchain.gateway import HealthChainAPI, FHIRGateway
  113. from healthchain.gateway.clients import FHIRAuthConfig
  114. from healthchain.fhir.r4b import Bundle, Patient
  115. # Create a FHIR-connected service
  116. app = HealthChainAPI(title="Multi-EHR Patient Data")
  117. # Credentials are loaded from EPIC_* and CERNER_* environment variables
  118. fhir = FHIRGateway()
  119. fhir.add_source("epic", FHIRAuthConfig.from_env("EPIC").to_connection_string())
  120. fhir.add_source("cerner", FHIRAuthConfig.from_env("CERNER").to_connection_string())
  121. @fhir.aggregate(Patient)
  122. def patient_data(id: str, source: str) -> Bundle:
  123. """Fetch patient data from any configured FHIR source."""
  124. bundle = fhir.search(
  125. Patient,
  126. {"_id": id},
  127. source,
  128. add_provenance=True,
  129. provenance_tag="healthchain-source",
  130. )
  131. return bundle
  132. app.register_gateway(fhir)
  133. # Available at: GET /fhir/aggregate/Patient?id=123&sources=epic&sources=cerner
  134. if __name__ == "__main__":
  135. app.run(port=8888)
  136. ```
  137. #### Scaffold with the CLI
  138. Turn a working pipeline into a configurable FHIR service:
  139. ```bash
  140. healthchain new my-app -t fhir-gateway
  141. cd my-app
  142. healthchain serve
  143. ```
  144. <div align="center">
  145. <img src="https://raw.githubusercontent.com/healthchainai/HealthChain/main/docs/assets/images/demo.gif" alt="HealthChain CLI scaffolding and running a FHIR Gateway service" width="700">
  146. </div>
  147. Add your logic in `app.py`. Use `healthchain.yaml` to configure FHIR sources and service settings while keeping credentials in environment variables. See the [CLI reference](https://healthchainai.github.io/HealthChain/cli/) for all commands.
  148. ### Agent and Assistant Workflows
  149. #### Give an Agent FHIR Tools [[Docs](https://healthchainai.github.io/HealthChain/reference/utilities/tools/)]
  150. ```python
  151. from healthchain.tools import FHIRToolkit
  152. # One toolkit: build, validate, read, and code FHIR — as typed agent tools
  153. kit = FHIRToolkit(bundle="patient_bundle.json")
  154. kit.as_mcp().run() # serve to Claude or any MCP client
  155. tools = kit.as_langchain() # or drop into a LangChain agent
  156. ```
  157. Or serve the tools straight from the terminal:
  158. ```bash
  159. healthchain mcp --bundle patient_bundle.json
  160. ```
  161. #### Build with an AI Assistant
  162. Install the HealthChain plugin to give Claude Code or Codex the current API, CLI, and recipes:
  163. ```text
  164. # Claude Code
  165. /plugin marketplace add healthchainai/HealthChain
  166. /plugin install healthchain@healthchain
  167. # Codex
  168. codex plugin marketplace add healthchainai/HealthChain
  169. codex plugin add healthchain@healthchain
  170. ```
  171. Or point any assistant at [llms.txt](https://healthchainai.github.io/HealthChain/llms.txt) for a map of the current API docs.
  172. ## 🛣️ What we're building towards
  173. - 🔌 **Deeper FHIR connectivity** — more authentication patterns, write workflows, and real-world examples from pilot deployments
  174. - 🧪 **Broader validation** — cover more resource types and value-set bindings, with clearer correction reports and optional server-backed profile validation
  175. - 🧭 **Terminology integrations** — connect the `TerminologyLookup` interface to FHIR terminology servers and licensed vocabularies
  176. - 🔎 **Traceable data movement** — carry provenance, validation results, and source errors through transformations and downstream delivery
  177. - 🧱 **Reusable data workflows** — strengthen the patterns for moving research extracts, claims, and application data behind consistent FHIR interfaces
  178. ## 🤝 Contributing
  179. - **Building research software or working with healthcare data?** [Contribute a cookbook](https://github.com/healthchainai/HealthChain/issues/208) — bring your use case, and I'll personally support you through it
  180. - Read [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines
  181. - Technical questions and ideas → [GitHub Discussions](https://github.com/healthchainai/HealthChain/discussions)
  182. - Pilots and partnerships → [email](mailto:jenniferjiangkells@gmail.com?subject=HealthChain)
  183. ## 🤗 Acknowledgements
  184. This project builds on [fhir.resources](https://github.com/nazrulworld/fhir.resources) and [CDS Hooks](https://cds-hooks.org/) standards developed by [HL7](https://www.hl7.org/) and [Boston Children's Hospital](https://www.childrenshospital.org/).
  185. ---
  186. © 2024–2026 dotimplement ai. HealthChain is an open source project maintained by [dotimplement ai](https://dotimplement.ai).
  187. <!-- Badge Links -->
  188. [pypi-version-badge]: https://img.shields.io/pypi/v/healthchain?logo=python&logoColor=white&style=flat-square&color=%23e59875
  189. [downloads-badge]: https://img.shields.io/pepy/dt/healthchain?style=flat-square&color=%2379a8a9
  190. [stars-badge]: https://img.shields.io/github/stars/healthchainai/HealthChain?style=flat-square&logo=github&color=BD932F&logoColor=white
  191. [license-badge]: https://img.shields.io/github/license/healthchainai/HealthChain?style=flat-square&color=%23e59875
  192. [python-versions-badge]: https://img.shields.io/pypi/pyversions/healthchain?style=flat-square&color=%23eeeeee
  193. [build-badge]: https://img.shields.io/github/actions/workflow/status/healthchainai/healthchain/ci.yml?branch=main&style=flat-square&color=%2379a8a9
  194. [discord-badge]: https://img.shields.io/badge/chat-%235965f2?style=flat-square&logo=discord&logoColor=white
  195. [substack-badge]: https://img.shields.io/badge/Cool_Things_In_HealthTech-%23c094ff?style=flat-square&logo=substack&logoColor=white
  196. [ai-badge]: https://img.shields.io/badge/AI--dev_friendly-CLAUDE.MD-%23e59875?style=flat-square&logo=anthropic&logoColor=white
  197. [pypi]: https://pypi.org/project/healthchain/
  198. [pypistats]: https://pepy.tech/project/healthchain
  199. [stars]: https://github.com/healthchainai/HealthChain/stargazers
  200. [license]: https://github.com/healthchainai/HealthChain/blob/main/LICENSE
  201. [build]: https://github.com/healthchainai/HealthChain/actions?query=branch%3Amain
  202. [discord]: https://discord.gg/UQC6uAepUz
  203. [substack]: https://jenniferjiangkells.substack.com/
  204. [claude-md]: CLAUDE.md

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.