Diagnose a missing or unplayable item
diagnose_mediaExplains why a media title is not playable by checking each step from request to playback and naming the first blocking cause, with a remedy and suggested next steps.
Instructions
Why is this not playable? Walks the chain (requested, managed, monitored, downloaded, indexed, imported, scanned) and names the first thing that explains it, with a remedy and, where a tool call fixes it, next_steps to offer the user; this tool never runs them. Give a title as query, or service plus id when you already hold an exact item. A title not in the library is looked up in Cleanuparr, download-client history and the library event log, so a removed release can still be explained. A step it could not check sets certain: false, and the summary says what was missed. With Reclaimerr it says when a cleanup rule deleted or will delete the title; with Bazarr it notes missing subtitles. A Lidarr artist is walked too (tracks on disk, queue, indexers, media server): playable means at least one track, and get_media_details lists its albums. Field reference: arr://docs/diagnose_media.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "diagnose_media"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | ||
| user | No | Whose watch state to consider. Defaults to the configured default_user; any other value requires allow_other_users. | |
| query | No | A title: how a person actually asks. | |
| service | No | With `id`: an exact item, when one is already in hand. | |
| instance | No | Which instance (e.g. "4k") when several of this service exist. Omit it when there is one. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | ||
| steps | Yes | ||
| history | No | ||
| verdict | Yes | ||
| degraded | Yes | ||
| resolved | No |