Skip to main content
Glama

mangadex-mcp

Local stdio MCP server for searching MangaDex, reading manga metadata, listing chapters, and exporting internal chapters to CBZ or PDF.

Features

  • Search MangaDex titles by name

  • Fetch manga metadata and external links

  • List recent English chapters for a manga

  • Return chapter-level reader access info

  • Export internal MangaDex chapters to local CBZ files

  • Export internal MangaDex chapters to local PDF files

Related MCP server: MAL MCP Server

Requirements

  • Node.js 20+

  • npm

Install

npm install

Run

npm start

MCP Launch

This server uses the MCP stdio transport and is intended to be spawned locally by an MCP client.

Example:

{
  "command": "node",
  "args": ["C:\\Users\\[NAME]\\mangadex-mcp\\src\\index.js"]
}

Tools

search_manga

Search MangaDex by title.

Input:

{
  "query": "berserk"
}

get_manga_details

Fetch detailed metadata and mapped external links for a manga.

Input:

{
  "mangaId": "801513ba-a712-498c-8f57-cae55b38cc92"
}

get_manga_chapters

List recent English chapters for a manga.

Input:

{
  "mangaId": "801513ba-a712-498c-8f57-cae55b38cc92",
  "limit": 10,
  "offset": 0
}

get_chapter_access_info

Return chapter-level access info. For internal MangaDex chapters this points to the MangaDex reader. For external-hosted chapters this returns the external reader URL. MangaDex does not expose PDF/CBZ download URLs through this API.

Input:

{
  "chapterId": "8ceadc31-e41e-4038-8aef-d002aab344a5"
}

export_chapter_cbz

Export an internal MangaDex chapter to a local CBZ file. The tool result also includes a resource_link block pointing at the exported file.

Input:

{
  "chapterId": "8ceadc31-e41e-4038-8aef-d002aab344a5",
  "quality": "data-saver",
  "outputDir": "exports/chapters"
}

export_chapter_pdf

Export an internal MangaDex chapter to a local PDF file. The tool result also includes a resource_link block pointing at the exported file.

Input:

{
  "chapterId": "8ceadc31-e41e-4038-8aef-d002aab344a5",
  "quality": "data-saver",
  "outputDir": "exports/chapters"
}

Return only the external links for a manga.

Input:

{
  "mangaId": "801513ba-a712-498c-8f57-cae55b38cc92"
}

Local Verification

npm run smoke

Notes

  • export_chapter_cbz only works for internal MangaDex-hosted chapters.

  • export_chapter_pdf only works for internal MangaDex-hosted chapters.

  • External chapters such as MangaPlus links cannot be exported through MangaDex.

  • PDF export currently supports chapter pages delivered as jpg, jpeg, or png.

  • The server makes live requests to https://api.mangadex.org.

Available Tools

7 tools
export_chapter_cbzA

Export an internal MangaDex chapter to a local CBZ file. External-hosted chapters cannot be exported through MangaDex. After calling, prefer reporting only the saved path unless the user asked for more detail.

Inputs: chapterId (required), quality, outputDir. Returns: exportStatus, chapterId, mangaTitle, chapter, +6 more

export_chapter_pdfA

Export an internal MangaDex chapter to a local PDF file. External-hosted chapters cannot be exported through MangaDex. After calling, prefer reporting only the saved path unless the user asked for more detail.

Inputs: chapterId (required), quality, outputDir. Returns: exportStatus, chapterId, mangaTitle, chapter, +6 more

get_chapter_access_infoA

Return chapter access metadata only, including the MangaDex reader URL or external host URL. MangaDex does not provide PDF/CBZ download URLs here.

Inputs: chapterId (required). Returns: chapterId, chapter, title, chapterUrl, +12 more

get_manga_chaptersB

List recent English chapter metadata for a manga.

Inputs: mangaId (required), limit, offset. Returns: mangaId, totalResults, results

get_manga_detailsA

Return MangaDex metadata and mapped external links for a manga. Prefer reporting only this metadata, not general background knowledge.

Inputs: mangaId (required). Returns: id, title, description, status, +4 more

search_mangaB

Search MangaDex by title and return MangaDex search metadata only.

Inputs: query (required). Returns: query, totalResults, results

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 7 tools

    Disambiguation4/5

    Most tools have distinct purposes, but export_chapter_cbz and export_chapter_pdf serve very similar functions with only format differences, which could cause confusion. The other tools clearly target different operations like searching, getting details, or listing chapters.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern (e.g., export_chapter_cbz, get_manga_details, search_manga) with clear, descriptive names. There are no deviations in style or convention throughout the set.

    Tool Count5/5

    With 7 tools, the count is well-scoped for a MangaDex server, covering core operations like searching, retrieving manga details, listing chapters, and exporting. Each tool appears to earn its place without being excessive or insufficient.

    Completeness4/5

    The tool surface covers key workflows such as search, metadata retrieval, and chapter export, but there are minor gaps like no tools for updating or deleting manga data, which might be expected in a full CRUD lifecycle. However, for a read/export-focused server, it's reasonably complete.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      MCP server for MyAnimeList that enables searching anime/manga, getting details, rankings, seasons, characters, reviews, and user profiles without authentication, and managing personal anime/manga lists with authentication (token required).
      2
      54
      86 npm
      4
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      An MCP server for anime and manga discovery, enabling search, detail retrieval, franchise watch order, seasonal schedule, character lookups, rankings, and studio filmography via natural language.
      407 npm
      2
      Apache 2.0
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      MCP server that exposes MyAnimeList v2 API with OAuth authentication, enabling anime and manga search, rankings, seasonal charts, and user list management through natural language.
      Apache 2.0