Get ratings

Your ratings from 1 to 10 for movies, shows, seasons and episodes.

MCP tool trakt_read → get_ratings

read

Returns the titles you rated with your score and the date you rated them. Filter by type or by a score to find, for example, everything you gave a 10. Use it to match the tone of earlier scores before proposing new ones.

Parameters

Parameters: get_ratings
NameTypeDescription
type string string Only this kind of title: 'movies', 'shows', 'seasons' or 'episodes'. Default: all.
rating integer integer Only titles with this score, 1 to 10.
page integer integer Page number, starting at 1. Default: 1.
limit integer integer Items per page. Default: 20.

tools/call

JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "trakt_read",
    "arguments": {
      "operation": "get_ratings",
      "arguments": {}
    }
  }
}

Example response

JSON

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "items": [
      {
        "type": "movie",
        "title": "Past Lives",
        "year": 2023,
        "rating": 9,
        "rated_at": "2026-09-30T22:10:00Z"
      },
      {
        "type": "show",
        "title": "Slow Horses",
        "year": 2022,
        "rating": 8,
        "rated_at": "2026-08-14T20:00:00Z"
      }
    ],
    "page": 1,
    "total_pages": 6
  },
  "isError": false
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.