This release is a pre-release and may not be stable for production use.
node-wire-fhir-cerner
Oracle Health (Cerner) FHIR R4 connector for Node Wire. Lets an agent or app read and search patients, search encounters, and create and search document references in a Cerner Millennium EHR. It connects as a SMART on FHIR backend service (OAuth 2.0 client credentials with a signed JWT).
Part of Node Wire. Every call runs through the Node Wire runtime, so it gets input validation, retries with a circuit breaker, scope policy, a shared error taxonomy, and OpenTelemetry tracing. A Node Wire host exposes each action over REST, gRPC and MCP.
Install
pip install node-wire-fhir-cerner
This pulls in node-wire-runtime. Pre-releases
are published as X.Y.ZbN; install one with pip install --pre node-wire-fhir-cerner. To install
every connector at once, use node-wire-connectors.
Wheels are compiled with Cython and contain no Python source. They are built for CPython 3.11, 3.12 and 3.13 on Linux x86_64 (manylinux and musllinux), macOS arm64 and Windows x64.
Actions
The connector registers as fhir_cerner. MCP tool names are <connector_id>_<action>, with
dots replaced by underscores.
| Action | MCP tool | What it does |
|---|---|---|
read_patient |
fhir_cerner_read_patient |
Reads one Patient by ID ({"resource_id": "..."}) |
search_patients |
fhir_cerner_search_patients |
Finds Patients by ID list or by name and birth date |
search_encounter |
fhir_cerner_search_encounter |
Finds a patient's Encounters, optionally filtered by status and date |
create_document_reference |
fhir_cerner_create_document_reference |
Writes a clinical document (a DocumentReference with attachment) for a patient |
search_document_reference |
fhir_cerner_search_document_reference |
Finds DocumentReferences with FHIR search parameters |
Arguments accept common aliases that language models produce, such as patientId for
resource_id. search_encounter requires a patient filter and refuses to call Cerner without one.
create_document_reference fills in what Cerner's validation requires. It base64-encodes text
when no data is given, adds ;charset=utf-8 to text/* content types, and adds a
context.period when an encounter is given without one.
Configuration
Add the connector to config/connectors.yaml:
connectors:
fhir_cerner:
enabled: true
exposed_via: ["rest", "grpc", "mcp"]
auth:
provider: oauth2
grant_method: private_key_jwt
token_url_secret: CERNER_TOKEN_URL
client_id_secret: CERNER_CLIENT_ID
private_key_secret: CERNER_PRIVATE_KEY
kid_secret: CERNER_KID
algorithm: RS384
scopes_secret: CERNER_SCOPES
scopes:
- system/Patient.read
- system/Encounter.read
- system/DocumentReference.read
- system/DocumentReference.write
Secrets are read through the configured secret provider (environment variables by default):
| Variable | Purpose |
|---|---|
CERNER_FHIR_BASE_URL |
Base URL of the Cerner FHIR R4 endpoint |
CERNER_TOKEN_URL |
OAuth 2.0 token endpoint |
CERNER_CLIENT_ID |
Client ID of the system account registered in the Cerner Code Console |
CERNER_KID |
Key ID of the public key registered with Cerner |
CERNER_PRIVATE_KEY |
RSA private key (PEM) that signs the client assertion |
CERNER_SCOPES |
Optional. Space-separated scopes; overrides scopes in the YAML |
Usage
Set NW_ALLOWED_CONNECTORS=fhir_cerner (comma-separate several). Node Wire loads only the
connectors listed there, and discovers them through the node_wire.connectors entry point.
A Node Wire host (the REST, gRPC or MCP server, or ConnectorFactory) then builds the connector
from the configuration above. See Use a connector.
Security notes
Logs record the operation mode, HTTP status and result counts, never request parameters or FHIR resource bodies. See Privacy.
Documentation
- Node Wire on GitHub: source, issues and full documentation
- Connector reference
- Configuration
- Error codes
- Changelog
License
Apache-2.0. See LICENSE.
Metadata
Release files for node-wire-fhir-cerner 1.0.0b1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
Total release size: 9.0 MB
Release files / node_wire_fhir_cerner-1.0.0b1-cp313-cp313-win_amd64.whl
| Download URL | node_wire_fhir_cerner-1.0.0b1-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 179.5 kB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
6e0b3fec1fbdcebc60277fe4e1c3898c455236a39d5c3139ae6dcc813a46cac5
|
|
BLAKE2b-256 checksum How to use checksums |
4105776f9fd1206eb57a348ab548ccbf665b7b2720b8890669844830cee56b67
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency logRelease files / node_wire_fhir_cerner-1.0.0b1-cp313-cp313-musllinux_1_2_x86_64.whl
| Download URL | node_wire_fhir_cerner-1.0.0b1-cp313-cp313-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 1.3 MB |
| Tags | CPython 3.13 Linux musl 1.2+ x86-64 |
|
SHA-256 checksum How to use checksums |
c760e015c4ac45c66828a59d8ba3ca9877f6ef64735b584c24a61e6cf9ff3075
|
|
BLAKE2b-256 checksum How to use checksums |
0c67c5dfe1f6bfa78d7e912b5f68ade6fb8df3c6464eaa26bf42d176f7378225
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency logRelease files / node_wire_fhir_cerner-1.0.0b1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
| Download URL | node_wire_fhir_cerner-1.0.0b1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 1.3 MB |
| Tags | CPython 3.13 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
82d4f7abefadb728ce1d555375d0c4de8f5d0df46bc86089d25de44ecee5be4b
|
|
BLAKE2b-256 checksum How to use checksums |
91c691fef18eeb04b0906dbd7b23565e6cd0af25faa2d9b728b21aee497299fa
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency logRelease files / node_wire_fhir_cerner-1.0.0b1-cp313-cp313-macosx_11_0_arm64.whl
| Download URL | node_wire_fhir_cerner-1.0.0b1-cp313-cp313-macosx_11_0_arm64.whl |
|---|---|
| Size | 202.3 kB |
| Tags | CPython 3.13 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
69c6969a0cb055cd5c3987b974d34fa1490595ac923b508bfa976857e0c00c32
|
|
BLAKE2b-256 checksum How to use checksums |
a14d3becd1d81c52828fec87e6c3839e5e416eac9b2cf82e74d41b9553a95a52
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency logRelease files / node_wire_fhir_cerner-1.0.0b1-cp312-cp312-win_amd64.whl
| Download URL | node_wire_fhir_cerner-1.0.0b1-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 180.8 kB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
f2d9ca9fbe4289d37d56aeb65c9137f4d7df2741c50c2bb539dc5672c9a214cb
|
|
BLAKE2b-256 checksum How to use checksums |
ed7baeebeb0f62cb47227174a1e64562dd35c0648d533d6581cf9ea3f17fc853
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency logRelease files / node_wire_fhir_cerner-1.0.0b1-cp312-cp312-musllinux_1_2_x86_64.whl
| Download URL | node_wire_fhir_cerner-1.0.0b1-cp312-cp312-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 1.3 MB |
| Tags | CPython 3.12 Linux musl 1.2+ x86-64 |
|
SHA-256 checksum How to use checksums |
b3b46ee70ad877b6a3148a45670a34a471a36b1e3f942c2fede06d88f02827f9
|
|
BLAKE2b-256 checksum How to use checksums |
699572d9f64078a86c97ac11d6296a2d8b2256d43e19fd26dd432ba996d838d1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency logRelease files / node_wire_fhir_cerner-1.0.0b1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
| Download URL | node_wire_fhir_cerner-1.0.0b1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 1.3 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
62fc5cafb04508708ee67a4821986307a65d6c9496ec53ba345321fa60daae6b
|
|
BLAKE2b-256 checksum How to use checksums |
5946d34993c626ae923f09a69a36d6442224c874d429fcc1439ed59a576af570
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency logRelease files / node_wire_fhir_cerner-1.0.0b1-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | node_wire_fhir_cerner-1.0.0b1-cp312-cp312-macosx_11_0_arm64.whl |
|---|---|
| Size | 203.1 kB |
| Tags | CPython 3.12 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
7e621c77e577ad24e5e301aa61fd3cd2170ebb7f20ea48fed20a3cecacae16eb
|
|
BLAKE2b-256 checksum How to use checksums |
fb4baeace54e4f36ef71338a63f96e1a0c0022a79c9a275019a0d4e7cbd98763
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency logRelease files / node_wire_fhir_cerner-1.0.0b1-cp311-cp311-win_amd64.whl
| Download URL | node_wire_fhir_cerner-1.0.0b1-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 183.0 kB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
94e469843de15d3fe650bf35a58c143ca80a6913b3cd619f7b32fd318f42abc8
|
|
BLAKE2b-256 checksum How to use checksums |
6a2e382ed94e5abef75bef27490c3329e77824bcd3acf24d3131930cfe381a7d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency logRelease files / node_wire_fhir_cerner-1.0.0b1-cp311-cp311-musllinux_1_2_x86_64.whl
| Download URL | node_wire_fhir_cerner-1.0.0b1-cp311-cp311-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 1.3 MB |
| Tags | CPython 3.11 Linux musl 1.2+ x86-64 |
|
SHA-256 checksum How to use checksums |
7008caaf913c8ac14fc0d7e9e68344062aa577af57473a5405b93cd8d1a3d7b1
|
|
BLAKE2b-256 checksum How to use checksums |
1ee72b2f95753366e96c1bd0460f84b133ba91d3899458a57cb512b5795664fe
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency logRelease files / node_wire_fhir_cerner-1.0.0b1-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
| Download URL | node_wire_fhir_cerner-1.0.0b1-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 1.3 MB |
| Tags | CPython 3.11 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
dfe86d200b6040d2a644a1017b0c70d031d2dd078867200efd09cd1c15111aeb
|
|
BLAKE2b-256 checksum How to use checksums |
be460dffd0c3065a3c027901b31988c136601ea258d6b46c3a081441e4bb98db
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency logRelease files / node_wire_fhir_cerner-1.0.0b1-cp311-cp311-macosx_11_0_arm64.whl
| Download URL | node_wire_fhir_cerner-1.0.0b1-cp311-cp311-macosx_11_0_arm64.whl |
|---|---|
| Size | 203.7 kB |
| Tags | CPython 3.11 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
273b8857c828ac1056de68b6b249fb089540ec298958e0ff3421802732d69b2d
|
|
BLAKE2b-256 checksum How to use checksums |
0c068603f58650fd9245442dca64507aff5b27c010ceb58a603f8a0a6a643444
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency log
