# MangaBaka

> MangaBaka is a public manga and light novel metadata site with a browsable web app, public API, OpenAPI specification, and database-backed documentation pages.

This file is a dynamic index of high-signal public resources for language models and agents.
Site-local links are emitted using the current request origin, stable public JSON endpoints are included for structured access, and public documentation entries under `/pages` are included from the live database.

URL patterns:
- Series pages are rooted at `/{type}/{id}/{slug}` — for example `/manga/222/The-Apothecary-Diaries` — with related subroutes such as `/news`, `/related`, `/covers` and `/report` appended. `{type}` is one of manga, manhwa, manhua, novel, oel, other.
- The legacy `/{id}` form still resolves but 301s to the canonical URL above; prefer the canonical form when citing or linking.
- Browse hubs: `/{type}` and `/{type}/{sort}`, plus the untyped `/popular`, `/highest-rated`, `/new` and `/trending`. Genre and year listings live at `/{type}/genre/{id}/{slug}` and `/{type}/year/{year}`.
- Documentation pages live under `/pages/{section}/{id}-{slug}` and are also discoverable from `/pages`.
- Public REST endpoints are rooted at `https://api.mangabaka.org/...`, while the canonical machine-readable OpenAPI schema is `https://mangabaka.org/api.json`.

## Overview

- [MangaBaka home](https://mangabaka.org/): Main site for manga and light novel metadata, discovery, and browsing.
- [Most popular](https://mangabaka.org/popular): All-time most-read series across every format.
- [Latest updates](https://mangabaka.org/new): Most recently catalogued series, every format.
- [Documentation index](https://mangabaka.org/pages): Index of public documentation and reference pages.
- [Tag browser](https://mangabaka.org/t): Browse public tags used to classify series and related entities.
- [Database overview](https://mangabaka.org/database): Human-readable overview of the database and data model.

## MCP server

- [MangaBaka MCP endpoint](https://api.mangabaka.org/mcp): Model Context Protocol server over Streamable HTTP, POST only, anonymous with no key or account. Speaks protocol revision 2026-07-28 and rejects every earlier one. Prefer it over the REST endpoints below for agent use: it returns compact records built to be read rather than rendered, and each tool documents the filtering traps that produce confidently wrong answers otherwise. 18 tools: series_search, series_match, series_get, series_get_tags, series_get_relationships, series_get_links, series_get_titles, series_rising, series_hidden_gems, series_recommend, series_readers_also_like, series_from_source_id, tags_find, tags_list, publisher_search, publisher_get, publisher_stats, publisher_similar.

## API

- [API documentation](https://mangabaka.org/data/api): Overview of the public API and usage notes.
- [API explorer](https://mangabaka.org/data/api/explorer): Interactive API explorer backed by the OpenAPI specification.
- [OpenAPI specification](https://mangabaka.org/api.json): Machine-readable API schema for MangaBaka.
- [API base URL](https://api.mangabaka.org): Canonical production API root.

## Structured data endpoints

- [Series search endpoint](https://api.mangabaka.org/v1/series/search): Search and filter series records through the public JSON API.
- [Series endpoint](https://api.mangabaka.org/v1/series): Entry point for series records and per-series API resources.
- [News endpoint](https://api.mangabaka.org/v1/news): Programmatic access to aggregated news items.
- [Tags endpoint](https://api.mangabaka.org/v1/tags): Public tag taxonomy and related metadata.
- [Genres endpoint](https://api.mangabaka.org/v1/genres): Genre list exposed by the public API.
- [Collections endpoint](https://api.mangabaka.org/v1/collections): Collection records and related collection APIs.
- [Works endpoint](https://api.mangabaka.org/v1/works): Work-level records exposed as public JSON.

## Documentation

- [Public pages index](https://mangabaka.org/pages): Entry point for public documentation pages stored in the MangaBaka database.
- [MangaBaka General Title Styling and Traits](https://mangabaka.org/pages/general/1-mangabaka-general-title-styling-and-traits): General title styling guide for titles and other identifyable text.
- [Publisher Name Styling Guide](https://mangabaka.org/pages/general/8-publisher-name-styling-guide): Guidelines for how official publisher names should be styled in the database.
- [Title Type Designations](https://mangabaka.org/pages/general/11-title-type-designations): Clarification about the title type definitions here on MangaBaka for submissions.
- [Markdown reference](https://mangabaka.org/pages/help/6-markdown-reference): Stuff we can do with markdown
- [Titles v2](https://mangabaka.org/pages/announcements/15-titles-v2): Learn more about titles v2 (and its breaking changes)
- [Development Roadmap](https://mangabaka.org/pages/announcements/23-roadmap): Curious about what’s coming next? Below is the current development roadmap.
- [UserScript / Browser Extension integration guide](https://mangabaka.org/pages/api/12-userscript-browser-extension-integration-guide): How to properly inject data from UserScript/Brower Extension documentation
- [Submission API](https://mangabaka.org/pages/api/24-submission-api): How to use the submission API
- [Links (WIP)](https://mangabaka.org/pages/data-and-submissions/25-links): Rules for the submission of links to the various pages, along with moderating Link Domains.
- [How popularity is calculated](https://mangabaka.org/pages/how-it-works/26-how-popularity-is-calculated): What does 5th most popular manhwa actually mean? Turns out you can't just average the big manga databases - their scales don't line up — so we use a smarter trick to fuse them (plus MangaBaka reader libraries) into one daily ranking. Here's how it works, and why it's about reach, not quality
- [Similar series / Readers also like](https://mangabaka.org/pages/how-it-works/28-similar-series-and-readers-also-like): Near the bottom of every series page there are two recommendation rails: Similar series and Readers also like. They look alike, but they answer different questions and are built from completely different data. Here's how each one works.
- [MangaBaka Japanese Romanization Style](https://mangabaka.org/pages/romanization/2-mangabaka-japanese-romanization-style): MangaBaka Japanese romanization style for romanizing Japanese titles.
- [MangaBaka Korean Romanisation Style](https://mangabaka.org/pages/romanization/3-mangabaka-korean-romanisation-style): MangaBaka Korean romanization style for romanizing Korean titles. - WORK IN PROGRESS
- [Mangabaka Chinese Romanisation Style](https://mangabaka.org/pages/romanization/4-mangabaka-chinese-romanisation-style): MangaBaka Chinese romanization style for romanizing Chinese titles. - WORK IN PROGRESS
- [Japanese Romanization LUT for Wasei-Eigo and Other loanwords](https://mangabaka.org/pages/romanization/5-japanese-romanization-lut-for-wasei-eigo-and-other-loanwords): Romanization of foreign loanwords, abbreviated/clipped (slang )loanwords, Japanese-made English words, Wasei-Eigo, and embedded loanwords that underwent semantic narrowing or specialization.
- [MangaBaka Japanese Romanization YAML Ruleset](https://mangabaka.org/pages/romanization/13-mangabaka-japanese-romanization-yaml-ruleset): YAML ruleset of the romanization for LLMs. Current version: 2.0-alpha2
- [Mangabaka Data Policy & Submission Criteria](https://mangabaka.org/pages/policy/14-mangabaka-data-policy-submission-criteria): This policy outlines the standards for data intended for Mangabaka and the procedure for submitting it. - WORK IN PROGRESS this is a compiled version of help notes in edit page
- [Content Scope & Strengths](https://mangabaka.org/pages/policy/18-content-scope-strengths-roadmap): A detailed comparison of MangaBaka’s inclusion policies, metadata features, open‑data philosophy. This doc links to every platform’s data guidelines and current limitations against MyAnimeList, AniList, Anime‑Planet, and MangaUpdates
- [Staff & Contributor Role Policy](https://mangabaka.org/pages/policy/22-staff-contributor-role-policy): This document defines the roles, permissions, and promotion paths for the MangaBaka data team, together with the quarterly activity review process and the specialisation system.
- [Advanced Content Rating Criteria](https://mangabaka.org/pages/proposals/21-advanced-content-rating-criteria): A granular content rating system for manga and novels that scores works on three axes — Sexual Content, Violence/Gore, and Drugs.
- [컨텐츠 연령 등급 기준](https://mangabaka.org/pages/proposals/29-advanced-content-rating-criteria): 만화와 소설을 위한 세분화된 연령 평가 시스템으로, 성적 콘텐츠, 폭력/고어, 마약의 세 가지 축으로 작품을 평가합니다.

## Discovery and activity

- [News](https://mangabaka.org/news): Recent news and announcements relevant to tracked series and site updates.
- [Log](https://mangabaka.org/log): Change log and activity views for recent edits and system events.
- [Bookmarklet](https://mangabaka.org/bookmarklet): Browser bookmarklet and integration entry point.
- [Score distribution data](https://mangabaka.org/data/score-distribution): Public score distribution visualizations and data access entry point.

## Optional

- [Latest redirect route](https://mangabaka.org/latest): Shortcut route that redirects to the latest-updates search view.