MyShows MCP Server

Instructions

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)

• src/myshows_mcp/api/myshows_api.py:178-190 (helper)

  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
      )