MCP

Référence des outils

Chaque outil exposé par le serveur MCP de DesignerBox, avec ses entrées, son format de réponse et un exemple prêt à copier.

Ouvrir dans Claude Desktop

Authentification

OAuth (recommande pour les clients IA)

Les clients IA effectuent l'enregistrement dynamique de client à la première connexion. La page /mcp/connect le fait automatiquement. Votre client reçoit un jeton d'accès de 30 jours.

Point de terminaison

Tous les appels d'outils vont vers un unique endpoint JSON-RPC 2.0 via HTTPS POST.

POST https://mcp.designerbox.ai/api

Outils

`list_designs`

Lister les créations de l'équipe actuelle, avec filtre de dossier optionnel et pagination.

Arguments

limitnumber · optionnel · default 20

Nombre maximum de résultats à retourner (1-100, défaut 20).

folderIdstring · optionnel

ID de dossier optionnel pour filtrer les créations à un dossier spécifique.

Retourne

Un objet avec designs: [{id, title, folderId, brandProfileId, createdAt, updatedAt}].

Exemple

{"jsonrpc":"2.0","method":"tools/call","id":1,
 "params":{"name":"list_designs","arguments":{"limit":10}}}

`get_design`

Récupérer les métadonnées complètes d'une création incluant titre, dossier, références de profil de marque et date de création.

Arguments

designIdstring · requis

ID de création DesignerBox depuis un appel de liste.

Retourne

Un objet avec les métadonnées complètes de la création : id, title, folderId, brandProfileId, createdAt, updatedAt.

Exemple

{"jsonrpc":"2.0","method":"tools/call","id":2,
 "params":{"name":"get_design","arguments":{"designId":"<id>"}}}

`search_designs`

Recherche plein texte dans les titres et descriptions des créations de l'équipe active.

Arguments

querystring · requis

Sous-chaine a rechercher (3-200 caracteres).

limitnumber · optionnel · default 20

Nombre maximum de résultats à retourner (1-100, défaut 20).

Retourne

Un objet avec designs: [{id, title, folderId, snippet, updatedAt}].

Exemple

{"jsonrpc":"2.0","method":"tools/call","id":3,
 "params":{"name":"search_designs","arguments":{"query":"logo","limit":10}}}

`list_brand_profiles`

Retourner tous les profils de marque de l'équipe actuelle avec voix, thèmes, niche et industrie.

Arguments

Aucun argument.

Retourne

Un objet avec profiles: [{id, name, brandVoice, mainThemes, primaryNiche, industry, isActive}].

Exemple

{"jsonrpc":"2.0","method":"tools/call","id":4,
 "params":{"name":"list_brand_profiles","arguments":{}}}

`list_folders`

Lister les dossiers dans l'espace de travail de l'équipe active. Utile pour cibler list_designs sur un dossier spécifique.

Arguments

Aucun argument.

Retourne

Un objet avec folders: [{id, name, designCount, createdAt}].

Exemple

{"jsonrpc":"2.0","method":"tools/call","id":5,
 "params":{"name":"list_folders","arguments":{}}}

`list_photo_packs`

Parcourir les packs de photos disponibles. Accepte un paramètre de langue optionnel pour les labels de catégorie.

Arguments

languagestring · optionnel

Code de langue BCP-47 pour les labels de catégorie des packs de photos (ex. en, de, es).

Retourne

Un objet avec packs: [{id, name, category, imageCount, language}].

Exemple

{"jsonrpc":"2.0","method":"tools/call","id":6,
 "params":{"name":"list_photo_packs","arguments":{}}}

`list_teams`

Retourner les équipes auxquelles appartient l'utilisateur authentifié, avec l'équipe active marquée.

Arguments

Aucun argument.

Retourne

Un objet avec currentTeamId et teams: [{teamId, teamName, isCurrent}].

Exemple

{"jsonrpc":"2.0","method":"tools/call","id":7,
 "params":{"name":"list_teams","arguments":{}}}

`get_plan_limits`

Lire le niveau d'abonnement actuel et les quotas par niveau (stockage et credits IA). Le bloc aiCredits imbrique les credits mensuels de l'abonnement, purchasedBalance des packs ponctuels, total et solde disponible. Disponible sur tous les plans.

Arguments

Aucun argument.

Retourne

Un objet avec tier, isPaid, isTrial, upgradeUrl, limits.storage ({limit, current, exceeded}), limits.aiCredits ({monthly:{limit,current,exceeded}, purchasedBalance, total, available}) et creditsAvailable ({monthly, purchasedBalance, total}). Avec ULTRA Unlimited, limits.aiCredits.monthly.limit et limits.aiCredits.total valent -1, limits.aiCredits.available est null, et creditsAvailable.monthly et creditsAvailable.total sont null. purchasedBalance est toujours un nombre (zero sans packs).

Exemple

{"jsonrpc":"2.0","method":"tools/call","id":8,
 "params":{"name":"get_plan_limits","arguments":{}}}

`get_plan`

Lire le nom du plan, le cycle de facturation (mensuel ou annuel), le statut de l'abonnement Stripe, la devise, la date de renouvellement, la fin d'essai et le nombre de sieges. Complement de get_plan_limits. Disponible sur tous les plans sans cout de credits IA.

Arguments

Aucun argument.

Retourne

Un objet avec tier, isPaid, isTrial, billingCycle (mensuel ou annuel ou null), status (statut Stripe), currency, renewalDate (ISO 8601), trialEnd (ISO 8601 ou null), quantity (sieges ou null), cancelAtPeriodEnd et upgradeUrl.

Exemple

{"jsonrpc":"2.0","method":"tools/call","id":43,
 "params":{"name":"get_plan","arguments":{}}}

`search_tools`

Rechercher le catalogue d'outils MCP par texte, catégorie ou intention. Retourne catégories, scope et descriptions.

Arguments

All optional. Call with no arguments to list every available tool.

querystring · optionnel

Recherche libre dans les noms, descriptions et tags de cas d'usage des outils.

categorystring · optionnel

Filtrer à une catégorie : designs, brand, teams, discovery, other.

Retourne

Un objet avec totalTools, matchCount, categories et tools: [{name, category, requiresScope, description, useCases, matchedOn: [name|category|description|use_case]}].

Exemple

{"jsonrpc":"2.0","method":"tools/call","id":9,
 "params":{"name":"search_tools",
           "arguments":{"query":"brand profile"}}}

`create_avatar`Plan payant

Générer une image d'avatar IA à partir d'un prompt textuel. Requiert des crédits IA et un plan payant.

Arguments

promptstring · requis

Description textuelle de l'avatar à générer (10-500 caractères).

stylestring · optionnel

Indication de style optionnelle pour le modèle d'image (ex. "photoréaliste", "dessin animé").

clientRequestIdstring · optionnel

Clé d'idempotence optionnelle. La même clé dans les 5 minutes retourne le résultat mis en cache.

Retourne

Un objet avec taskId, status, imageUrl (quand pret) et creditsUsed.

Exemple

{"jsonrpc":"2.0","method":"tools/call","id":10,
 "params":{"name":"create_avatar",
           "arguments":{"prompt":"professional headshot, warm lighting"}}}

`set_current_team`

Changer l'équipe active pour ce jeton Bearer. L'utilisateur doit en être membre. Effet immédiat pour les outils suivants.

Arguments

teamIdstring · requis

teamId cible depuis list_teams. L'appartenance est re-validee cote serveur.

Retourne

Un objet avec teamId, teamName, persisted et une note optionnelle.

Exemple

{"jsonrpc":"2.0","method":"tools/call","id":11,
 "params":{"name":"set_current_team",
           "arguments":{"teamId":"team_xxxxx"}}}

`update_brand_profile`

Mettre a jour le profil de marque actif. Champs autorises : brandVoice, mainThemes, contentGoals, contentTypes, primaryNiche, subNiches, industry, industries.

Arguments

brandVoicearray<string> · optionnel

Tableau de descripteurs de voix de marque (ex. ["audacieux", "minimal"]).

Other patchable fields: mainThemes, contentGoals, contentTypes, primaryNiche, subNiches, industry, industries.

Retourne

Un objet avec profileId, name, updated: [noms des champs modifiés] et les valeurs actuelles après le patch.

Exemple

{"jsonrpc":"2.0","method":"tools/call","id":12,
 "params":{"name":"update_brand_profile",
           "arguments":{"brandVoice":["bold","minimal"]}}}

Avatars

`list_avatars`

Listez les tâches de génération d'avatar pour l'utilisateur courant (périmètre utilisateur, pas équipe). Filtre de statut optionnel et limite (par défaut 50, max 100).

Arguments

statusstring · optionnel

Filtre optionnel de statut d'avatar : pending, generating, completed, failed, cancelled.

limitnumber · optionnel · default 50

Nombre maximum de résultats à retourner (1-100, défaut 20).

Exemple

{"jsonrpc":"2.0","method":"tools/call","id":13,
 "params":{"name":"list_avatars","arguments":{"status":"completed"}}}

`get_avatar`

Récupérez le détail complet d'une tâche d'avatar par taskUUID. Renvoie l'état de la tâche, y compris les images générées une fois terminées. Lorsque le teamId est résolu, les accès inter-équipes sont rejetés.

Arguments

taskUUIDstring · requis

Le taskUUID d'avatar renvoyé par create_avatar.

Exemple

{"jsonrpc":"2.0","method":"tools/call","id":14,
 "params":{"name":"get_avatar","arguments":{"taskUUID":"<uuid>"}}}

`get_avatar_status`

Sondez la progression d'une tâche d'avatar. Renvoie un état succinct (status, progress, message). Utilisez get_avatar pour le détail complet.

Arguments

taskUUIDstring · requis

Le taskUUID d'avatar renvoyé par create_avatar.

Exemple

{"jsonrpc":"2.0","method":"tools/call","id":15,
 "params":{"name":"get_avatar_status","arguments":{"taskUUID":"<uuid>"}}}

Modèles

`list_templates`

Listez les modèles de contenu regroupés par catégorie. Forme de catalogue (pas par équipe). Passez une langue pour restreindre à une locale ; omettez pour toutes les langues. Utilisez get_template pour le corps complet.

Arguments

languagestring · optionnel

Code de langue BCP-47 pour les labels de catégorie des packs de photos (ex. en, de, es).

Exemple

{"jsonrpc":"2.0","method":"tools/call","id":16,
 "params":{"name":"list_templates","arguments":{"language":"en"}}}

`get_template`

Récupérez un modèle par id ou slug. Renvoie le corps du modèle pour servir de structure de contenu. id ou slug est requis.

Arguments

idstring · optionnel

ID de modèle. id ou slug est requis.

slugstring · optionnel

Slug de modèle. id ou slug est requis.

Exemple

{"jsonrpc":"2.0","method":"tools/call","id":17,
 "params":{"name":"get_template","arguments":{"slug":"hero-banner"}}}

Ressources

`list_assets`

Listez les assets (images, vidéos et fichiers téléversés) de l'équipe active. Filtres optionnels par dossier ou préfixe MIME. Utilisez get_asset pour le détail complet.

Arguments

folderIdstring · optionnel

ID de dossier optionnel pour filtrer les créations à un dossier spécifique.

pagenumber · optionnel · default 1

Numéro de page (1-indexée). Par défaut 1.

limitnumber · optionnel · default 30

Nombre maximum de résultats à retourner (1-100, défaut 20).

typestring · optionnel

Filtre optionnel de préfixe MIME (par exemple "image" ou "video").

Exemple

{"jsonrpc":"2.0","method":"tools/call","id":18,
 "params":{"name":"list_assets","arguments":{"type":"image","limit":20}}}

`get_asset`

Récupérez le détail complet d'un asset par ID. Le service sous-jacent rejette les accès inter-équipes.

Arguments

idstring · requis

ID d'asset (Mongo _id) renvoyé par list_assets.

Exemple

{"jsonrpc":"2.0","method":"tools/call","id":19,
 "params":{"name":"get_asset","arguments":{"id":"<assetId>"}}}

`list_brand_assets`

Listez les assets de marque (logos, polices, palettes et similaires) de l'équipe active. Filtres optionnels par profil de marque, type de fichier, catégorie, étiquettes ou recherche libre. Distinct des profils de marque, qui décrivent voix et thèmes.

Arguments

brandProfileIdstring · optionnel

ID optionnel de profil de marque pour restreindre les assets à un profil.

fileTypestring · optionnel

Filtre optionnel de type de fichier (par exemple "png", "svg", "ttf").

categorystring · optionnel

Catégorie optionnelle (par exemple "logo", "palette", "font").

tagsarray<string> · optionnel

Liste optionnelle d'étiquettes pour cibler les assets de marque.

searchstring · optionnel

Recherche libre optionnelle sur les noms d'assets de marque.

Exemple

{"jsonrpc":"2.0","method":"tools/call","id":20,
 "params":{"name":"list_brand_assets","arguments":{"category":"logo"}}}

Génération IA

`generate_image`Plan payant

Générez une ou plusieurs images IA de manière synchrone (~30 secondes). Coûte au moins 1 crédit par image. Le palier FREE est bloqué. Passez clientRequestId pour des relances idempotentes pendant 5 minutes. Renvoie immédiatement les URL des images.

Arguments

promptstring · requis

Description textuelle de l'image à générer (1-2000 caractères).

modelstring · optionnel

ID optionnel du modèle d'image. Par défaut, la chaîne de fallback de la plateforme.

aspectRatiostring · optionnel

Ratio d'image : 1:1, 3:4, 4:3, 9:16 ou 16:9.

numberResultsnumber · optionnel · default 1

Combien d'images générer (1-4). Par défaut 1. Chaque image coûte un crédit.

negativePromptstring · optionnel

Termes optionnels que le modèle doit éviter dans l'image.

clientRequestIdstring · optionnel

Clé d'idempotence optionnelle. La même clé dans les 5 minutes retourne le résultat mis en cache.

Exemple

{"jsonrpc":"2.0","method":"tools/call","id":21,
 "params":{"name":"generate_image",
           "arguments":{"prompt":"sunset over the alps","aspectRatio":"16:9"}}}

`generate_video`Plan payant

Soumettez une tâche de génération vidéo IA. Renvoie immédiatement un taskUUID ; la tâche est traitée de manière asynchrone (adossée à BullMQ). Utilisez get_video_status pour sonder. Le coût en crédits est calculé selon le modèle et la durée. Le palier FREE est bloqué.

Arguments

promptstring · requis

Description textuelle de la vidéo à générer (1-2000 caractères).

modelstring · requis

ID du modèle vidéo. Voir /api/v1/ai/video-models pour les IDs disponibles.

typestring · optionnel · default text-to-video

Mode de génération : text-to-video (par défaut), image-to-video ou audio-to-video.

durationnumber · optionnel

Durée demandée en secondes (1-60). Par défaut, la valeur du modèle.

resolutionstring · optionnel

Chaîne de résolution optionnelle (par exemple 720p, 1080p). Dépend du modèle.

aspectRatiostring · optionnel

Ratio optionnel (par exemple 16:9, 9:16). Dépend du modèle.

inputImagestring · optionnel

Obligatoire pour image-to-video : URL publique de l'image source.

negativePromptstring · optionnel

Termes optionnels que le modèle doit éviter dans la vidéo.

clientRequestIdstring · optionnel

Clé d'idempotence optionnelle. La même clé dans les 5 minutes retourne le résultat mis en cache.

Exemple

{"jsonrpc":"2.0","method":"tools/call","id":22,
 "params":{"name":"generate_video",
           "arguments":{"prompt":"a cat surfing","model":"<videoModelId>"}}}

`get_video_status`

Sondez la progression d'une tâche de génération vidéo. Renvoie l'état complet et l'URL finale de la vidéo une fois terminée. Adossé à une file BullMQ (vrai asynchrone).

Arguments

taskUUIDstring · requis

Le taskUUID de vidéo renvoyé par generate_video.

Exemple

{"jsonrpc":"2.0","method":"tools/call","id":23,
 "params":{"name":"get_video_status","arguments":{"taskUUID":"<uuid>"}}}

Photos de stock

`search_stock_photos`

Recherchez des photos de stock simultanément sur Unsplash, Pexels et Pixabay. Renvoie les résultats par fournisseur ainsi que les erreurs par fournisseur. Recherche uniquement ; pas de listage.

Arguments

querystring · requis

Sous-chaine a rechercher (3-200 caracteres).

pagenumber · optionnel · default 1

Numéro de page (1-indexée). Par défaut 1.

perPagenumber · optionnel · default 20

Résultats par page (1-50). Par défaut 20.

Exemple

{"jsonrpc":"2.0","method":"tools/call","id":24,
 "params":{"name":"search_stock_photos","arguments":{"query":"mountains"}}}

Workflows communautaires et pipelines

`list_community_workflows`

Listez les workflows publiés par la communauté. Filtrez par catégorie, triez par populaires, récents ou vues, et limitez à les vôtres, équipe ou tous. Utilisez get_community_workflow pour le graphe complet.

Arguments

pagenumber · optionnel · default 1

Numéro de page (1-indexée). Par défaut 1.

limitnumber · optionnel · default 20

Nombre maximum de résultats à retourner (1-100, défaut 20).

categorystring · optionnel · default all

Filtre de catégorie de workflow communautaire. Utilisez "all" pour ne pas restreindre.

sortstring · optionnel · default popular

Tri : popular, recent ou views. Par défaut popular.

searchstring · optionnel

Recherche libre optionnelle pour cibler les workflows communautaires.

filterstring · optionnel · default all

Périmètre : all (tous), mine (vos workflows publiés) ou team. Par défaut all.

Exemple

{"jsonrpc":"2.0","method":"tools/call","id":25,
 "params":{"name":"list_community_workflows","arguments":{"sort":"recent"}}}

`get_community_workflow`

Récupérez le détail complet d'un workflow communautaire, y compris son graphe de nœuds et arêtes. Utilisez list_community_workflows pour parcourir.

Arguments

idstring · requis

ID de workflow communautaire (Mongo _id) renvoyé par list_community_workflows.

Exemple

{"jsonrpc":"2.0","method":"tools/call","id":26,
 "params":{"name":"get_community_workflow","arguments":{"id":"<workflowId>"}}}

`list_pipelines`

Listez les pipelines (canvas de workflow) de l'équipe active. Renvoie une forme allégée avec le nombre de nœuds ; utilisez get_pipeline pour le graphe complet.

Arguments

pagenumber · optionnel · default 1

Numéro de page (1-indexée). Par défaut 1.

limitnumber · optionnel · default 20

Nombre maximum de résultats à retourner (1-100, défaut 20).

sortstring · optionnel · default updatedAt

Tri des pipelines : updatedAt, createdAt ou name. Par défaut updatedAt.

Exemple

{"jsonrpc":"2.0","method":"tools/call","id":27,
 "params":{"name":"list_pipelines","arguments":{}}}

`get_pipeline`

Récupérez un pipeline (canvas de workflow) par ID, dans le périmètre de l'équipe active. Renvoie le graphe complet de nœuds et arêtes.

Arguments

idstring · requis

ID de pipeline (Mongo _id) renvoyé par list_pipelines.

Exemple

{"jsonrpc":"2.0","method":"tools/call","id":28,
 "params":{"name":"get_pipeline","arguments":{"id":"<pipelineId>"}}}

`list_whiteboards`

Listez les whiteboards MySpace de l'utilisateur courant, dans le périmètre de l'équipe active. Le contenu du whiteboard est omis dans la vue liste ; utilisez l'endpoint de lecture dédié pour le contenu.

Arguments

Aucun argument.

Exemple

{"jsonrpc":"2.0","method":"tools/call","id":29,
 "params":{"name":"list_whiteboards","arguments":{}}}

Conversations et whiteboards

`list_conversations`

Listez les conversations Assistant IA de l'utilisateur pour l'équipe active. Filtre de statut optionnel (active ou archived) et filtre d'étiquettes. Utilisez get_conversation pour l'historique complet.

Arguments

statusstring · optionnel · default active

Filtre de statut de conversation : active (par défaut) ou archived.

pagenumber · optionnel · default 1

Numéro de page (1-indexée). Par défaut 1.

limitnumber · optionnel · default 20

Nombre maximum de résultats à retourner (1-100, défaut 20).

tagsarray<string> · optionnel

Liste optionnelle d'étiquettes. Renvoie les conversations correspondant à au moins une étiquette.

Exemple

{"jsonrpc":"2.0","method":"tools/call","id":30,
 "params":{"name":"list_conversations","arguments":{"status":"archived"}}}

`get_conversation`

Récupérez une conversation Assistant IA avec son historique complet de messages. Les accès inter-utilisateurs et inter-équipes sont rejetés par le service.

Arguments

idstring · requis

ID de conversation renvoyé par list_conversations.

Exemple

{"jsonrpc":"2.0","method":"tools/call","id":31,
 "params":{"name":"get_conversation","arguments":{"id":"<conversationId>"}}}

Galeries et skills

`generate_design`Plan payant

Genere un design de galerie en appliquant une skill a une image source (image-to-image). Synchrone ~30-45s. Coute 1 credit IA par appel. Le tier FREE est bloque. Utilise list_skills pour decouvrir les valeurs skillId valides. Passe clientRequestId pour les retries idempotents sous 5 minutes.

Arguments

sourceImageUrlstring · requis

URL publique de l'image source a transformer.

skillIdstring · requis

ID de la skill a appliquer. Appelle list_skills d'abord pour decouvrir les IDs disponibles.

clientRequestIdstring · optionnel

Clé d'idempotence optionnelle. La même clé dans les 5 minutes retourne le résultat mis en cache.

Exemple

{"jsonrpc":"2.0","method":"tools/call","id":32,
 "params":{"name":"generate_design",
           "arguments":{"sourceImageUrl":"https://example.com/photo.jpg","skillId":"<skill>"}}}

`list_galleries`

Liste les assets de galerie IA (designs générés via generate_design) pour l'équipe et l'utilisateur actifs. Pagination et filtre de catégorie optionnels. Retourne une forme allégée : assetId, assetUrl, slug, displayName, galleryCategory, createdAt.

Arguments

limitnumber · optionnel · default 20

Nombre maximum de résultats à retourner (1-100, défaut 20).

pagenumber · optionnel · default 1

Numéro de page (1-indexée). Par défaut 1.

categorystring · optionnel

Filtre optionnel de catégorie de galerie (par exemple "portrait", "landscape").

Exemple

{"jsonrpc":"2.0","method":"tools/call","id":33,
 "params":{"name":"list_galleries","arguments":{"limit":10}}}

`list_skills`

Liste les skills actives disponibles pour generate_design. Retourne skillId, name, type (image ou video), group et category. Utilise-le pour decouvrir les valeurs skillId valides avant d'appeler generate_design.

Arguments

typestring · optionnel

Filtre optionnel : skills image ou video.

Exemple

{"jsonrpc":"2.0","method":"tools/call","id":34,
 "params":{"name":"list_skills","arguments":{"type":"image"}}}

Génération cinématographique

`generate_cinema_studio`Plan payant

Génère des images IA cinématographiques en combinant boîtier, objectif, focale, ouverture et ratio. Synchrone ~30s. Coûte 1 crédit IA par image. Le tier FREE est bloqué. Passe referenceImageUrl pour basculer en mode reference-image (transfert de style). Passe clientRequestId pour les retries idempotents sous 5 minutes.

Arguments

scenePromptstring · requis

Description de la scene pour le plan cinematographique (1-2000 caracteres).

cameraBodystring · optionnel · default arri-alexa-65

ID du boitier camera controlant la signature de rendu (par exemple "arri-alexa-65", "red-v-raptor", "sony-venice-2").

lensstring · optionnel · default panavision-primo

ID du descripteur d'objectif (par exemple "classic-anamorphic", "master-prime", "panavision-primo").

focalLengthstring · optionnel · default fl-50

ID de focale de fl-14 a fl-200 (14mm a 200mm).

aperturestring · optionnel · default f-2.8

ID d'ouverture de f-1.2 a f-11.

aspectRatiostring · optionnel · default 16:9

Ratio d'aspect : 16:9, 1:1, 9:16 ou 4:3. Defaut 16:9.

imageCountnumber · optionnel · default 2

Nombre de frames cinématographiques à générer (1-4). Défaut 2. Chaque frame coûte un crédit.

referenceImageUrlstring · optionnel

URL d'image de référence optionnelle. Si fournie, bascule en mode reference-image (transfert de style).

clientRequestIdstring · optionnel

Clé d'idempotence optionnelle. La même clé dans les 5 minutes retourne le résultat mis en cache.

Exemple

{"jsonrpc":"2.0","method":"tools/call","id":35,
 "params":{"name":"generate_cinema_studio",
           "arguments":{"scenePrompt":"a wide shot of a foggy harbour at dawn","aspectRatio":"16:9","imageCount":2}}}

Gestion des taches asynchrones

`cancel_avatar_task`Destructif

Annule une tâche de génération avatar en attente ou en cours. Le remboursement côté service rend les crédits précédemment débités. Les tâches en état terminal (completed ou failed) ne peuvent pas être annulées ; l'appel retourne une erreur structurée.

Arguments

taskUUIDstring · requis

Le taskUUID d'avatar renvoyé par create_avatar.

Exemple

{"jsonrpc":"2.0","method":"tools/call","id":36,
 "params":{"name":"cancel_avatar_task","arguments":{"taskUUID":"<uuid>"}}}

`cancel_video_task`Destructif

Annule une tâche de génération vidéo en attente ou en cours. Le remboursement côté service rend les crédits précédemment débités. Les tâches en état terminal (completed ou failed) ne peuvent pas être annulées ; l'appel retourne une erreur structurée.

Arguments

taskUUIDstring · requis

Le taskUUID de vidéo renvoyé par generate_video.

Exemple

{"jsonrpc":"2.0","method":"tools/call","id":37,
 "params":{"name":"cancel_video_task","arguments":{"taskUUID":"<uuid>"}}}

`list_video_tasks`

Liste les tâches de génération vidéo de l'utilisateur courant (par utilisateur, parité avec list_avatars). Filtre de statut optionnel (pending, processing, completed, failed, cancelled) et limite (défaut 20, max 100). Utilise get_video_status pour le polling détaillé.

Arguments

statusstring · optionnel

Filtre de statut optionnel : pending, processing, completed, failed, cancelled.

limitnumber · optionnel · default 20

Nombre maximum de résultats à retourner (1-100, défaut 20).

Exemple

{"jsonrpc":"2.0","method":"tools/call","id":38,
 "params":{"name":"list_video_tasks","arguments":{"status":"completed"}}}

Detail par recuperation unitaire

`get_brand_profile`

Récupère le détail complet d'un seul profil de marque par ID. L'accès inter-équipes est rejeté avec un not-found générique (pas de fuite d'existence). Utilise list_brand_profiles pour énumérer les IDs.

Arguments

brandProfileIdstring · requis

ID de profil de marque (uuid) retourne par list_brand_profiles.

Exemple

{"jsonrpc":"2.0","method":"tools/call","id":39,
 "params":{"name":"get_brand_profile","arguments":{"brandProfileId":"<uuid>"}}}

`get_brand_asset`

Récupère le détail complet d'un seul asset de marque par ID. L'accès inter-équipes est rejeté avec un not-found générique (pas de fuite d'existence). Utilise list_brand_assets pour énumérer les IDs.

Arguments

brandAssetIdstring · requis

ID d'asset de marque (uuid) retourne par list_brand_assets.

Exemple

{"jsonrpc":"2.0","method":"tools/call","id":40,
 "params":{"name":"get_brand_asset","arguments":{"brandAssetId":"<uuid>"}}}

`get_photo_pack`

Récupère une seule catégorie de photo-pack incluant ses images. Forme catalogue (sans scope d'équipe). Code langue optionnel ; repli sur l'anglais si le locale demandé manque.

Arguments

categoryIdstring · requis

ID de catégorie photo-pack (par exemple "3d-rendered-object").

languagestring · optionnel · default en

Code de langue BCP-47 pour les labels de catégorie des packs de photos (ex. en, de, es).

Exemple

{"jsonrpc":"2.0","method":"tools/call","id":41,
 "params":{"name":"get_photo_pack","arguments":{"categoryId":"3d-rendered-object"}}}

`get_whiteboard`

Récupère un seul whiteboard par ID incluant son blob de contenu complet. Les whiteboards sont par utilisateur (créateur uniquement) ; l'accès inter-utilisateurs est rejeté avec un not-found générique.

Arguments

whiteboardIdstring · requis

ID de whiteboard (uuid) retourne par list_whiteboards.

Exemple

{"jsonrpc":"2.0","method":"tools/call","id":42,
 "params":{"name":"get_whiteboard","arguments":{"whiteboardId":"<uuid>"}}}

Ressources MCP

Les ressources sont un contexte en lecture seule que le client peut recuperer via la methode MCP resources/read. Claude les charge au debut de la conversation.

`designerbox://account/summary`

Plan, crédits IA utilisés / limite, nombre de créations, nom de l'équipe active et nombre de dossiers.

`designerbox://brand-profiles/active`

Le profil de marque actif de l'équipe actuelle avec les champs pertinents pour le LLM.

`designerbox://teams/current`

Métadonnées de l'équipe actuelle (teamId, teamName) et nombre total d'équipes disponibles.

`designerbox://recent-designs`

Les 10 créations les plus récentes de l'équipe active, pré-chargées dans le contexte de Claude.

Workflows nommes

Raccourcis du menu de commandes qui enchaînent plusieurs outils. Choisissez-en un et laissez votre assistant réaliser une tâche en plusieurs étapes avec confirmation avant toute mutation.

`/weekly-design-batch`

Lit le profil de marque et les créations récentes, puis propose des thèmes et objectifs de dossier pour la semaine à venir.

`/audit-gallery`

Parcourt les créations récentes via list_designs et signale celles qui s'écartent du profil de marque actif. Lecture seule.

`/brand-sync`

Compare les créations avec le profil de marque actif et identifie les lacunes. Suggère des mises à jour; vous approuvez avant tout changement.

`/regenerate-with-style`

Regenere un design existant dans un style different. Appelle get_asset, puis list_skills si necessaire, puis generate_design.

Endpoints de decouverte et OAuth

Metadonnees conformes aux standards pour que tout client MCP puisse s autoconfigurer.

GET /.well-known/oauth-protected-resource/api RFC 9728
GET /.well-known/oauth-authorization-server RFC 8414
GET /oauth/.well-known/openid-configuration OIDC
POST /oauth/reg Dynamic Client Registration (RFC 7591)
GET /oauth/auth Authorize (PKCE-S256 required)
POST /oauth/token Token exchange

Pilotez votre flux de travail de design depuis n importe quel assistant IA

Recherchez des créations, explorez des packs de photos, mettez à jour des profils de marque et générez des avatars en discutant avec Claude ou Cursor. Une connexion sécurisée, toutes les fonctionnalités DesignerBox.

Ouvrir dans Claude Desktop

Référence des outils

Authentification

OAuth (recommande pour les clients IA)

Point de terminaison

Outils

list_designs

Arguments

Retourne

Exemple

get_design

Arguments

Retourne

Exemple

search_designs

Arguments

Retourne

Exemple

list_brand_profiles

Arguments

Retourne

Exemple

list_folders

Arguments

Retourne

Exemple

list_photo_packs

Arguments

Retourne

Exemple

list_teams

Arguments

Retourne

Exemple

get_plan_limits

Arguments

Retourne

Exemple

get_plan

Arguments

Retourne

Exemple

search_tools

Arguments

Retourne

Exemple

create_avatarPlan payant

Arguments

Retourne

Exemple

set_current_team

Arguments

Retourne

Exemple

update_brand_profile

Arguments

Retourne

Exemple

Avatars

list_avatars

Arguments

Exemple

get_avatar

Arguments

Exemple

get_avatar_status

Arguments

Exemple

Modèles

list_templates

Arguments

Exemple

get_template

Arguments

Exemple

Ressources

list_assets

Arguments

Exemple

get_asset

Arguments

`list_designs`

`get_design`

`search_designs`

`list_brand_profiles`

`list_folders`

`list_photo_packs`

`list_teams`

`get_plan_limits`

`get_plan`

`search_tools`

`create_avatar`Plan payant

`set_current_team`

`update_brand_profile`

`list_avatars`

`get_avatar`

`get_avatar_status`

`list_templates`

`get_template`

`list_assets`

`get_asset`

`list_brand_assets`

`generate_image`Plan payant

`generate_video`Plan payant

`get_video_status`

`search_stock_photos`

`list_community_workflows`

`get_community_workflow`

`list_pipelines`

`get_pipeline`

`list_whiteboards`

`list_conversations`

`get_conversation`

`generate_design`Plan payant

`list_galleries`

`list_skills`

`generate_cinema_studio`Plan payant

`cancel_avatar_task`Destructif

`cancel_video_task`Destructif

`list_video_tasks`

`get_brand_profile`

`get_brand_asset`