AniList MCP Server

Overview Schema Source Related Servers Discussions Admin

Update your AniList account settings

update_user

Idempotent

Modify your AniList account profile and preferences: update about text, display languages, score format, adult content settings, notifications, and list options.

Instructions

[Requires login] Update settings on the authenticated user's own AniList account (about text, preferred title language, adult-content visibility, score format, notification/messaging preferences, anime/manga list options). Only set the fields you want to change — most fields are a true partial update (see notificationOptions/disabledListActivity below for two confirmed exceptions, PLUS animeListOptions/mangaListOptions's nested customLists — a third: that one field's ARRAY VALUE is a full replace even though its sibling fields and the other list type merge normally).

Input Schema

TableJSON Schema

Name	Required	Description
`about`	No	New profile 'about' text.
`rowOrder`	No	Internal list-table row ordering key — reads back from `mediaListOptions.rowOrder` in the profile tools/this tool's own response. Confirmed live: AniList validates this server-side and rejects an unrecognized value with a clear error ("The selected row order is invalid.") rather than silently ignoring it — unlike `profileColor` below.
`timezone`	No	Display timezone as an offset, in AniList's own documented "-?HH:MM" format (e.g. "09:00", "-05:00"). Confirmed live that AniList validates this server-side and rejects a malformed value with a clear error ("The timezone format is invalid.") — whether a leading "+" is also accepted wasn't tested live (this tool has no way to explicitly clear timezone back to unset, so a wrong guess here risked an unrevertable change); this regex follows AniList's own literal grammar, which mentions only an optional leading minus.
`scoreFormat`	No	Preferred list score format (affects how scores DISPLAY on anilist.co only — add_list_entry/update_list_entry's `score` parameter always stays on a 0-10 scale regardless of this setting, so no conversion is needed on your end).
`donatorBadge`	No	Custom donator badge text, up to 24 characters per AniList's own schema (only takes effect on a donator account).
`profileColor`	No	Profile accent color (name or hex). Confirmed live: AniList silently ignores an unrecognized value instead of erroring — the account's existing color is left unchanged, with no error surfaced and no way to detect the value was rejected other than re-checking with get_authorized_user.
`titleLanguage`	No	Preferred title display language.
`animeListOptions`	No	New anime-list display/scoring options — only the fields you set are changed (confirmed live: this is a partial merge, unlike add_list_entry's advancedScores).
`mangaListOptions`	No	New manga-list display/scoring options — same partial-merge behavior as `animeListOptions` above.
`activityMergeTime`	No	Minutes within which consecutive list activity posts get merged into one. Per AniList's own schema: 0 = never merge, 20160+ (2 weeks) = always merge.
`staffNameLanguage`	No	Preferred staff/character name display language.
`airingNotifications`	No	Whether to notify about new episode airings for anime on your list.
`displayAdultContent`	No	Whether to show adult content in search/browse.
`notificationOptions`	No	ALL 20 notification types, every time — confirmed live this is a full replace, not a partial merge: AniList silently drops every type you don't list (not just resets it to default, removes it) with no error. Fetch the account's current list first (get_authorized_user's `options.notificationOptions`) and resend it in full with just your changes applied.
`disabledListActivity`	No	ALL 6 list statuses, every time — confirmed live: AniList rejects this with a 400 error if any status is missing ("Incorrect number of disabled list activity options"), it's not a partial per-status update. Fetch the current list first (get_authorized_user's `options.disabledListActivity`) and resend it in full with just your changes applied.
`restrictMessagesToFollowing`	No	Only allow message activity from users you follow.

Output Schema

TableJSON Schema

Name	Required	Description	Default
`user`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed7 schema fields changedv0.7.1Aug 1, 2026

addedOutput schema / $defs

Added value: +{
+  "__schema0": {
+    "anyOf": [
+      {
+        "type": "string"
+      },
+      {
+        "type": "number"
+      },
+      {
+        "type": "boolean"
+      },
+      {
+        "type": "null"
+      },
+      {
+        "items": {
+          "$ref": "#/$defs/__schema0"
+        },
+        "type": "array"
+      },
+      {
+        "additionalProperties": {
+          "$ref": "#/$defs/__schema0"
+        },
+        "propertyNames": {
+          "type": "string"
+        },
+        "type": "object"
+      }
+    ]
+  }
+}

addedOutput schema / properties / user / properties / donatorBadge / description

Added value: +"AniList returns \"Donator\" here even for a non-donator (donatorTier 0); it's an upstream default label, not proof the user donates. A user's donatorTier (0 = non-donator) is the real signal."

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

changedOutput schema / properties / user / properties / mediaListOptions / anyOf

Previous value: -[
-  {
-    "additionalProperties": {},
-    "properties": {
-      "animeList": {
-        "anyOf": [
-          {
-            "additionalProperties": {},
-            "properties": {
-              "advancedScoring": {
-                "anyOf": [
-                  {
-                    "items": {
-                      "type": "string"
-                    },
-                    "type": "array"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "advancedScoringEnabled": {
-                "anyOf": [
-                  {
-                    "type": "boolean"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "customLists": {
-                "anyOf": [
-                  {
-                    "items": {
-                      "type": "string"
-                    },
-                    "type": "array"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "sectionOrder": {
-                "anyOf": [
-                  {
-                    "items": {
-                      "type": "string"
-                    },
-                    "type": "array"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "splitCompletedSectionByFormat": {
-                "anyOf": [
-                  {
-                    "type": "boolean"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "theme": {
-                "anyOf": [
-                  {},
-                  {
-                    "type": "null"
-                  }
-                ]
-              }
-            },
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "mangaList": {
-        "anyOf": [
-          {
-            "additionalProperties": {},
-            "properties": {
-              "advancedScoring": {
-                "anyOf": [
-                  {
-                    "items": {
-                      "type": "string"
-                    },
-                    "type": "array"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "advancedScoringEnabled": {
-                "anyOf": [
-                  {
-                    "type": "boolean"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "customLists": {
-                "anyOf": [
-                  {
-                    "items": {
-                      "type": "string"
-                    },
-                    "type": "array"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "sectionOrder": {
-                "anyOf": [
-                  {
-                    "items": {
-                      "type": "string"
-                    },
-                    "type": "array"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "splitCompletedSectionByFormat": {
-                "anyOf": [
-                  {
-                    "type": "boolean"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "theme": {
-                "anyOf": [
-                  {},
-                  {
-                    "type": "null"
-                  }
-                ]
-              }
-            },
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "rowOrder": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "scoreFormat": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      }
-    },
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": {},
+    "properties": {
+      "animeList": {
+        "anyOf": [
+          {
+            "additionalProperties": {},
+            "properties": {
+              "advancedScoring": {
+                "anyOf": [
+                  {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "advancedScoringEnabled": {
+                "anyOf": [
+                  {
+                    "type": "boolean"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "customLists": {
+                "anyOf": [
+                  {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "sectionOrder": {
+                "anyOf": [
+                  {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "splitCompletedSectionByFormat": {
+                "anyOf": [
+                  {
+                    "type": "boolean"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "theme": {
+                "anyOf": [
+                  {
+                    "$ref": "#/$defs/__schema0"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              }
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "mangaList": {
+        "anyOf": [
+          {
+            "additionalProperties": {},
+            "properties": {
+              "advancedScoring": {
+                "anyOf": [
+                  {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "advancedScoringEnabled": {
+                "anyOf": [
+                  {
+                    "type": "boolean"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "customLists": {
+                "anyOf": [
+                  {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "sectionOrder": {
+                "anyOf": [
+                  {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "splitCompletedSectionByFormat": {
+                "anyOf": [
+                  {
+                    "type": "boolean"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "theme": {
+                "anyOf": [
+                  {
+                    "$ref": "#/$defs/__schema0"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              }
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "rowOrder": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "scoreFormat": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      }
+    },
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / properties / user / properties / options / anyOf

Previous value: -[
-  {
-    "additionalProperties": {},
-    "properties": {
-      "activityMergeTime": {
-        "anyOf": [
-          {
-            "maximum": 9007199254740991,
-            "minimum": -9007199254740991,
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "airingNotifications": {
-        "anyOf": [
-          {
-            "type": "boolean"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "disabledListActivity": {
-        "anyOf": [
-          {
-            "items": {
-              "additionalProperties": {},
-              "properties": {
-                "disabled": {
-                  "anyOf": [
-                    {
-                      "type": "boolean"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "type": {
-                  "anyOf": [
-                    {
-                      "type": "string"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                }
-              },
-              "type": "object"
-            },
-            "type": "array"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "displayAdultContent": {
-        "anyOf": [
-          {
-            "type": "boolean"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "notificationOptions": {
-        "anyOf": [
-          {
-            "items": {
-              "additionalProperties": {},
-              "properties": {
-                "enabled": {
-                  "anyOf": [
-                    {
-                      "type": "boolean"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "type": {
-                  "anyOf": [
-                    {
-                      "type": "string"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                }
-              },
-              "type": "object"
-            },
-            "type": "array"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "profileColor": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "restrictMessagesToFollowing": {
-        "anyOf": [
-          {
-            "type": "boolean"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "staffNameLanguage": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "timezone": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "titleLanguage": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      }
-    },
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": {},
+    "properties": {
+      "activityMergeTime": {
+        "anyOf": [
+          {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "airingNotifications": {
+        "anyOf": [
+          {
+            "type": "boolean"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "disabledListActivity": {
+        "anyOf": [
+          {
+            "items": {
+              "additionalProperties": {},
+              "properties": {
+                "disabled": {
+                  "anyOf": [
+                    {
+                      "type": "boolean"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "type": {
+                  "anyOf": [
+                    {
+                      "type": "string"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "displayAdultContent": {
+        "anyOf": [
+          {
+            "type": "boolean"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "notificationOptions": {
+        "anyOf": [
+          {
+            "items": {
+              "additionalProperties": {},
+              "properties": {
+                "enabled": {
+                  "anyOf": [
+                    {
+                      "type": "boolean"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "type": {
+                  "anyOf": [
+                    {
+                      "type": "string"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "profileColor": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "restrictMessagesToFollowing": {
+        "anyOf": [
+          {
+            "type": "boolean"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "staffNameLanguage": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "timezone": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "titleLanguage": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      }
+    },
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Changed8 schema fields changedv0.5.0Jul 29, 2026

changedInput schema / properties / activityMergeTime / description

Previous value: -"Minutes within which consecutive list activity posts get merged into one."New value: +"Minutes within which consecutive list activity posts get merged into one. Per AniList's own schema: 0 = never merge, 20160+ (2 weeks) = always merge."

changedInput schema / properties / activityMergeTime / minimum
```
Previous value: --9007199254740991New value: +0
```

changedInput schema / properties / donatorBadge / description

Previous value: -"Custom donator badge text (only takes effect on a donator account)."New value: +"Custom donator badge text, up to 24 characters per AniList's own schema (only takes effect on a donator account)."

addedInput schema / properties / donatorBadge / maxLength
```
Added value: +24
```

changedInput schema / properties / profileColor / description

Previous value: -"Profile accent color (name or hex)."New value: +"Profile accent color (name or hex). Confirmed live: AniList silently ignores an unrecognized value instead of erroring — the account's existing color is left unchanged, with no error surfaced and no way to detect the value was rejected other than re-checking with get_authorized_user."

changedInput schema / properties / rowOrder / description

Previous value: -"Internal list-table row ordering key — reads back from `mediaListOptions.rowOrder` in the profile tools/this tool's own response."New value: +"Internal list-table row ordering key — reads back from `mediaListOptions.rowOrder` in the profile tools/this tool's own response. Confirmed live: AniList validates this server-side and rejects an unrecognized value with a clear error (\"The selected row order is invalid.\") rather than silently ignoring it — unlike `profileColor` below."

changedInput schema / properties / timezone / description

Previous value: -"Display timezone (e.g. \"+09:00\")."New value: +"Display timezone as an offset, in AniList's own documented \"-?HH:MM\" format (e.g. \"09:00\", \"-05:00\"). Confirmed live that AniList validates this server-side and rejects a malformed value with a clear error (\"The timezone format is invalid.\") — whether a leading \"+\" is also accepted wasn't tested live (this tool has no way to explicitly clear timezone back to unset, so a wrong guess here risked an unrevertable change); this regex follows AniList's own literal grammar, which mentions only an optional leading minus."

addedInput schema / properties / timezone / pattern
```
Added value: +"^-?\\d{2}:\\d{2}$"
```

Changed6 schema fields changedv0.4.0Jul 28, 2026

changedInput schema / properties / animeListOptions / properties / advancedScoring / description

Previous value: -"Advanced-scoring category names (e.g. Story, Characters, Visuals)."New value: +"Advanced-scoring category names (e.g. Story, Characters, Visuals) — ordered, and the order is load-bearing: every list entry's per-category `advancedScores` is stored as a plain positional array, matched against THIS list at read time, not by name. Renaming or reordering categories here silently reinterprets every already-scored entry's stored values under the new names/positions — e.g. a score the user gave for 'Story' can start reading as their 'Characters' score, with no error and no way to detect it happened after the fact. Fetch the current order first (get_authorized_user's `mediaListOptions.animeList/mangaList.advancedScoring`) so you know the existing positions before changing anything. Only add new categories at the end, or rename in place (same position) — never reorder an account that already has scored entries."

changedInput schema / properties / animeListOptions / properties / customLists / description

Previous value: -"Names of this account's custom lists."New value: +"Names of this account's custom lists — REPLACES the entire array, not merged by name: any existing list name you omit here is silently deleted (confirmed live), even though sibling fields like advancedScoring/sectionOrder and the other list type (mangaList) are left untouched. Fetch the current array first (get_authorized_user's mediaListOptions.animeList/mangaList.customLists) and include every name you want to keep, not just the one you're adding."

changedInput schema / properties / disabledListActivity / items / properties / disabled / description

Previous value: -"Whether posting activity for this status is suppressed."New value: +"Whether posting activity for this status is suppressed. Optional in the schema, but NOT safe to omit: confirmed live, leaving it out on even one of the 6 statuses makes the whole call fail with a 500 Internal Server Error on AniList's side (not a clean validation error, and not this server's bug) — always pass an explicit true/false for every status."

changedInput schema / properties / mangaListOptions / properties / advancedScoring / description

Previous value: -"Advanced-scoring category names (e.g. Story, Characters, Visuals)."New value: +"Advanced-scoring category names (e.g. Story, Characters, Visuals) — ordered, and the order is load-bearing: every list entry's per-category `advancedScores` is stored as a plain positional array, matched against THIS list at read time, not by name. Renaming or reordering categories here silently reinterprets every already-scored entry's stored values under the new names/positions — e.g. a score the user gave for 'Story' can start reading as their 'Characters' score, with no error and no way to detect it happened after the fact. Fetch the current order first (get_authorized_user's `mediaListOptions.animeList/mangaList.advancedScoring`) so you know the existing positions before changing anything. Only add new categories at the end, or rename in place (same position) — never reorder an account that already has scored entries."

changedInput schema / properties / mangaListOptions / properties / customLists / description

Previous value: -"Names of this account's custom lists."New value: +"Names of this account's custom lists — REPLACES the entire array, not merged by name: any existing list name you omit here is silently deleted (confirmed live), even though sibling fields like advancedScoring/sectionOrder and the other list type (mangaList) are left untouched. Fetch the current array first (get_authorized_user's mediaListOptions.animeList/mangaList.customLists) and include every name you want to keep, not just the one you're adding."

changedInput schema / properties / notificationOptions / items / properties / enabled / description

Previous value: -"Whether this notification type is on."New value: +"Whether this notification type is on. Optional per entry, but not really — omitting it doesn't error and doesn't inherit the previous value either; confirmed live it's written as `enabled: null`, effectively unsetting the type. Always pass an explicit true/false for every one of the 20 types."

Changed1 schema field changedv0.3.0Jul 26, 2026

addedOutput schema / properties / user / properties / about

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

Addedv0.2.0Jul 21, 2026

TDQS

A4.6/5.0

Behavior5/5

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

The description goes far beyond the annotations by detailing login requirements, partial-update behavior, full-replace exceptions, server-side validation quirks (rowOrder, timezone, profileColor), and the dangerously surprising advancedScoring reordering hazard. It also warns about silent deletion of custom lists and unrevertable changes, providing crucial safety context that annotations alone do not convey.

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

Conciseness4/5

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

The description is a single dense sentence that front-loads the purpose and uses parentheticals for critical warnings. It is reasonably concise given the complexity, but the long sentence with nested clauses ('...PLUS ... a third...') could be more readable if restructured into bullets or shorter sentences.

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 complex tool with 16 parameters, nested objects, and no required parameters, the description covers all essential non-obvious behaviors: login scope, partial-update semantics, full-replace exceptions, and dangerous side effects. The output schema handles return values, and the description even flags experimental fields and validation failures, making it complete for safe usage.

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?

With 100% schema description coverage and highly detailed property descriptions, the schema already does heavy lifting. The tool description adds cross-cutting semantics like 'most fields are a true partial update' and highlights the three full-replace exceptions, which helps the agent understand parameter behavior at a glance, though much of this is also present in individual schema descriptions.

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?

The description opens with '[Requires login] Update settings on the authenticated user's own AniList account' which clearly identifies the verb (update), resource (user account settings), and scope (own account). It lists the types of settings, distinguishing it from read-only sibling tools like get_authorized_user and get_user_profile.

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

Usage Guidelines4/5

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

The description provides clear context: requires login, targets the authenticated user's own settings, and states the 'only set the fields you want to change' partial-update rule. It explicitly warns about non-partial exceptions (notificationOptions, disabledListActivity, customLists) and advises fetching current state first, but does not name alternative tools for when not to use it.

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

Deploy Server