Diagnose release group issues for a series by comparing config vs available releases.

Checks provider cache first; if empty, triggers a manual search and retries. Returns a structured diagnosis with recommendation.

Args: series_slug: Series slug (e.g. "tvdb1234"). season: Season number to check (default: 1). episode: Episode number to check (default: 1). max_retries: How many times to retry when a search is in progress (default: 3). retry_delay_seconds: Seconds to wait between retries (default: 5.0).

Update release group configuration for a series.

Sends PATCH /api/v2/series/{slug} with the specified config.release.* fields. Only the provided fields are changed; omitted fields are left as-is.

Args: series_slug: Series slug (e.g. "tvdb1234"). whitelist: Whitelisted release groups. blacklist: Blacklisted release groups. fallback_groups: Anime release group fallback list (in priority order). fallback_days: Days before falling back to the next group.

List scene exceptions (aliases) for a series.

Scene exceptions are alternative episode/release titles that Medusa recognizes when searching. This tool reads them; use create_alias to add new ones.

Args: series_slug: Series slug (e.g. "tvdb1234"). season: Optional season number to filter by.

Create a local scene exception (alias) for a series.

This enables Medusa to recognize an alternative release title when searching, allowing it to match releases that use a different naming scheme. Only local (user-managed) scene exceptions can be created via this tool.

Args: series_slug: Series slug (e.g. "tvdb1234"). name: The alternative title to add as a scene exception. season: Optional season number. If omitted, applies to all seasons.

Delete a scene exception (alias) by ID.

Args: alias_id: The alias ID to delete.

Add an anime series to Medusa via /api/v2/anime/add.

Query a paginated seasonal anime page from Medusa, optionally returning only selected fields.

Season, source, and source_sort are case-insensitive.

Resolve an anime title to MAL candidates with match/ambiguous/no_match decision.

Return compact anime details and Medusa presence by title or MAL ID. Does not add anime.

Fetch server-filtered seasonal anime candidates and apply residual preference heuristics.

Compact seasonal candidates into an AI review packet.

Resolve and optionally add one anime. Dry-run unless execute is true.

Dry-run or add multiple anime items. Skips filterDecision=skip; execute must be true for writes.