search_anime
Search for anime using a query term and apply filters like genre, format, or score to refine results. Specify sorting options and pagination for accurate and organized searches.
Instructions
Search for anime with query term and filters
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| amount | No | Results per page (max 25) | |
| filter | No | Filter object for searching anime. You MUST NOT include "{ "type": "ANIME" }" in the filter object. As it is already included in the API call. When no sorting method or any filter is specified, you SHOULD use the site default: "{ "sort": ["SEARCH_MATCH"] }". Otherwise, request is likely to fail or return no results. | |
| page | No | Page number for results | |
| term | No | Query term for finding anime (leave it as undefined when no query term specified.) Query term is used for searching with specific word or title in mind. You SHOULD not include things that can be found in the filter object, such as genre or tag. Those things should be included in the filter object instead. To check whether a user requested term should be considered as a query term or a filter term. It is recommended to use tools like 'get_genres' and 'get_media_tags' first. |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"amount": {
"default": 5,
"description": "Results per page (max 25)",
"type": "number"
},
"filter": {
"additionalProperties": false,
"description": "Filter object for searching anime.\nYou MUST NOT include \"{ \"type\": \"ANIME\" }\" in the filter object. As it is already included in the API call.\nWhen no sorting method or any filter is specified, you SHOULD use the site default: \"{ \"sort\": [\"SEARCH_MATCH\"] }\".\nOtherwise, request is likely to fail or return no results.",
"properties": {
"averageScore": {
"description": "Filter by the media's average score",
"type": "number"
},
"averageScore_greater": {
"description": "Filter by average score greater than value",
"type": "number"
},
"averageScore_lesser": {
"description": "Filter by average score less than value",
"type": "number"
},
"averageScore_not": {
"description": "Filter by average score not equal to value",
"type": "number"
},
"chapters": {
"description": "The number of chapters in the media",
"type": "number"
},
"chapters_greater": {
"description": "Filter by chapter count greater than value",
"type": "number"
},
"chapters_lesser": {
"description": "Filter by chapter count less than value",
"type": "number"
},
"countryOfOrigin": {
"description": "Filter by the country where the media was created (ISO 3166-1 alpha-2 country code)",
"type": "number"
},
"duration": {
"description": "The duration of episodes in minutes",
"type": "number"
},
"duration_greater": {
"description": "Filter by episode duration greater than value",
"type": "number"
},
"duration_lesser": {
"description": "Filter by episode duration less than value",
"type": "number"
},
"endDate": {
"$ref": "#/properties/filter/properties/startDate",
"description": "The end date of the media"
},
"endDate_greater": {
"description": "Filter by end date greater than value (FuzzyDateInt format)",
"type": "number"
},
"endDate_lesser": {
"description": "Filter by end date less than value (FuzzyDateInt format)",
"type": "number"
},
"endDate_like": {
"description": "Filter by end date that matches pattern",
"type": "string"
},
"episodes": {
"description": "The number of episodes in the media",
"type": "number"
},
"episodes_greater": {
"description": "Filter by episode count greater than value",
"type": "number"
},
"episodes_lesser": {
"description": "Filter by episode count less than value",
"type": "number"
},
"format": {
"description": "The format of the media",
"enum": [
"TV",
"TV_SHORT",
"MOVIE",
"SPECIAL",
"OVA",
"ONA",
"MUSIC",
"MANGA",
"NOVEL",
"ONE_SHOT"
],
"type": "string"
},
"format_in": {
"description": "Filter by media format in array",
"items": {
"$ref": "#/properties/filter/properties/format"
},
"type": "array"
},
"format_not": {
"$ref": "#/properties/filter/properties/format",
"description": "Filter by media format not equal to value"
},
"format_not_in": {
"description": "Filter by media format not in array",
"items": {
"$ref": "#/properties/filter/properties/format"
},
"type": "array"
},
"genre": {
"description": "Filter by a specific genre",
"type": "string"
},
"genre_in": {
"description": "Filter by genres in array",
"items": {
"type": "string"
},
"type": "array"
},
"genre_not_in": {
"description": "Filter by genres not in array",
"items": {
"type": "string"
},
"type": "array"
},
"id": {
"description": "The AniList ID",
"type": "number"
},
"idMal": {
"description": "The MyAnimeList ID",
"type": "number"
},
"idMal_in": {
"description": "Filter by MyAnimeList ID in array",
"items": {
"type": "number"
},
"type": "array"
},
"idMal_not": {
"description": "Filter by MyAnimeList ID not equal to value",
"type": "number"
},
"idMal_not_in": {
"description": "Filter by MyAnimeList ID not in array",
"items": {
"type": "number"
},
"type": "array"
},
"id_in": {
"description": "Filter by media ID in array",
"items": {
"type": "number"
},
"type": "array"
},
"id_not": {
"description": "Filter by media ID not equal to value",
"type": "number"
},
"id_not_in": {
"description": "Filter by media ID not in array",
"items": {
"type": "number"
},
"type": "array"
},
"isAdult": {
"description": "If the media is intended for adult audiences",
"type": "boolean"
},
"licensedBy": {
"description": "Filter by media licensed by a specific company",
"type": "string"
},
"licensedBy_in": {
"description": "Filter by media licensed by companies in array",
"items": {
"type": "string"
},
"type": "array"
},
"minimumTagRank": {
"description": "The minimum tag rank to filter by",
"type": "number"
},
"onList": {
"description": "[Requires Login] Filter by if the media is on the authenticated user's list",
"type": "boolean"
},
"popularity": {
"description": "Filter by the media's popularity",
"type": "number"
},
"popularity_greater": {
"description": "Filter by popularity greater than value",
"type": "number"
},
"popularity_lesser": {
"description": "Filter by popularity less than value",
"type": "number"
},
"popularity_not": {
"description": "Filter by popularity not equal to value",
"type": "number"
},
"search": {
"description": "Filter by search query",
"type": "string"
},
"season": {
"description": "The season the media aired",
"enum": [
"WINTER",
"SPRING",
"SUMMER",
"FALL"
],
"type": "string"
},
"seasonYear": {
"description": "The year of the season",
"type": "number"
},
"sort": {
"description": "Sort the results by the provided sort options",
"items": {
"enum": [
"ID",
"ID_DESC",
"TITLE_ROMAJI",
"TITLE_ROMAJI_DESC",
"TITLE_ENGLISH",
"TITLE_ENGLISH_DESC",
"TITLE_NATIVE",
"TITLE_NATIVE_DESC",
"TYPE",
"TYPE_DESC",
"FORMAT",
"FORMAT_DESC",
"START_DATE",
"START_DATE_DESC",
"END_DATE",
"END_DATE_DESC",
"SCORE",
"SCORE_DESC",
"POPULARITY",
"POPULARITY_DESC",
"TRENDING",
"TRENDING_DESC",
"EPISODES",
"EPISODES_DESC",
"DURATION",
"DURATION_DESC",
"STATUS",
"STATUS_DESC",
"CHAPTERS",
"CHAPTERS_DESC",
"VOLUMES",
"VOLUMES_DESC",
"UPDATED_AT",
"UPDATED_AT_DESC",
"SEARCH_MATCH",
"FAVOURITES",
"FAVOURITES_DESC"
],
"type": "string"
},
"type": "array"
},
"source": {
"$ref": "#/properties/filter/properties/format",
"description": "Filter by the media's source type"
},
"source_in": {
"description": "Filter by source types in array",
"items": {
"enum": [
"ORIGINAL",
"MANGA",
"LIGHT_NOVEL",
"VISUAL_NOVEL",
"VIDEO_GAME",
"OTHER",
"NOVEL",
"DOUJINSHI",
"ANIME"
],
"type": "string"
},
"type": "array"
},
"startDate": {
"additionalProperties": false,
"description": "The start date of the media",
"properties": {
"day": {
"type": [
"number",
"null"
]
},
"month": {
"type": [
"number",
"null"
]
},
"year": {
"type": [
"number",
"null"
]
}
},
"required": [
"year",
"month",
"day"
],
"type": "object"
},
"startDate_greater": {
"description": "Filter by start date greater than value (FuzzyDateInt format)",
"type": "number"
},
"startDate_lesser": {
"description": "Filter by start date less than value (FuzzyDateInt format)",
"type": "number"
},
"startDate_like": {
"description": "Filter by start date that matches pattern",
"type": "string"
},
"status": {
"description": "The current status of the media",
"enum": [
"FINISHED",
"RELEASING",
"NOT_YET_RELEASED",
"CANCELLED",
"HIATUS"
],
"type": "string"
},
"status_in": {
"description": "Filter by media status in array",
"items": {
"$ref": "#/properties/filter/properties/status"
},
"type": "array"
},
"status_not": {
"$ref": "#/properties/filter/properties/status",
"description": "Filter by media status not equal to value"
},
"status_not_in": {
"description": "Filter by media status not in array",
"items": {
"$ref": "#/properties/filter/properties/status"
},
"type": "array"
},
"tag": {
"description": "Filter by a specific tag",
"type": "string"
},
"tagCategory": {
"description": "Filter by tag category",
"type": "string"
},
"tagCategory_in": {
"description": "Filter by tag categories in array",
"items": {
"type": "string"
},
"type": "array"
},
"tagCategory_not_in": {
"description": "Filter by tag categories not in array",
"items": {
"type": "string"
},
"type": "array"
},
"tag_in": {
"description": "Filter by tags in array",
"items": {
"type": "string"
},
"type": "array"
},
"tag_not_in": {
"description": "Filter by tags not in array",
"items": {
"type": "string"
},
"type": "array"
},
"type": {
"description": "The type of the media (ANIME or MANGA)",
"enum": [
"ANIME",
"MANGA"
],
"type": "string"
},
"volumes": {
"description": "The number of volumes in the media",
"type": "number"
},
"volumes_greater": {
"description": "Filter by volume count greater than value",
"type": "number"
},
"volumes_lesser": {
"description": "Filter by volume count less than value",
"type": "number"
}
},
"type": "object"
},
"page": {
"default": 1,
"description": "Page number for results",
"type": "number"
},
"term": {
"description": "Query term for finding anime (leave it as undefined when no query term specified.)\nQuery term is used for searching with specific word or title in mind.\n\nYou SHOULD not include things that can be found in the filter object, such as genre or tag.\nThose things should be included in the filter object instead.\n\nTo check whether a user requested term should be considered as a query term or a filter term.\nIt is recommended to use tools like 'get_genres' and 'get_media_tags' first.",
"type": "string"
}
},
"type": "object"
}
You must be authenticated.
Other Tools from anilist-mcp
- add_list_entry
- delete_activity
- delete_thread
- favourite_anime
- favourite_character
- favourite_manga
- favourite_staff
- favourite_studio
- follow_user
- get_activity
- get_anime
- get_authorized_user
- get_character
- get_full_user_info
- get_genres
- get_manga
- get_media_tags
- get_recommendation
- get_recommendations_for_media
- get_site_statistics
- get_staff
- get_studio
- get_thread
- get_thread_comments
- get_todays_birthday_characters
- get_todays_birthday_staff
- get_user_activity
- get_user_anime_list
- get_user_manga_list
- get_user_profile
- get_user_recent_activity
- get_user_stats
- post_message_activity
- post_text_activity
- remove_list_entry
- search_activity
- search_anime
- search_character
- search_manga
- search_staff
- search_studio
- search_user
- update_list_entry
- update_user
Related Tools
- @yuna0x0/anilist-mcp
- @yuna0x0/anilist-mcp
- @yuna0x0/anilist-mcp
- @yuna0x0/anilist-mcp
- @yuna0x0/anilist-mcp