Search manga
search_mangaSearch manga on MyAnimeList using keywords. Returns compact summaries and mal_ids for use with other manga tools.
Instructions
Search MyAnimeList manga by keyword (also light novels, manhwa/manhua); returns compact summaries with the mal_id that other manga tools require. If Tenrai is unavailable and MAL_CLIENT_ID is set, transparently retries via the official API, which ignores every filter except q/sfw/limit/page (type/status/genres/genres_exclude/score/min_score/max_score/letter/magazines/start_date/end_date/unapproved/order_by/sort are silently dropped), always returns empty themes/demographics (no official-API equivalent), enforces an explicit sfw: true client-side (a filtered page can come back shorter than limit), and — for a query with no real title match — comes back with a page of unrelated manga instead of an empty result (a quirk of the official search endpoint itself, not a mal-mcp bug; don't treat a nonsense-query result as a real match during a fallback).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | Yes | Search query, e.g. a manga title. | |
| sfw | No | If true, exclude adult/explicit-rated entries (R+ Mild Nudity and up). Defaults to false (no filtering). Note: this alone still allows mainstream, safely-rated shows tagged with the Ecchi genre (fanservice) through — use `sfw_strict` to also exclude those. | |
| page | No | 1-based page number for pagination (1-1000). | |
| sort | No | Sort direction. | |
| type | No | Restrict to one or more publication types. | |
| limit | No | Max results per page (1-50). | |
| score | No | Restrict to entries with exactly this average score (rarely useful — prefer min_score/max_score for a range). | |
| genres | No | Comma-separated MAL genre IDs to include (max 25), e.g. '1,4'. Look up IDs with get_manga_genres. | |
| letter | No | Restrict results to entries whose title starts with this single letter. | |
| status | No | Filter by publication status. | |
| end_date | No | Only include entries whose end date is on or before this date (YYYY-MM-DD). | |
| order_by | No | Field to order by. | |
| magazines | No | Comma-separated MAL magazine IDs to restrict to (max 25). Look up IDs with get_magazines. | |
| max_score | No | Maximum average MAL score (inclusive), 1-10. | |
| min_score | No | Minimum average MAL score (inclusive), 0-10. | |
| sfw_strict | No | If true, exclude adult/explicit-rated entries AND anything tagged with the Ecchi genre, even otherwise-mainstream/safely-rated shows. Stricter than `sfw` alone. Defaults to false. | |
| start_date | No | Only include entries whose start date is on or after this date (YYYY-MM-DD). | |
| unapproved | No | If true, also include entries not yet approved by MAL's moderators (excluded by default). Defaults to false. | |
| genres_exclude | No | Comma-separated MAL genre IDs to exclude (max 25), e.g. '1,4'. Look up IDs with get_manga_genres. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | Yes | ||
| results | Yes |