find-instances
Retrieve DICOM instances within a single series by providing Study and Series Instance UIDs; optionally filter results with DICOM key=value queries.
Instructions
Searches DICOM instances within a single series, sorted by Instance Number ascending. Requires Study and Series Instance UIDs from find-studies and find-series.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"studyInstanceUid": "<studyInstanceUid>",
"seriesInstanceUid": "<seriesInstanceUid>",
"query": "<query>"
},
"name": "find-instances"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Space-separated DICOM key=value search filters. Keys are DICOM keyword names or 8-digit hex tags (e.g., SOPClassUID=1.2.840.10008.5.1.4.1.1.2). Special keys: limit=N, offset=N. Pass an empty string to return all instances. | |
| studyInstanceUid | Yes | DICOM Study Instance UID (e.g., 1.2.840.113619.2.55.3). Obtain from find-studies. | |
| seriesInstanceUid | Yes | DICOM Series Instance UID (e.g., 1.2.840.113619.2.55.3.604688123). Obtain from find-series. |