Aller au contenu principal
Commencer gratuitementCommencer
MCP

Référence des outils MCP

Les 75 outils MCP dans une seule liste. Chaque entrée montre ce que fait l'outil et ses entrées. Beaucoup montrent aussi ce que l'appel renvoie.

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_designsmcp:read

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).
folderIdstring · optionnel
ID de dossier optionnel. Renvoie uniquement les éléments de ce dossier.

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_designmcp:read

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_designsmcp:read

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).

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_profilesmcp:read

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_foldersmcp:read

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_packsmcp:read

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_teamsmcp:read

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_limitsmcp:read

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_planmcp:read

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_toolsmcp:read

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_avatarmcp:writePlan 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_teammcp:write

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_profilemcp:write

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_avatarsmcp:read

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).

Exemple

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

get_avatarmcp:read

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_statusmcp:read

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

Ressources

list_assetsmcp:read

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. Renvoie uniquement les éléments de ce dossier.
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).
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_assetmcp:read

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_assetsmcp:read

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_imagemcp:writePlan payant

Générez une ou plusieurs images IA de manière synchrone (environ 30 secondes). Le coût en crédits dépend du modèle. Le palier FREE est bloqué. Passez clientRequestId pour des relances idempotentes pendant 5 minutes. Renvoie immédiatement les URL des images générées.

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.
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_videomcp:writePlan 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 de vidéo demandée (1-60). Sans valeur, la durée par défaut du modèle s'applique.
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_statusmcp:read

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_photosmcp:read

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_workflowsmcp:read

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).
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_workflowmcp:read

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_pipelinesmcp:read

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).
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_pipelinemcp:read

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_whiteboardsmcp:read

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_conversationsmcp:read

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).
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_conversationmcp:read

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_designmcp:writePlan 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_galleriesmcp:read

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).
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_skillsmcp:read

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_studiomcp:writePlan payant

Générez des images IA cinématographiques en combinant boîtier, objectif, focale, ouverture et format d'image. Synchrone, environ 30 secondes. Le coût en crédits dépend du modèle. Le palier FREE est bloqué. Fournissez referenceImageUrl pour passer en mode reference-image (transfert de style). Passez clientRequestId pour des relances idempotentes pendant 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.
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_taskmcp:writeDestructif

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_taskmcp:writeDestructif

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_tasksmcp:read

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).

Exemple

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

Detail par recuperation unitaire

get_brand_profilemcp:read

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_assetmcp:read

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_packmcp:read

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_whiteboardmcp:read

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

Votre espace de travail

delete_designmcp:writeDestructif

Supprimer une création. Votre client vous le demande avant.

Arguments

idstring

delete_assetmcp:writeDestructif

Supprimer une image ou une vidéo des Assets.

Arguments

idstring

Images

edit_imagemcp:write

Changer une partie d'une image, garder le reste.

Arguments

referenceImagesarray · requis
promptstring
editModestring
default, inpaint_removal, inpaint_insertion, outpaint, style, bgswap, product_image
modelstring
numberResultsnumber
1 … 4
keepHairstyleboolean
clientRequestIdstring

Retourne

La réponse contient creditsCharged, les crédits que la retouche a coûtés.

apply_image_templatemcp:write

Lancer un template par son nom, avec votre photo.

Arguments

templateIdstring
slugstring
referenceImagesarray
numberResultsnumber
1 … 10
aspectRatiostring
1:1, 4:5, 3:4, 2:3, 4:3, 3:2, 5:4, 9:16, 16:9, 21:9

Retourne

La réponse contient creditsCharged, les crédits que l'exécution a coûtés. Le prompt du template n'est jamais renvoyé.

remove_backgroundmcp:write

Un PNG transparent du produit.

Arguments

imageUrlstring

Retourne

L'URL d'un PNG à fond transparent.

photo_anglesmcp:write

Un nouvel angle de vue du même produit.

Arguments

rotationnumber · requis
0 … 360
tiltnumber · requis
-90 … 90
imageUrlstring
zoomnumber
0 … 10

spotlightmcp:write

Changer la lumière : sens, type, force, couleur.

Arguments

azimuthnumber · requis
0 … 360
elevationnumber · requis
-90 … 90
lightTypestring · requis
soft, hard, rim, key
brightnessnumber · requis
0 … 100
imageUrlstring
lightColorstring

flat_laymcp:write

Un flat lay depuis plusieurs photos produit.

Arguments

imageUrlsarray<string> · requis
backgroundstring · requis
marble, wood, concrete, fabric, pink, neutral
stylestring · requis
minimal, luxe, bohemian, geometric, organic
itemCountnumber · requis
1 … 10
positionPromptstring

product_admcp:write

Une image publicitaire depuis une photo produit.

Arguments

adStylestring · requis
minimal, bold, elegant, modern, vintage
backgroundstring · requis
white, gradient, studio, lifestyle, abstract
lightingstring · requis
soft, dramatic, natural, studio
imageUrlstring
productNamestring
productDescriptionstring
brightnessnumber
0 … 100

virtual_try_onmcp:write

Un vêtement porté par la personne de la photo.

Arguments

personImageUrlstring
garmentImageUrlstring
maskImageUrlstring
modelstring
numberResultsnumber
1 … 4

skin_retouchmcp:write

Une peau nette, pose et arrière-plan gardés.

Arguments

imageUrlstring
intensitystring
light, medium, heavy
presetstring
enhance
skinSmoothingboolean
blemishRemovalboolean
imperfectionRemovalboolean
complexionEveningboolean
wrinkleReductionboolean
eyeBrighteningboolean
teethWhiteningboolean
birthMarkRemovalboolean
addSkinTextureboolean
addFrecklesboolean

Vidéo

fashion_videomcp:write

Une démarche de défilé, la tenue inchangée.

Arguments

motionTypestring · requis
runway, spin, fabric-flow, zoom-in, parallax, slow-pan, time-freeze
imageUrlstring
motionSpeedstring
slow, normal, fast
durationnumber
1 … 60
aspectRatiostring
modelstring
descriptionstring
addMusicboolean

Retourne

Un taskUUID. La vidéo se génère en arrière-plan. Suivez-la avec get_video_status.

styled_scenemcp:write

Une scène par ville, saison et heure du jour.

Arguments

imageUrlstring
citystring
customLocationstring
seasonstring
spring, summer, autumn, winter
timeOfDaystring
golden-hour, blue-hour, midday, night
modelstring

create_video_projectmcp:write

Une timeline : clips, titres, son et rendu.

Arguments

aspectRatiostring · requis
16:9, 9:16, 1:1, 4:5
clipsarray · requis
1 … 20
namestring
audioClipsarray
textOverlaysarray
≤ 120
elementsarray
≤ 40
tintsarray
≤ 20
lutstring
none, cinematic, teal-orange, warm-film, cool, vintage, bw, vivid, dramatic, noir, california, clarendon, golden, fade, sepia, moody, blush, cyberpunk, bleach, crossprocess, mocha, frost, tungsten, pastel, retro
gradestring
none, warm, cool, bw, vivid, muted
blurnumber
0 … 20
vignetteboolean
fadeInnumber
0 … 5
fadeOutnumber
0 … 5
speednumber
0.25 … 4
fpsnumber
backgroundstring
#RRGGBB
outputobject

Retourne

L'id du nouveau projet vidéo. L'appel ne génère pas la vidéo et ne coûte aucun crédit.

render_video_projectmcp:write

Transformer la timeline en un fichier MP4.

Arguments

projectIdstring

Retourne

L'appel répond tout de suite. Le rendu prend environ une à cinq minutes. Suivez-le avec get_video_render_status.

get_video_render_statusmcp:read

Le MP4 quand la timeline est terminée.

Arguments

projectIdstring

Retourne

L'URL du MP4 final quand le rendu est terminé. L'erreur quand le rendu a échoué.

delete_video_projectmcp:writeDestructif

Supprimer une timeline dont vous n'avez plus besoin.

Arguments

projectIdstring

Workflows et apps

run_pipelinemcp:write

Lancer un workflow et lire chaque étape.

Arguments

pipelineIdstring
nodesarray
edgesarray
seedOutputsobject

Retourne

Les résultats de chaque étape : images, vidéos ou texte. L'appel attend la fin de l'exécution, jusqu'à environ huit minutes.

create_pipelinemcp:write

Enregistrer un nouveau workflow.

Arguments

nodesarray · requis
edgesarray · requis
namestring

Retourne

L'id du nouveau workflow. L'appel enregistre le workflow et ne le lance pas.

update_pipelinemcp:write

Changer les étapes d'un workflow existant.

Arguments

idstring
namestring
nodesarray
edgesarray

delete_pipelinemcp:writeDestructif

Supprimer un workflow de l'espace de travail.

Arguments

idstring

run_appmcp:write

Lancer une app avec ses champs remplis.

Arguments

appIdstring
inputsobject

Retourne

Un runId. L'exécution continue en arrière-plan. Suivez-la avec get_app_run.

get_app_runmcp:read

L'avancement d'une exécution, puis ses résultats.

Arguments

runIdstring

Retourne

Le statut de l'exécution, son avancement (terminés, total et pourcentage) et l'erreur éventuelle. Quand l'exécution est terminée, les images du résultat.

create_designmcp:write

Enregistrer un design Studio, jusqu'à 20 pages.

Arguments

widthnumber · requis
≤ 8000
heightnumber · requis
≤ 8000
namestring
canvasJSONobject
pagesarray
1 … 20
thumbnailUrlstring

Retourne

L'id du nouveau design. Vous pouvez ouvrir le design dans l'éditeur Studio. L'appel ne génère aucune image.

Marque

create_brand_profilemcp:write

Créer un profil de marque : nom, voix, thèmes, secteur.

Arguments

namestring
brandVoicearray<string>
mainThemesarray<string>
contentGoalsarray<string>
contentTypesarray<string>
primaryNichestring
subNichesarray<string>
industrystring
industriesarray<string>
makeDefaultboolean

set_default_brand_profilemcp:write

Choisir le profil de marque par défaut de l'équipe.

Arguments

brandProfileIdstring

Personnes

talking_avatarmcp:write

Un visage qui lit votre script ou votre audio.

Arguments

imageUrlstring
scriptstring
voicestring
audioUrlstring
clientRequestIdstring

Retourne

Un requestId, tout de suite. La vidéo prend environ une à trois minutes. Suivez-la avec get_talking_avatar_status. La réponse contient creditsCharged.

get_talking_avatar_statusmcp:read

Le clip synchronisé, quand il est prêt.

Arguments

requestIdstring

Retourne

Le statut de la tâche. Quand la tâche est terminée, l'URL de la vidéo finale.

Templates et photos

list_image_templatesmcp:read

Le catalogue de templates, avec recherche.

Arguments

qstring
hashtagstring
hashtagsarray<string>
sortstring
popularity, recent
pagenumber
limitnumber
1 … 60

Retourne

Une page de cartes de templates. Chaque carte a un id, un slug, un titre, des hashtags et des images d'aperçu. Le prompt n'est pas inclus.

get_image_templatemcp:read

Un template, avec son modèle et sa taille.

Arguments

idstring
slugstring

Retourne

Les images d'aperçu, le titre, la description et les hashtags, ainsi que le modèle, le format et la taille que le template utilise. Le prompt n'est pas renvoyé.

Modèles, plan et espace de travail

list_image_modelsmcp:read

Les modèles d'image, avec leur coût.

Arguments

capabilitystring
text-to-image, image-to-image, multi-reference, upscale
categorystring
generation, editing, consistency, upscale

Retourne

Pour chaque modèle : son id, ce qu'il sait faire, les formats qu'il accepte et son coût en crédits par image.

list_video_modelsmcp:read

Les modèles vidéo, durées et coût.

Arguments

capabilitystring
text-to-video, image-to-video

Retourne

Pour chaque modèle : son id, ce qu'il sait faire, les durées et les résolutions qu'il accepte et son coût en crédits par seconde.

import_chat_imagemcp:write

Les images jointes à un message, enregistrées dans Assets.

Arguments

imagesarray · requis
1 … 4

upload_assetmcp:write

Choisir un fichier dans le chat. Il arrive dans Assets.

Arguments

Aucun argument.

Retourne

L'URL du fichier que vous avez ajouté. Passez-la comme image à apply_image_template, edit_image ou generate_design.

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.

ui://upload-asset/widget.html

Le sélecteur de fichier du chat, qui ajoute une image ou une vidéo dans Assets.

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

Une connexion OAuth relie DesignerBox à Claude, ChatGPT ou Cursor. Lancez ensuite vos templates, workflows et apps depuis votre assistant IA, dans votre marque.