Add or update a list entry
Create or change a list entry for an anime or manga.
MCP tool anilist_write → save_list_entry
write Confirm
Creates the entry if the title is not on your list, otherwise changes only the fields you send. Returns the saved entry. The change can show in your activity feed to people who follow you, unless the entry is private. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| media_id integer required | integer | AniList media ID from search_media or list_media_list. |
| status string | string | CURRENT, PLANNING, COMPLETED, DROPPED, PAUSED or REPEATING. |
| progress integer | integer | Episodes or chapters consumed. |
| score number | number | Score in your account's scoring system, for example 0 to 10 for a 10-point scale. |
| notes string | string | Your notes on the entry, up to 6000 characters. |
| private boolean | boolean | Keep the entry visible only to you. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "anilist_write",
"arguments": {
"operation": "save_list_entry",
"arguments": {
"media_id": 154587,
"status": "COMPLETED",
"progress": 28,
"score": 9
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"entry_id": 481337021,
"media": {
"media_id": 154587,
"title": "Frieren: Beyond Journey's End"
},
"status": "COMPLETED",
"progress": 28,
"score": 9,
"private": false
},
"isError": false
}