MyShows MCP Server

Instructions

Implementation Reference

• src/myshows_mcp/server.py:43-50 (handler)

  The main handler for the 'watched_movies' MCP tool. Decorated with @mcp.tool() for registration and @tool_handler for error handling. Executes by calling api_client.get_watched_movies(page=page).

  @mcp.tool()
  @tool_handler
  async def watched_movies(page: int = 0):
      """Retrieves a list of watched movies from MyShows.
      :param page: The page number to retrieve (default is 0).
      :return: A dictionary containing the list of watched movies.
      """
      return await api_client.get_watched_movies(page=page)

• src/myshows_mcp/api/myshows_api.py:96-107 (helper)

  Supporting method in MyShowsAPI that performs the actual API request to retrieve the list of watched movies using the JSON-RPC method 'profile.WatchedMovies'.

  async def get_watched_movies(self, page: int = 0) -> Dict[str, Any]:
      """Retrieves a list of watched movies from MyShows."""
      return await self._make_request(
          method="profile.WatchedMovies",
          id=80,
          params={
              "page": int(page),
              "pageSize": 20,
              "login": "",
              "search": {"sort": "watchedAt_desc"},
          },
      )