AniList MCP Server

Overview Schema Source Related Servers Discussions Admin

Get a recommendation by ID

get_recommendation

Read-only

Fetch a single AniList recommendation pairing by its ID to re-check that pairing's current rating or userRating without re-paginating the whole list, for example after voting on it directly on anilist.co.

Instructions

Get a single AniList recommendation pairing (media + the media users recommend alongside it) by its AniList recommendation ID — useful for re-checking one specific pairing's current rating/userRating (e.g. after voting on it directly on anilist.co — this server has no tool to cast that vote itself) without re-paginating the whole list. Use get_recommendations_for_media instead to discover recommendation IDs for a title in the first place, or to browse/list them. Confirmed live (raw GraphQL, independent of this server): this is an AniList-side inconsistency, not a client bug — a majority of ids from get_recommendations_for_media's own nodes[].id 404 here anyway (7 of 10 tested for one title), with no correlation to that pairing's rating. A 404 on an id you just got from that tool doesn't mean the pairing doesn't exist, only that this specific lookup can't resolve it.

Input Schema

Name	Required	Description	Default
`id`	Yes	AniList recommendation ID.

Output Schema

Name	Required	Description	Default
`recommendation`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedv0.11.0Oct 25, 2026
- addedInput schema / additionalProperties
```
Added value: +false
```

Changed2 schema fields changedv0.9.0Sep 27, 2026

changedOutput schema / properties / recommendation / properties / media / anyOf

Previous value: -[
-  {
-    "additionalProperties": {},
-    "properties": {
-      "id": {
-        "exclusiveMinimum": 0,
-        "maximum": 2147483647,
-        "type": "integer"
-      },
-      "title": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "english": {
-                "anyOf": [
-                  {
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "romaji": {
-                "anyOf": [
-                  {
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              }
-            },
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      }
-    },
-    "required": [
-      "id"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": {},
+    "properties": {
+      "id": {
+        "exclusiveMinimum": 0,
+        "maximum": 2147483647,
+        "type": "integer"
+      },
+      "title": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "english": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "romaji": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              }
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      }
+    },
+    "required": [
+      "id"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / properties / recommendation / properties / mediaRecommendation / anyOf

Previous value: -[
-  {
-    "additionalProperties": {},
-    "properties": {
-      "id": {
-        "exclusiveMinimum": 0,
-        "maximum": 2147483647,
-        "type": "integer"
-      },
-      "title": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "english": {
-                "anyOf": [
-                  {
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "romaji": {
-                "anyOf": [
-                  {
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              }
-            },
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      }
-    },
-    "required": [
-      "id"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": {},
+    "properties": {
+      "id": {
+        "exclusiveMinimum": 0,
+        "maximum": 2147483647,
+        "type": "integer"
+      },
+      "title": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "english": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "romaji": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              }
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      }
+    },
+    "required": [
+      "id"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Changed10 schema fields changedv0.7.1Aug 1, 2026

addedInput schema / properties / id / exclusiveMinimum
```
Added value: +0
```
removedInput schema / properties / id / minimum
```
Removed value: --2147483648
```
addedOutput schema / properties / recommendation / properties / id / exclusiveMinimum
```
Added value: +0
```
changedOutput schema / properties / recommendation / properties / id / maximum
```
Previous value: -9007199254740991New value: +2147483647
```
removedOutput schema / properties / recommendation / properties / id / minimum
```
Removed value: --9007199254740991
```

changedOutput schema / properties / recommendation / properties / media / anyOf

Previous value: -[
-  {
-    "additionalProperties": {},
-    "properties": {
-      "id": {
-        "maximum": 9007199254740991,
-        "minimum": -9007199254740991,
-        "type": "integer"
-      },
-      "title": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "english": {
-                "anyOf": [
-                  {
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "romaji": {
-                "anyOf": [
-                  {
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              }
-            },
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      }
-    },
-    "required": [
-      "id"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": {},
+    "properties": {
+      "id": {
+        "exclusiveMinimum": 0,
+        "maximum": 2147483647,
+        "type": "integer"
+      },
+      "title": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "english": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "romaji": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              }
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      }
+    },
+    "required": [
+      "id"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / properties / recommendation / properties / mediaRecommendation / anyOf

Previous value: -[
-  {
-    "additionalProperties": {},
-    "properties": {
-      "id": {
-        "maximum": 9007199254740991,
-        "minimum": -9007199254740991,
-        "type": "integer"
-      },
-      "title": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "english": {
-                "anyOf": [
-                  {
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "romaji": {
-                "anyOf": [
-                  {
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              }
-            },
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      }
-    },
-    "required": [
-      "id"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": {},
+    "properties": {
+      "id": {
+        "exclusiveMinimum": 0,
+        "maximum": 2147483647,
+        "type": "integer"
+      },
+      "title": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "english": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "romaji": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              }
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      }
+    },
+    "required": [
+      "id"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / properties / recommendation / properties / rating / anyOf

Previous value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "maximum": 9007199254740991,
+    "minimum": -9007199254740991,
+    "type": "integer"
+  },
+  {
+    "type": "null"
+  }
+]

addedOutput schema / properties / recommendation / properties / rating / description

Added value: +"Net rating (RATE_UP minus RATE_DOWN votes across all users), not the caller's own."

changedOutput schema / properties / recommendation / properties / userRating / anyOf

Previous value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "enum": [
+      "NO_RATING",
+      "RATE_UP",
+      "RATE_DOWN"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

First observedv0.1.5Jul 21, 2026

TDQS

A4.7/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations only say readOnly and openWorld; the description adds genuinely non-obvious behavior: a majority of IDs sourced from get_recommendations_for_media's nodes[].id 404 here (7 of 10 tested), with no correlation to rating, and that a 404 does not mean the pairing doesn't exist. That is exactly the failure-mode context an agent cannot get from structured fields.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The core purpose is front-loaded in the first clause, but the single sentence is very long with nested em-dashes and parentheses carrying the voting aside, the sibling routing, and the 404 statistics. The content mostly earns its place, yet the packing makes it harder to scan than a three-sentence split would be.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a single-parameter read tool with an output schema, the description covers everything an agent needs: what it returns conceptually, which sibling to use instead, and the known ID-resolution failure mode. Nothing material is left implicit.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3, but the description adds real meaning beyond the schema: the id is an AniList-side recommendation ID whose provenance (nodes[].id from the sibling tool) and reliability (often 404) are called out. It still doesn't add format/range hints beyond the schema's own constraints.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('Get a single AniList recommendation pairing ... by its AniList recommendation ID') and explicitly scopes what a recommendation is (media + the recommended-alongside media). It also names the sibling get_recommendations_for_media for the adjacent task, so an agent can tell the two apart without opening either schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives an explicit when ('re-checking one specific pairing's current rating/userRating after voting on anilist.co') and an explicit when-not/alternative ('use get_recommendations_for_media instead to discover recommendation IDs ... or to browse/list them'). It also rules out a mistaken expectation by noting this server has no vote-casting tool.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server