Search MyAnimeList anime by keyword; returns compact summaries (with the mal_id that other anime tools require) plus pagination info.

Search MyAnimeList manga by keyword (also light novels, manhwa/manhua); returns compact summaries with the mal_id that other manga tools require.

Get full details for one anime by mal_id: synopsis, score, genres, studios, streaming links and related entries. Obtain the mal_id from search_anime first.

Get full details for one manga by mal_id. Obtain the mal_id from search_manga first.

List the characters of an anime (by mal_id) with their roles and Japanese voice actors. Get the mal_id from search_anime.

List the characters of a manga (by mal_id) with their roles. Get the mal_id from search_manga.

List an anime's episodes (by mal_id) with titles, air dates and filler/recap flags. Paginated (~100 per page); use page for long-running series. Get the mal_id from search_anime.

Get community recommendations for anime similar to the given mal_id, ordered by votes. Get the mal_id from search_anime.

Get user reviews for one anime (by mal_id), including score and review text. Get the mal_id from search_anime. (For a cross-title feed, use get_top_reviews.)

Get community recommendations for manga similar to the given mal_id, ordered by votes. Get the mal_id from search_manga.

Get user reviews for one manga (by mal_id), including score and review text. Get the mal_id from search_manga.

Get ranked/top anime. Use filter for special rankings (airing, upcoming, bypopularity, favorite).

Get ranked/top manga. Use filter for special rankings (bypopularity, favorite).

List anime from a given season. Omit year and season to get the current season.

Get the anime broadcast schedule, optionally for a single weekday.

Get a public MyAnimeList user's profile and watch/read statistics by username.

Get a public MyAnimeList user's favorite anime, manga, characters and people by username.

List anime genres/themes/demographics with their Jikan IDs. Use this to discover the numeric IDs that the genres parameter of search_anime expects.

List manga genres/themes/demographics with their Jikan IDs. Use this to discover the numeric IDs that the genres parameter of search_manga expects.

Search MyAnimeList characters by name. Returns compact summaries and the mal_id needed by get_character.

Get full details for one character by mal_id: bio, the anime/manga they appear in, and their voice actors. Obtain the mal_id from search_characters or get_anime_characters.

Search MyAnimeList people (voice actors, directors, authors) by name. Returns the mal_id needed by get_person.

Get full details for one person by mal_id: bio, their anime/manga staff positions and voiced roles. Obtain the mal_id from search_people or a character's voice_actors.

List the production staff of an anime (by mal_id) — director, composer, etc. — with their roles. Complements get_anime_characters (which covers voice actors). Get the mal_id from search_anime.

Return one random anime (full details). Good for discovery / suggestions.

Return one random manga (full details). Good for discovery / suggestions.

List anime scheduled for the upcoming season. Use get_seasonal_anime for the current or a specific past season.

Get watch-status counts (watching/completed/…) and the score distribution for an anime by mal_id. Get the mal_id from search_anime.

Get read-status counts (reading/completed/…) and the score distribution for a manga by mal_id. Get the mal_id from search_manga.

List or search anime producers and studios with their Jikan IDs and counts. Use q to search by name.

Get the most popular/favorited people (voice actors, staff, authors).

Get the most popular/favorited characters.

List the years and seasons that have anime data, so you can pick valid arguments for get_seasonal_anime.

Return one random character (full details). Good for discovery / trivia.

Return one random person — voice actor, director, author (full details).

List recent news articles about an anime (by mal_id): headline, date, author and excerpt. Useful for 'what's new / any announcements' questions. Get the mal_id from search_anime.

Get the authenticated user's MyAnimeList profile and anime statistics.

Get the authenticated user's own anime list, with each entry's status, score and progress.

Get the authenticated user's own manga list, with status, score and progress.

Add or update an anime on the authenticated user's list (status, score, watched episodes, dates). Creates the entry if absent. Provide at least one field besides anime_id.

Add or update a manga on the authenticated user's list (status, score, chapters/volumes read). Creates the entry if absent. Provide at least one field besides manga_id.

Remove an anime entry from the authenticated user's list. This cannot be undone.

Remove a manga entry from the authenticated user's list. This cannot be undone.

Authorize the personal-list tools with your MyAnimeList account (one-time). Prerequisite: register a MAL API app of type 'other' at https://myanimelist.net/apiconfig with Redirect URI set to this server's localhost callback, and set MAL_CLIENT_ID in the server env. Calling this returns an authorization URL: open it, log in, and click Allow. If your browser is on the same machine as the server, login completes automatically; if it's remote (SSH/headless), copy the URL you land on and pass it to submit_mal_redirect.

Complete a login started with login_mal by submitting the URL your browser was redirected to after clicking Allow (the one containing ?code=...). Use this when login didn't complete automatically — e.g. the server runs on a remote/headless host. A bare code string is also accepted.