Part of the FHIR operations toolkit

Analyze & Compare FHIR server capabilities,
locally.

Fetch, analyze, and compare FHIR server capabilities. Profile detection. CI-ready.

$ npm install -g fhir-capability-analyzer

bash — fhir-capability-analyzer demo

CLI v0.1.3

$ fhir-capability-analyzer analyze https://server.ips.health/fhir --format json

{
  "fhirVersion": "4.0.1",
  "software": { "name": "HAPI FHIR", "version": "6.8.0" },
  "security": { "service": ["SMART-on-FHIR"], "authorize": "https://server.ips.health/oauth/authorize" },
  "profilesDetected": [
    { "family": "IPS", "version": "1.0.0", "profile": "http://hl7.org/fhir/uv/ips/StructureDefinition/Bundle-uv-ips" }
  ],
  "resources": {
    "Patient": { "interactions": ["read", "search-type"], "searchParams": ["_id", "name", "birthdate"] },
    "Observation": { "interactions": ["read"], "searchParams": ["_id", "code", "patient"] }
  }
}

$ fhir-capability-analyzer compare baseline.json https://staging.example.com/fhir

{
  "equal": false,
  "diff": {
    "resources": {
      "Patient": {
        "interactions": { "added": ["create", "delete"] }
      },
      "Condition": {
        "added": ["read"]
      }
    },
    "profiles": {
      "added": ["http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient"]
    }
  }
}

$ import { analyzeCapability } from 'fhir-capability-analyzer';

import { analyzeCapability } from "fhir-capability-analyzer";

const report = await analyzeCapability(metadataJson);
console.log(`FHIR Version: ${report.fhirVersion}`);
console.log(`Detected profile families:`, report.profileFamilies);

Engineered for Conformance Triage

No server-side dependencies, no Java runtime, and zero external downloads. Validate, parse, and verify profiles instantly.

Instant Analysis

Fetch any FHIR server's /metadata endpoint and get a structured report — resources, interactions, search parameters, operations, and security — in seconds.

Profile Detection

Automatically detects conformance to US Core, UK Core, AU Core, CA Baseline, IPS, IPA, SMART App Launch, ISiK, and more by matching profile URLs declared in the CapabilityStatement.

Server Comparison

Compare two FHIR servers side by side. See exactly which resources, interactions, profiles, and security configurations were added, removed, or changed.

Browser Safe

No Node-specific APIs. Runs anywhere: inside CLI wrapper, React apps, Chrome Extensions, Deno, or Cloudflare Workers.

CI/CD Native

--exit-on-diff fails a build step when servers diverge. --quiet suppresses stdout for exit-code-only gates, perfect for regression pipelines.

AI Agent Friendly

Every command supports stdin pipes, --format json for structured output, and automated triage of system capabilities via tool parameters.

The FHIR Operations Toolkit

A suite of independent CLI engines that compose together seamlessly for development, CI/CD, and agentic workflows.

1. Generate

fhir-test-data

Synthetic patient & clinical resources mapped to 14 locales with check-digit validation.

View Docs ➔

2. Diff & Validate

fhir-resource-diff

Structure-aware diff engine and path-level validation. Fails builds on delta violations.