This skill should be used when the user says "request movie", "request TV show", "add to Plex", "search Overseerr", "request media", "find movie", "find TV show", "what's available on Plex", "submit media request", "get movie details", "get TV show details", "list failed requests", or mentions Overseerr, Plex media requests, or wanting to watch something. Also appropriate when the user discovers a movie or show during research and wants to request it.
From overseerr-mcpnpx claudepluginhub jmagar/claude-homelab --plugin overseerr-mcpThis skill uses the workspace's default tool permissions.
Designs and optimizes AI agent action spaces, tool definitions, observation formats, error recovery, and context for higher task completion rates.
Enables AI agents to execute x402 payments with per-task budgets, spending controls, and non-custodial wallets via MCP tools. Use when agents pay for APIs, services, or other agents.
Compares coding agents like Claude Code and Aider on custom YAML-defined codebase tasks using git worktrees, measuring pass rate, cost, time, and consistency.
MCP mode (preferred): Use when mcp__overseerr-mcp__* tools are available. These tools communicate with the overseerr-mcp server which handles all Overseerr API auth internally.
HTTP fallback mode: Use when MCP tools are not loaded. Credentials available as $CLAUDE_PLUGIN_OPTION_OVERSEERR_URL and $CLAUDE_PLUGIN_OPTION_OVERSEERR_API_KEY in Bash subprocesses.
MCP URL: ${user_config.overseerr_mcp_url}
mcp__overseerr-mcp__search_media
query (required) Search query string
media_type (optional) "movie" or "tv" — omit to search both
Returns list of results with tmdbId, title, mediaType, year, and current request status.
mcp__overseerr-mcp__get_movie_details
tmdb_id (required) TMDB integer ID from search results
mcp__overseerr-mcp__request_movie
tmdb_id (required) TMDB integer ID
mcp__overseerr-mcp__get_tv_show_details
tmdb_id (required) TMDB integer ID from search results
mcp__overseerr-mcp__request_tv_show
tmdb_id (required) TMDB integer ID
seasons (optional) List of season numbers to request, e.g. [1, 2, 3]
Omit to request all seasons
mcp__overseerr-mcp__list_failed_requests
count (optional) Number of results to return (default 10)
skip (optional) Offset for pagination (default 0)
search_media to find TMDB IDget_movie_details or get_tv_show_details to confirm and check statusrequest_movie or request_tv_showUse when MCP tools are unavailable. Retrieve credentials first:
echo "$CLAUDE_PLUGIN_OPTION_OVERSEERR_API_KEY"
curl -s "$CLAUDE_PLUGIN_OPTION_OVERSEERR_URL/api/v1/search?query=$QUERY" \
-H "X-Api-Key: $CLAUDE_PLUGIN_OPTION_OVERSEERR_API_KEY"
curl -s -X POST "$CLAUDE_PLUGIN_OPTION_OVERSEERR_URL/api/v1/request" \
-H "X-Api-Key: $CLAUDE_PLUGIN_OPTION_OVERSEERR_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"mediaType\":\"movie\",\"mediaId\":$TMDB_ID}"
curl -s -X POST "$CLAUDE_PLUGIN_OPTION_OVERSEERR_URL/api/v1/request" \
-H "X-Api-Key: $CLAUDE_PLUGIN_OPTION_OVERSEERR_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"mediaType\":\"tv\",\"mediaId\":$TMDB_ID,\"seasons\":\"all\"}"
curl -s "$CLAUDE_PLUGIN_OPTION_OVERSEERR_URL/api/v1/request?filter=failed&take=10" \
-H "X-Api-Key: $CLAUDE_PLUGIN_OPTION_OVERSEERR_API_KEY"
tmdb_id values come from search results — always search first, never guess IDsget_movie_details / get_tv_show_details before requesting to avoid duplicate requestsseasons is omitted