micvna-orthanc

Query Orthanc DICOM servers via REST to locate studies and retrieve accession numbers.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/dmd/dotfiles --skill micvna-orthanc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: micvna-orthanc
Source: https://github.com/dmd/dotfiles/tree/main/claude/skills/micvna-orthanc
Command: npx skills add https://github.com/dmd/dotfiles --skill micvna-orthanc

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, and includes scripts (resource) components.

What problem does it solve?

This Skill streamlines querying an Orthanc DICOM server to locate studies, accession numbers, and study metadata by MRN, accession number, or study date, removing the need to manually craft REST calls and convert DICOM dates.

Core Features & Use Cases

  • Search and lookup: Query Orthanc by PatientID (MRN), AccessionNumber, or date using the /tools/find endpoint.
  • Study and series details: Retrieve study-level tags, series lists, and image counts via /studies/{id} and /series/{id}.
  • Date handling and fallbacks: Convert user dates (MM/DD/YYYY) to DICOM YYYYMMDD, check both MainDicomTags and simplified tags, and handle missing accession numbers gracefully.
  • Real-time monitoring: Monitor the /changes feed to detect new instances and optionally filter by study description.
  • Use case: Look up a patient's accession for a specific visit date, generate series-level image counts for a study, or continuously monitor incoming MRI studies for processing pipelines.

Quick Start

Use the micvna-orthanc skill to find the accession number for MRN 219306 on 01/16/2016.

Frequently Asked Questions about micvna-orthanc

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I query an Orthanc DICOM server to find a study by MRN?

You query an Orthanc DICOM server by making a REST API call to the /tools/find endpoint with the PatientID. The skill automates this search to retrieve matching studies without manual REST call construction.

How do I retrieve the accession number for a specific study date in Orthanc?

You retrieve the accession number by searching Orthanc with a study date. The skill converts standard MM/DD/YYYY dates into the DICOM YYYYMMDD format, checks both MainDicomTags and simplified tags, and handles missing accession numbers gracefully.

Can I monitor the Orthanc changes feed for new DICOM instances?

Yes, you can monitor the Orthanc /changes feed to detect new DICOM instances in real time. The skill supports continuous monitoring and can optionally filter incoming instances by study description for processing pipelines.

How do I get series-level image counts for a DICOM study in Orthanc?

You get series-level image counts by querying the /studies/{id} and /series/{id} REST endpoints in Orthanc. The skill retrieves study-level tags and series lists to generate accurate image counts for cataloging or auditing.

Do I need the requests library to query Orthanc DICOM servers?

Yes, you need the requests library to query Orthanc DICOM servers. The skill uses this Python dependency to perform REST API calls to Orthanc endpoints and retrieve medical imaging metadata.