uncheck_episode
Unmark TV show episodes as unwatched by episode ID to correct viewing history or manage watch status in batch operations.
Instructions
Unmarks a specific episode as watched by its ID. Supports both single episode ID and list of episode IDs for batch operations.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| episode_id | Yes |
Implementation Reference
- src/myshows_mcp/server.py:81-86 (handler)MCP tool handler for uncheck_episode. Decorated with @mcp.tool() for registration and @tool_handler for error handling. Delegates execution to the MyShowsAPI client.
@mcp.tool() @tool_handler async def uncheck_episode(episode_id: Union[int, List[int]]): """Unmarks a specific episode as watched by its ID. Supports both single episode ID and list of episode IDs for batch operations.""" return await api_client.uncheck_episode(episode_id=episode_id) - Core implementation in MyShowsAPI class that prepares parameters and makes the JSON-RPC call to 'manage.UncheckEpisode' endpoint.
async def uncheck_episode(self, episode_id: Union[int, List[int]]) -> Dict[str, Any]: """Unmarks an episode as watched by its ID. :param episode_id: The ID of the episode to uncheck, or a list of episode IDs for batch operation. :return: A dictionary containing the result of the uncheck operation. """ if isinstance(episode_id, list): params = [{"id": int(ep_id)} for ep_id in episode_id] else: params = {"id": int(episode_id)} return await self._make_request( "manage.UncheckEpisode", params=params, id=111 )