uncheck_episode
Mark specific TV show episodes as unwatched using episode IDs. Supports single or batch operations to update your MyShows.me viewing status.
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 function for 'uncheck_episode', decorated with @mcp.tool() for registration and @tool_handler. Delegates execution to the API 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 of uncheck_episode in MyShowsAPI class, handling single or batch episode unchecking via JSON-RPC call to 'manage.UncheckEpisode'.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 )
- src/myshows_mcp/server.py:81-81 (registration)Registration of the 'uncheck_episode' tool using FastMCP's @mcp.tool() decorator.@mcp.tool()