L’API et le serveur MCP de MangaMade

MangaMade propose deux accès pour les développeurs. L’API REST répond en JSON sur HTTPS. Le serveur MCP permet aux assistants IA comme Claude Code, Cursor ou VS Code d’appeler MangaMade comme des outils. Les deux utilisent les mêmes clés d’API et les mêmes limites, et sont inclus dans Hobby, Créateur et Studio.

API REST

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

Serveur MCP

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

1. 1

   Choisissez une offre pour votre espace de travail. L’essai gratuit ne permet pas de créer de clés.

2. 2

   Dans les paramètres, ouvrez Clés d’API et créez une clé (réservé aux admins et au propriétaire). Copiez-la : elle ne s’affiche qu’une fois.

3. 3

   Appelez l’API avec la clé comme jeton Bearer :

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

Envoyez la clé dans l’en-tête Authorization de chaque requête. Une clé agit au nom de la personne qui l’a créée, dans l’espace de travail où elle a été créée, et jamais dans un autre.

Authorization: Bearer mm_live_…

Les clés donnent accès aux séries, aux personnages, aux chapitres, aux pages, à la génération, aux exports et aux crédits. La facturation, l’équipe, le compte, l’administration et la gestion des clés exigent toujours une session connectée et répondent session_required à une clé.

MangaMade ne conserve qu’une empreinte de chaque clé : une clé perdue ne peut pas être réaffichée. Révoquez-la et créez-en une autre. Une clé peut expirer après 30, 90 ou 365 jours, ou jamais.

Les limites s’appliquent par espace de travail et par minute, sur l’API REST et MCP réunis : toutes les clés d’un espace les partagent. Un appel d’outil MCP compte pour une requête.

Requêtes coûteuses

Elles comptent dans les deux budgets :

• planification de chapitres
• fiches de personnage
• références de style
• génération et redessin de cases
• exports
• liens de partage
• traductions

En-têtes

Chaque réponse à une requête authentifiée par clé contient :

RateLimit-Limit

le budget de la fenêtre en cours

RateLimit-Remaining

les requêtes restantes dans la fenêtre

RateLimit-Reset

les secondes avant la nouvelle fenêtre

RateLimit-Policy

le budget et la fenêtre appliqués

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

Au-delà de la limite, l’API répond 429 rate_limited avec un en-tête Retry-After en secondes. Attendez ce délai, puis réessayez.

Chaque erreur est un JSON avec un code, un message lisible et parfois des détails.

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

Les requêtes qui dépensent des crédits (références de style, fiches de personnage, génération de chapitre et redessin de cases) prennent un idempotencyKey dans le corps, de 8 à 100 caractères. Renvoyez la même clé quand vous réessayez : MangaMade ne facture qu’une fois, quel que soit le sort de la première tentative. Utilisez une nouvelle clé pour un nouveau travail.

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

Les chemins sont relatifs à l’URL de base ci-dessous. Les corps sont en JSON. Chaque route accepte et renvoie les mêmes structures que l’application MangaMade.

Coûteuse : compte dans le budget des requêtes coûteuses. Dépense des crédits : prend un idempotencyKey.

Le serveur MCP utilise le transport Streamable HTTP, sans état, avec des réponses JSON. Pointez n’importe quel client MCP vers l’URL ci-dessous avec la même clé 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_…"
      }
    }
  }
}

Outils

get_account

L’espace de travail, son offre, son solde de crédits et ses limites.

list_style_presets

Les styles prédéfinis disponibles pour une série.

list_series

Les séries de l’espace de travail.

get_series

Une série avec son style et sa bible.

create_series

Créer une série à partir d’un titre, d’un format, d’un style et d’un pitch.

create_style_anchor

Dessiner la référence de style d’une série, ou utiliser un exemple téléversé (dépense des crédits).

list_characters

Les personnages d’une série.

create_character

Ajouter un personnage à une série.

generate_character_sheet

Dessiner la fiche d’un personnage (dépense des crédits).

list_chapters

Les chapitres d’une série.

create_chapter

Créer un chapitre à partir d’un résumé.

get_chapter

Un chapitre avec son script et son état.

plan_chapter

Écrire le script du chapitre à partir de son résumé.

get_chapter_pages

Les pages et les cases d’un chapitre.

estimate_generation

Le coût en crédits du dessin d’un chapitre.

generate_chapter

Dessiner les cases d’un chapitre (dépense des crédits).

list_generation_batches

L’avancement des lots de dessin d’un chapitre.

create_export

Exporter un chapitre en PNG, PDF ou CBZ, attendre le fichier et renvoyer son lien de téléchargement.

get_export

L’état et le lien de téléchargement d’un export.

Un résumé en texte brut de MangaMade, cette page comprise, est publié pour les assistants et les moteurs de réponse.

Lire llms.txt