Review the IHE mXDE profile (ITI Technical Framework Supplement) to understand its purpose: mXDE enables FHIR-based access to data elements extracted from clinical documents stored in an IHE XDS or MHD repository, without requiring the consumer to parse full CDA or PDF documents.
Understand that mXDE acts as a translation layer: a Document Data Element Extractor (DDEE) actor reads documents from an XDS repository and maps their contents to FHIR resources (such as Condition, Observation, MedicationRequest), making them queryable via FHIR search.
Identify the provenance chain mXDE creates: each extracted FHIR resource is linked back to its source document via a FHIR Provenance resource, so consumers can trace any data element to the originating clinical document.
Understand that mXDE is complementary to MHD — consumers can use MHD to retrieve full documents and mXDE to access granular FHIR resources extracted from those documents, choosing the appropriate access pattern for their use case.
Recognize that mXDE's FHIR resources are derived views of document content; the authoritative source remains the original document, so clinical decisions should consider source document context.
Verify current IHE mXDE profile details and actor definitions against the published IHE ITI Technical Framework supplement, as profile details may be updated.
Known gotchas
mXDE-extracted resources are derived and may not capture all nuance of the source document — do not treat them as equivalent in fidelity to the original clinical document.
Not all XDS repositories have an mXDE DDEE actor deployed; confirm whether the target HIE supports mXDE before designing a workflow that depends on it.
Provenance linking extracted resources to source documents is a key mXDE feature — if Provenance resources are not populated, consumers lose the ability to trace data element origins.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp