La API y el servidor MCP de MangaMade

MangaMade ofrece dos vías para desarrolladores. La API REST responde en JSON sobre HTTPS. El servidor MCP permite que asistentes de IA como Claude Code, Cursor o VS Code llamen a MangaMade como herramientas. Ambas usan las mismas claves de API y los mismos límites, y vienen con Hobby, Creador y Studio.

API REST

https://api.mangamade.com/api/v1

Servidor MCP

https://api.mangamade.com/api/mcp

1. 1

   Elige un plan para tu espacio de trabajo. La prueba gratuita no incluye claves de API.

2. 2

   En Ajustes, abre Claves de API y crea una clave (solo pueden hacerlo los administradores y el propietario). Cópiala: solo se muestra una vez.

3. 3

   Llama a la API con la clave como token Bearer:

   curl https://api.mangamade.com/api/v1/series \
     -H "Authorization: Bearer mm_live_…"

Envía la clave en la cabecera Authorization de cada solicitud. Una clave actúa en nombre de quien la creó, en el espacio de trabajo donde se creó, y nunca en otro.

Authorization: Bearer mm_live_…

Las claves llegan a series, personajes, capítulos, páginas, generación, exportaciones y créditos. La facturación, el equipo, la cuenta, la administración y la gestión de claves siempre requieren una sesión iniciada y responden session_required a una clave.

MangaMade solo guarda un hash de cada clave, así que una clave perdida no se puede volver a mostrar: revócala y crea otra. Las claves pueden caducar a los 30, 90 o 365 días, o nunca.

Los límites se aplican por espacio de trabajo y por minuto, sumando la API REST y MCP: todas las claves de un espacio los comparten. Una llamada a una herramienta MCP cuenta como una solicitud.

Solicitudes costosas

Cuentan en los dos presupuestos:

• planificación de capítulos
• hojas de personaje
• referencias de estilo
• generación y redibujo de viñetas
• exportaciones
• enlaces para compartir
• traducciones

Cabeceras

Cada respuesta a una solicitud con clave incluye:

RateLimit-Limit

el presupuesto de la ventana actual

RateLimit-Remaining

las solicitudes que quedan en la ventana

RateLimit-Reset

los segundos hasta que se reinicie la ventana

RateLimit-Policy

el presupuesto y la ventana que se aplican

RateLimit-Limit: 120
RateLimit-Remaining: 117
RateLimit-Reset: 42
RateLimit-Policy: 120;w=60

Si superas el límite, la API responde 429 rate_limited con una cabecera Retry-After en segundos. Espera ese tiempo y vuelve a intentarlo.

Cada error es un JSON con un código, un mensaje legible y, a veces, detalles.

{
  "code": "rate_limited",
  "message": "Too many requests",
  "details": {}
}

Las solicitudes que gastan créditos (referencias de estilo, hojas de personaje, generación de capítulos y redibujo de viñetas) llevan un idempotencyKey en el cuerpo, de 8 a 100 caracteres. Envía la misma clave al reintentar y MangaMade cobrará una sola vez, pase lo que pase con el primer intento. Usa una clave nueva para cada trabajo nuevo.

curl -X POST https://api.mangamade.com/api/v1/panels/{id}/regenerate \
  -H "Authorization: Bearer mm_live_…" \
  -H "Content-Type: application/json" \
  -d '{"idempotencyKey":"panel-42-retry-1"}'

Las rutas son relativas a la URL base de abajo. Los cuerpos van en JSON. Cada ruta acepta y devuelve las mismas estructuras que la aplicación de MangaMade.

Costosa: cuenta en el presupuesto de solicitudes costosas. Gasta créditos: lleva un idempotencyKey.

El servidor MCP usa Streamable HTTP, sin estado, con respuestas JSON. Apunta cualquier cliente MCP a la URL de abajo con la misma clave Bearer.

claude mcp add --transport http mangamade \
  https://api.mangamade.com/api/mcp \
  --header "Authorization: Bearer mm_live_…"

{
  "mcpServers": {
    "mangamade": {
      "url": "https://api.mangamade.com/api/mcp",
      "headers": {
        "Authorization": "Bearer mm_live_…"
      }
    }
  }
}

Herramientas

get_account

El espacio de trabajo, su plan, su saldo de créditos y sus límites.

list_style_presets

Los estilos predefinidos que puede usar una serie.

list_series

Las series del espacio de trabajo.

get_series

Una serie con su estilo y su biblia.

create_series

Crear una serie a partir de un título, un formato, un estilo y una premisa.

create_style_anchor

Dibujar la referencia de estilo de una serie, o usar una muestra subida (gasta créditos).

list_characters

Los personajes de una serie.

create_character

Añadir un personaje a una serie.

generate_character_sheet

Dibujar la hoja de un personaje (gasta créditos).

list_chapters

Los capítulos de una serie.

create_chapter

Crear un capítulo a partir de un resumen.

get_chapter

Un capítulo con su guion y su estado.

plan_chapter

Escribir el guion del capítulo a partir de su resumen.

get_chapter_pages

Las páginas y viñetas de un capítulo.

estimate_generation

Cuánto costará en créditos dibujar un capítulo.

generate_chapter

Dibujar las viñetas de un capítulo (gasta créditos).

list_generation_batches

El progreso de los lotes de dibujo de un capítulo.

create_export

Exportar un capítulo en PNG, PDF o CBZ, esperar el archivo y devolver su enlace de descarga.

get_export

El estado y el enlace de descarga de una exportación.

Publicamos un resumen en texto plano de MangaMade, incluida esta página, para asistentes y motores de respuesta.

Leer llms.txt