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

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"
}

get_manga_external_links

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.