watched_movies
Retrieve watched movies from your MyShows profile to track viewing history and manage your collection.
Instructions
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.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No |
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)
- 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"}, }, )