Zum Hauptinhalt springen
MCP

MCP-Tool-Referenz

Alle 75 MCP-Tools in einer Liste. Jeder Eintrag zeigt, was das Tool macht und welche Eingaben es hat. Viele zeigen auch, was der Aufruf zurückgibt.

Authentifizierung

OAuth (empfohlen für KI-Clients)

KI-Clients fuehren beim ersten Verbinden Dynamic Client Registration durch. Die Seite /mcp/connect erledigt das automatisch. Ihr Client erhält ein 30-Tage-Access-Token.

Endpunkt

Alle Tool-Aufrufe gehen an einen einzigen JSON-RPC-2.0-Endpoint per HTTPS POST.

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

Tools

list_designsmcp:read

Designs des aktuellen Teams auflisten, mit optionalem Ordnerfilter und Seitennavigation.

Argumente

limitnumber · optional · default 20
Maximale Ergebnisanzahl (1-100).
folderIdstring · optional
Optionale Ordner-ID. Gibt nur die Elemente in diesem Ordner zurück.

Rueckgabe

Ein Objekt mit designs: [{id, title, folderId, brandProfileId, createdAt, updatedAt}]. Bis zu limit Ergebnisse.

Beispiel

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

get_designmcp:read

Vollständige Metadaten für ein Design inklusive Titel, Ordner, Markenprofil-Referenzen und Erstelldatum abrufen.

Argumente

designIdstring · erforderlich
DesignerBox-Design-ID aus einem List-Aufruf.

Rueckgabe

Ein Objekt mit vollständigen Design-Metadaten: id, title, folderId, brandProfileId, createdAt, updatedAt.

Beispiel

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

search_designsmcp:read

Volltextsuche über Design-Titel und Beschreibungen des aktiven Teams. Filter: limit (1-100, Standard 20).

Argumente

querystring · erforderlich
Suchbegriff (3-200 Zeichen).
limitnumber · optional · default 20
Maximale Ergebnisanzahl (1-100).

Rueckgabe

Ein Objekt mit designs: [{id, title, folderId, snippet, updatedAt}].

Beispiel

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

list_brand_profilesmcp:read

Alle Markenprofile des aktuellen Teams mit Stimme, Themen, Nische und Branche zurückgeben.

Argumente

Keine Argumente.

Rueckgabe

Ein Objekt mit profiles: [{id, name, brandVoice, mainThemes, primaryNiche, industry, isActive}].

Beispiel

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

list_foldersmcp:read

Ordner im aktiven Team-Workspace auflisten. Nuetzlich um list_designs auf einen Ordner einzuschraenken.

Argumente

Keine Argumente.

Rueckgabe

Ein Objekt mit folders: [{id, name, designCount, createdAt}].

Beispiel

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

list_photo_packsmcp:read

Verfügbare Fotopakete durchsuchen. Akzeptiert optionalen Sprachparameter für Kategorie-Labels.

Argumente

languagestring · optional
BCP-47-Sprachcode für Fotopaket-Kategorie-Labels (z.B. en, de, es).

Rueckgabe

Ein Objekt mit packs: [{id, name, category, imageCount, language}].

Beispiel

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

list_teamsmcp:read

Teams zurückgeben, denen der authentifizierte Nutzer angehört, mit Markierung des aktiven Teams.

Argumente

Keine Argumente.

Rueckgabe

Ein Objekt mit currentTeamId und teams: [{teamId, teamName, isCurrent}].

Beispiel

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

get_plan_limitsmcp:read

Aktuellen Abonnement-Tier und Tier-Quotas (Speicher und KI-Credits) lesen. Der aiCredits-Bereich verschachtelt monatliche Abonnement-Credits, purchasedBalance aus einmaligen Credit-Packs, Gesamtdeckel und verbleibend verfügbar. In jedem Plan verfügbar.

Argumente

Keine Argumente.

Rueckgabe

Ein Objekt mit tier, isPaid, isTrial, upgradeUrl, limits.storage ({limit, current, exceeded}), limits.aiCredits ({monthly:{limit,current,exceeded}, purchasedBalance, total, available}) und creditsAvailable ({monthly, purchasedBalance, total}). Bei ULTRA Unlimited sind limits.aiCredits.monthly.limit und limits.aiCredits.total beide -1, limits.aiCredits.available ist null, und creditsAvailable.monthly und creditsAvailable.total sind beide null. purchasedBalance ist immer eine Zahl (null bei keinen Packs).

Beispiel

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

get_planmcp:read

Plan-Name, Abrechnungszyklus (monatlich oder jaehrlich), Stripe-Abonnement-Status, Waehrung, Verlaengerungsdatum, Trial-Ende und Sitzplatzanzahl lesen. Paart mit get_plan_limits. In jedem Plan verfügbar ohne KI-Credit-Kosten.

Argumente

Keine Argumente.

Rueckgabe

Ein Objekt mit tier, isPaid, isTrial, billingCycle (monatlich oder jaehrlich oder null), status (Stripe-Status), currency, renewalDate (ISO 8601), trialEnd (ISO 8601 oder null), quantity (Sitzplatzanzahl oder null), cancelAtPeriodEnd und upgradeUrl.

Beispiel

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

search_toolsmcp:read

Den MCP-Tool-Katalog nach Freitext, Kategorie oder Absicht durchsuchen. Gibt Kategorien, Scope und Beschreibungen zurück.

Argumente

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

querystring · optional
Freitextsuche über Tool-Namen, Beschreibungen und Use-Case-Tags.
categorystring · optional
Auf eine Kategorie filtern: designs, brand, teams, discovery, other.

Rueckgabe

Ein Objekt mit totalTools, matchCount, categories und tools: [{name, category, requiresScope, description, useCases, matchedOn: [name|category|description|use_case]}].

Beispiel

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

create_avatarmcp:writeBezahlpaket

KI-Avatar-Bild aus einem Textprompt generieren. Gibt eine URL des generierten Bildes zurück. Benötigt KI-Credits und einen Bezahlplan.

Argumente

promptstring · erforderlich
Textbeschreibung des zu generierenden Avatars (10-500 Zeichen).
stylestring · optional
Optionaler Stil-Hinweis für das Bildmodell (z.B. "photorealistisch", "cartoon").
clientRequestIdstring · optional
Optionaler Idempotenzschlüssel. Gleicher Schlüssel innerhalb von 5 Minuten gibt das gecachte Ergebnis zurück.

Rueckgabe

Ein Objekt mit taskId, status, imageUrl (wenn fertig) und creditsUsed.

Beispiel

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

set_current_teammcp:write

Aktives Team für diesen Bearer-Token wechseln. Nutzer muss Mitglied sein. Sofort wirksam für nachfolgende Tools.

Argumente

teamIdstring · erforderlich
Ziel-teamId aus list_teams. Mitgliedschaft wird serverseitig erneut geprüft.

Rueckgabe

Ein Objekt mit teamId, teamName, persisted und einer optionalen Notiz.

Beispiel

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

update_brand_profilemcp:write

Aktives Markenprofil aktualisieren. Erlaubte Felder: brandVoice, mainThemes, contentGoals, contentTypes, primaryNiche, subNiches, industry, industries.

Argumente

brandVoicearray<string> · optional
Array von Markenstimme-Deskriptoren (z.B. ["klar", "minimal"]).

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

Rueckgabe

Ein Objekt mit profileId, name, updated: [geänderte Feldnamen] und den aktuellen Werten nach dem Patch.

Beispiel

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

Avatare

list_avatarsmcp:read

Avatar-Generierungs-Tasks für den aktuellen Benutzer auflisten (benutzer-bezogen, nicht team-bezogen). Optionaler Status-Filter und Limit (Standard 50, max 100).

Argumente

statusstring · optional
Optionaler Avatar-Status-Filter: pending, generating, completed, failed, cancelled.
limitnumber · optional · default 50
Maximale Ergebnisanzahl (1-100).

Beispiel

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

get_avatarmcp:read

Vollständige Details zu einem Avatar-Task per taskUUID abrufen. Liefert den Task-Status inklusive generierter Bilder bei Fertigstellung. Cross-Team-Zugriffe werden zurückgewiesen, wenn die teamId aufgeloest ist.

Argumente

taskUUIDstring · erforderlich
Die Avatar-Task-UUID aus create_avatar.

Beispiel

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

get_avatar_statusmcp:read

Avatar-Task-Fortschritt abfragen. Liefert einen schlanken Status-Snapshot (status, progress, message). get_avatar für volle Details inklusive generierter Bilder verwenden.

Argumente

taskUUIDstring · erforderlich
Die Avatar-Task-UUID aus create_avatar.

Beispiel

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

Assets

list_assetsmcp:read

Assets (hochgeladene Bilder, Videos und Dateien) des aktiven Teams auflisten. Optionale Filter nach Ordner oder MIME-Typ-Praefix. get_asset für volle Details verwenden.

Argumente

folderIdstring · optional
Optionale Ordner-ID. Gibt nur die Elemente in diesem Ordner zurück.
pagenumber · optional · default 1
Seitennummer (1-indiziert). Standard 1.
limitnumber · optional · default 30
Maximale Ergebnisanzahl (1-100).
typestring · optional
Optionaler MIME-Typ-Praefix-Filter (zum Beispiel "image" oder "video").

Beispiel

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

get_assetmcp:read

Vollständige Details zu einem Asset per ID abrufen. Cross-Team-Zugriffe werden vom unterliegenden Service zurückgewiesen.

Argumente

idstring · erforderlich
Asset-ID (Mongo _id) aus list_assets.

Beispiel

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

list_brand_assetsmcp:read

Marken-Assets (Logos, Schriften, Farbpaletten und aehnliche) des aktiven Teams auflisten. Optionale Filter nach Markenprofil, Dateityp, Kategorie, Tags oder Freitextsuche. Unterscheidet sich von Markenprofilen, die Stimme und Themen beschreiben.

Argumente

brandProfileIdstring · optional
Optionale Markenprofil-ID, um Assets auf ein Profil zu beschränken.
fileTypestring · optional
Optionaler Dateityp-Filter (zum Beispiel "png", "svg", "ttf").
categorystring · optional
Optionale Kategorie (zum Beispiel "logo", "palette", "font").
tagsarray<string> · optional
Optionale Liste von Tag-Strings, um Marken-Assets einzugrenzen.
searchstring · optional
Optionale Freitextsuche über Marken-Asset-Namen.

Beispiel

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

KI-Generierung

generate_imagemcp:writeBezahlpaket

Ein oder mehrere KI-Bilder synchron generieren (etwa 30 Sekunden). Die Credit-Kosten hängen vom Modell ab. FREE-Tier ist blockiert. clientRequestId für idempotente Wiederholungen innerhalb von 5 Minuten übergeben. Liefert die generierten Bild-URLs sofort.

Argumente

promptstring · erforderlich
Textbeschreibung des zu generierenden Bildes (1-2000 Zeichen).
modelstring · optional
Optionale Bildmodell-ID. Standard ist die Plattform-Fallback-Kette.
aspectRatiostring · optional
Bild-Seitenverhältnis: 1:1, 3:4, 4:3, 9:16 oder 16:9.
numberResultsnumber · optional · default 1
Wie viele Bilder generiert werden (1-4). Standard 1.
negativePromptstring · optional
Optionale Begriffe, die das Modell im Bild vermeiden soll.
clientRequestIdstring · optional
Optionaler Idempotenzschlüssel. Gleicher Schlüssel innerhalb von 5 Minuten gibt das gecachte Ergebnis zurück.

Beispiel

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

generate_videomcp:writeBezahlpaket

Einen KI-Video-Generierungs-Task einreichen. Liefert sofort ein taskUUID; der Task wird asynchron verarbeitet (BullMQ-gestuetzt). get_video_status für Polling verwenden. Credit-Kosten werden aus Modell und Dauer berechnet. FREE-Tier ist blockiert.

Argumente

promptstring · erforderlich
Textbeschreibung des zu generierenden Videos (1-2000 Zeichen).
modelstring · erforderlich
Video-Modell-ID. Verfügbare IDs unter /api/v1/ai/video-models.
typestring · optional · default text-to-video
Generierungsmodus: text-to-video (Standard), image-to-video oder audio-to-video.
durationnumber · optional
Gewünschte Videolänge (1-60). Ohne Angabe gilt der Standardwert des Modells.
resolutionstring · optional
Optionaler Aufloesungs-String (zum Beispiel 720p, 1080p). Modellabhängig.
aspectRatiostring · optional
Optionales Seitenverhältnis (zum Beispiel 16:9, 9:16). Modellabhängig.
inputImagestring · optional
Erforderlich für image-to-video: oeffentliche URL des Quellbildes.
negativePromptstring · optional
Optionale Begriffe, die das Modell im Video vermeiden soll.
clientRequestIdstring · optional
Optionaler Idempotenzschlüssel. Gleicher Schlüssel innerhalb von 5 Minuten gibt das gecachte Ergebnis zurück.

Beispiel

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

get_video_statusmcp:read

Video-Generierungs-Task-Fortschritt abfragen. Liefert vollen Task-Status inklusive finaler Video-URL bei Fertigstellung. Durch eine BullMQ-Queue (echt asynchron) gestuetzt.

Argumente

taskUUIDstring · erforderlich
Die Video-Task-UUID aus generate_video.

Beispiel

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

Stockfotos

search_stock_photosmcp:read

Stockfotos gleichzeitig über Unsplash, Pexels und Pixabay durchsuchen. Liefert pro Anbieter Ergebnisse plus pro-Anbieter-Fehler. Nur Suche; kein List- oder Browse-Modus.

Argumente

querystring · erforderlich
Suchbegriff (3-200 Zeichen).
pagenumber · optional · default 1
Seitennummer (1-indiziert). Standard 1.
perPagenumber · optional · default 20
Ergebnisse pro Seite (1-50). Standard 20.

Beispiel

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

Community-Workflows und Pipelines

list_community_workflowsmcp:read

Veroeffentlichte Community-Workflows auflisten. Nach Kategorie filtern, sortieren nach beliebt, neu oder Aufrufen, und auf eigene, Team oder alle einschränken. get_community_workflow für den vollen Graph.

Argumente

pagenumber · optional · default 1
Seitennummer (1-indiziert). Standard 1.
limitnumber · optional · default 20
Maximale Ergebnisanzahl (1-100).
categorystring · optional · default all
Filter für Community-Workflow-Kategorie. "all" verwenden, um keine Kategorie einzuschraenken.
sortstring · optional · default popular
Sortierreihenfolge: popular, recent oder views. Standard popular.
searchstring · optional
Optionale Freitextsuche, um Community-Workflows einzugrenzen.
filterstring · optional · default all
Bereich: all (alle), mine (Ihre veroeffentlichten Workflows) oder team. Standard all.

Beispiel

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

get_community_workflowmcp:read

Vollständige Details zu einem Community-Workflow inklusive Knotengraph und Kanten abrufen. list_community_workflows zum Browsen verwenden.

Argumente

idstring · erforderlich
Community-Workflow-ID (Mongo _id) aus list_community_workflows.

Beispiel

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

list_pipelinesmcp:read

Pipelines (Workflow-Canvas) des aktiven Teams auflisten. Liefert eine schlanke Form mit Knotenanzahl; get_pipeline für den vollen Graph.

Argumente

pagenumber · optional · default 1
Seitennummer (1-indiziert). Standard 1.
limitnumber · optional · default 20
Maximale Ergebnisanzahl (1-100).
sortstring · optional · default updatedAt
Pipeline-Sortierreihenfolge: updatedAt, createdAt oder name. Standard updatedAt.

Beispiel

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

get_pipelinemcp:read

Eine Pipeline (Workflow-Canvas) per ID abrufen, beschränkt auf das aktive Team. Liefert vollen Knoten- und Kantengraph.

Argumente

idstring · erforderlich
Pipeline-ID (Mongo _id) aus list_pipelines.

Beispiel

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

list_whiteboardsmcp:read

MySpace-Whiteboards des aktuellen Benutzers auflisten, beschränkt auf das aktive Team. Whiteboard-Inhalt wird in der Listen-Ansicht weggelassen; den dedizierten Read-Endpoint für Inhalte verwenden.

Argumente

Keine Argumente.

Beispiel

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

Konversationen und Whiteboards

list_conversationsmcp:read

KI-Assistent-Chat-Konversationen des Benutzers für das aktive Team auflisten. Optionaler Status-Filter (active oder archived) und Tag-Filter. get_conversation für den vollen Nachrichtenverlauf.

Argumente

statusstring · optional · default active
Konversations-Status-Filter: active (Standard) oder archived.
pagenumber · optional · default 1
Seitennummer (1-indiziert). Standard 1.
limitnumber · optional · default 20
Maximale Ergebnisanzahl (1-100).
tagsarray<string> · optional
Optionale Liste von Tag-Strings. Liefert Konversationen, die mindestens einem Tag entsprechen.

Beispiel

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

get_conversationmcp:read

Eine einzelne KI-Assistent-Konversation inklusive vollem Nachrichtenverlauf abrufen. Cross-User- und Cross-Team-Zugriffe werden vom Service zurückgewiesen.

Argumente

idstring · erforderlich
Konversations-ID aus list_conversations.

Beispiel

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

Galerien und Skills

generate_designmcp:writeBezahlpaket

Ein Gallery-Design generieren, indem eine Skill auf ein Quellbild angewendet wird (image-to-image). Synchron ~30-45s. Kostet 1 KI-Credit pro Aufruf. FREE-Tier ist blockiert. list_skills aufrufen, um gueltige skillId-Werte zu finden. clientRequestId für idempotente Wiederholungen innerhalb von 5 Minuten übergeben.

Argumente

sourceImageUrlstring · erforderlich
Oeffentliche URL des zu transformierenden Quellbildes.
skillIdstring · erforderlich
Anzuwendende Skill-ID. Zuerst list_skills aufrufen, um verfügbare IDs zu finden.
clientRequestIdstring · optional
Optionaler Idempotenzschlüssel. Gleicher Schlüssel innerhalb von 5 Minuten gibt das gecachte Ergebnis zurück.

Beispiel

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

list_galleriesmcp:read

KI-Gallery-Assets (Designs aus generate_design) für das aktive Team und den Benutzer auflisten. Unterstützt Pagination und einen optionalen Kategorie-Filter. Liefert eine schlanke Form: assetId, assetUrl, slug, displayName, galleryCategory, createdAt.

Argumente

limitnumber · optional · default 20
Maximale Ergebnisanzahl (1-100).
pagenumber · optional · default 1
Seitennummer (1-indiziert). Standard 1.
categorystring · optional
Optionaler Gallery-Kategorie-Filter (zum Beispiel "portrait", "landscape").

Beispiel

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

list_skillsmcp:read

Aktive Skills für generate_design auflisten. Liefert skillId, name, type (image oder video), group und category. Damit gueltige skillId-Werte ermittelt werden, bevor generate_design aufgerufen wird.

Argumente

typestring · optional
Optionaler Filter: image- oder video-Skills.

Beispiel

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

Kinematografische Generierung

generate_cinema_studiomcp:writeBezahlpaket

Kinematografische KI-Bilder mit einer Kombination aus Kameragehäuse, Objektiv, Brennweite, Blende und Seitenverhältnis generieren. Synchron, etwa 30 Sekunden. Die Credit-Kosten hängen vom Modell ab. FREE-Tier ist blockiert. referenceImageUrl übergeben, um in den Referenzbild-Modus (Style-Transfer) zu wechseln. clientRequestId für idempotente Wiederholungen innerhalb von 5 Minuten übergeben.

Argumente

scenePromptstring · erforderlich
Szenenbeschreibung für die kinematografische Aufnahme (1-2000 Zeichen).
cameraBodystring · optional · default arri-alexa-65
Kamera-ID, die die Rendering-Signatur steuert (zum Beispiel "arri-alexa-65", "red-v-raptor", "sony-venice-2").
lensstring · optional · default panavision-primo
Objektiv-Deskriptor-ID (zum Beispiel "classic-anamorphic", "master-prime", "panavision-primo").
focalLengthstring · optional · default fl-50
Brennweiten-ID von fl-14 bis fl-200 (entspricht 14mm bis 200mm).
aperturestring · optional · default f-2.8
Blenden-ID von f-1.2 bis f-11.
aspectRatiostring · optional · default 16:9
Bild-Seitenverhältnis: 16:9, 1:1, 9:16 oder 4:3. Standard 16:9.
imageCountnumber · optional · default 2
Anzahl der zu generierenden kinematografischen Frames (1-4). Standard 2.
referenceImageUrlstring · optional
Optionale Referenzbild-URL. Wenn angegeben, wechselt der Modus zu Referenzbild (Style-Transfer).
clientRequestIdstring · optional
Optionaler Idempotenzschlüssel. Gleicher Schlüssel innerhalb von 5 Minuten gibt das gecachte Ergebnis zurück.

Beispiel

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

Async-Task-Management

cancel_avatar_taskmcp:writeDestruktiv

Einen ausstehenden oder laufenden Avatar-Generierungs-Task abbrechen. Der service-seitige Refund-Pfad erstattet zuvor berechnete Credits zurück. Tasks im Endzustand (completed oder failed) können nicht abgebrochen werden; der Aufruf liefert einen strukturierten Fehler.

Argumente

taskUUIDstring · erforderlich
Die Avatar-Task-UUID aus create_avatar.

Beispiel

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

cancel_video_taskmcp:writeDestruktiv

Einen ausstehenden oder laufenden Video-Generierungs-Task abbrechen. Der service-seitige Refund-Pfad erstattet zuvor berechnete Credits zurück. Tasks im Endzustand (completed oder failed) können nicht abgebrochen werden; der Aufruf liefert einen strukturierten Fehler.

Argumente

taskUUIDstring · erforderlich
Die Video-Task-UUID aus generate_video.

Beispiel

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

list_video_tasksmcp:read

Video-Generierungs-Tasks des aktuellen Benutzers auflisten (user-bezogen, parity mit list_avatars). Optionaler Status-Filter (pending, processing, completed, failed, cancelled) und Limit (Standard 20, Max 100). get_video_status für vollständige Polling-Details verwenden.

Argumente

statusstring · optional
Optionaler Status-Filter: pending, processing, completed, failed, cancelled.
limitnumber · optional · default 20
Maximale Ergebnisanzahl (1-100).

Beispiel

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

Einzelabruf-Details

get_brand_profilemcp:read

Vollständige Details für ein einzelnes Markenprofil per ID abrufen. Cross-Team-Zugriff wird als generischer not-found zurückgewiesen (keine Existenz-Leaks). list_brand_profiles verwenden, um IDs aufzuzaehlen.

Argumente

brandProfileIdstring · erforderlich
Markenprofil-ID (uuid) aus list_brand_profiles.

Beispiel

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

get_brand_assetmcp:read

Vollständige Details für ein einzelnes Marken-Asset per ID abrufen. Cross-Team-Zugriff wird als generischer not-found zurückgewiesen (keine Existenz-Leaks). list_brand_assets verwenden, um IDs aufzuzaehlen.

Argumente

brandAssetIdstring · erforderlich
Marken-Asset-ID (uuid) aus list_brand_assets.

Beispiel

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

get_photo_packmcp:read

Eine einzelne Photo-Pack-Kategorie inklusive ihrer Bilder abrufen. Katalog-foermig (nicht team-bezogen). Optionaler Sprachcode; Fallback auf Englisch, wenn das angeforderte Locale fehlt.

Argumente

categoryIdstring · erforderlich
Photo-Pack-Kategorie-ID (zum Beispiel "3d-rendered-object").
languagestring · optional · default en
BCP-47-Sprachcode für Fotopaket-Kategorie-Labels (z.B. en, de, es).

Beispiel

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

get_whiteboardmcp:read

Ein einzelnes Whiteboard per ID inklusive vollem Inhalts-Blob abrufen. Whiteboards sind user-bezogen (nur Ersteller); Cross-User-Zugriff wird als generischer not-found zurückgewiesen.

Argumente

whiteboardIdstring · erforderlich
Whiteboard-ID (uuid) aus list_whiteboards.

Beispiel

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

Ihr Arbeitsbereich

delete_designmcp:writeDestruktiv

Ein Design löschen. Ihr Client fragt vorher nach.

Argumente

idstring

delete_assetmcp:writeDestruktiv

Ein Bild oder Video aus Assets löschen.

Argumente

idstring

Bilder

edit_imagemcp:write

Einen Teil eines Bildes ändern, Rest bleibt.

Argumente

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

Rueckgabe

Die Antwort enthält creditsCharged, die Credits, die die Bearbeitung verbraucht hat.

apply_image_templatemcp:write

Vorlage über den Namen ausführen, mit Ihrem Foto.

Argumente

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

Rueckgabe

Die Antwort enthält creditsCharged, die Credits, die der Durchlauf verbraucht hat. Der Prompt der Vorlage wird nie zurückgegeben.

remove_backgroundmcp:write

Ein transparentes PNG des Produkts.

Argumente

imageUrlstring

Rueckgabe

Die URL einer PNG-Datei mit transparentem Hintergrund.

photo_anglesmcp:write

Ein neuer Kamerawinkel desselben Produkts.

Argumente

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

spotlightmcp:write

Foto neu beleuchten: Richtung, Art, Helligkeit, Farbe.

Argumente

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

flat_laymcp:write

Ein Flat Lay aus mehreren Produktfotos.

Argumente

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

product_admcp:write

Ein Werbebild aus einem Produktfoto.

Argumente

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

virtual_try_onmcp:write

Kleidungsstück an der Person in Ihrem Foto.

Argumente

personImageUrlstring
garmentImageUrlstring
maskImageUrlstring
modelstring
numberResultsnumber
1 … 4

skin_retouchmcp:write

Reine Haut, Pose und Hintergrund bleiben.

Argumente

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

Video

fashion_videomcp:write

Laufsteg-Bewegung, Outfit bleibt gleich.

Argumente

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

Rueckgabe

Eine taskUUID. Das Video entsteht im Hintergrund. Prüfen Sie es mit get_video_status.

styled_scenemcp:write

Eine Szene nach Stadt, Saison und Tageszeit.

Argumente

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

create_video_projectmcp:write

Eine Timeline: Clips, Titel, Ton und Look.

Argumente

aspectRatiostring · erforderlich
16:9, 9:16, 1:1, 4:5
clipsarray · erforderlich
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

Rueckgabe

Die ID des neuen Videoprojekts. Der Aufruf rendert das Video nicht und verbraucht keine Credits.

render_video_projectmcp:write

Timeline in eine MP4-Datei umwandeln.

Argumente

projectIdstring

Rueckgabe

Der Aufruf antwortet sofort. Das Rendern dauert etwa eine bis fünf Minuten. Prüfen Sie es mit get_video_render_status.

get_video_render_statusmcp:read

Das MP4, sobald die Timeline fertig ist.

Argumente

projectIdstring

Rueckgabe

Die URL der fertigen MP4-Datei, wenn das Rendern abgeschlossen ist. Der Fehler, wenn das Rendern fehlgeschlagen ist.

delete_video_projectmcp:writeDestruktiv

Eine Timeline löschen, die Sie nicht mehr brauchen.

Argumente

projectIdstring

Workflows und Apps

run_pipelinemcp:write

Workflow starten und jedes Ergebnis lesen.

Argumente

pipelineIdstring
nodesarray
edgesarray
seedOutputsobject

Rueckgabe

Die Ergebnisse jedes Schritts: Bilder, Videos oder Text. Der Aufruf wartet, bis der Durchlauf fertig ist, bis zu etwa acht Minuten.

create_pipelinemcp:write

Neuen Workflow im Arbeitsbereich speichern.

Argumente

nodesarray · erforderlich
edgesarray · erforderlich
namestring

Rueckgabe

Die ID des neuen Workflows. Der Aufruf speichert den Workflow und führt ihn nicht aus.

update_pipelinemcp:write

Die Schritte eines Workflows ändern.

Argumente

idstring
namestring
nodesarray
edgesarray

delete_pipelinemcp:writeDestruktiv

Einen Workflow aus dem Arbeitsbereich löschen.

Argumente

idstring

run_appmcp:write

App mit gefüllten Formularfeldern starten.

Argumente

appIdstring
inputsobject

Rueckgabe

Eine runId. Der Durchlauf geht im Hintergrund weiter. Prüfen Sie ihn mit get_app_run.

get_app_runmcp:read

Fortschritt eines Durchlaufs, dann Ergebnisse.

Argumente

runIdstring

Rueckgabe

Der Status des Durchlaufs, sein Fortschritt (abgeschlossen, gesamt und Prozent) und ein möglicher Fehler. Wenn der Durchlauf fertig ist, die Ergebnisbilder.

create_designmcp:write

Ein Studio-Design, bis zu zwanzig Seiten.

Argumente

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

Rueckgabe

Die ID des neuen Designs. Sie können das Design im Studio-Editor öffnen. Der Aufruf rendert kein Bild.

Marke

create_brand_profilemcp:write

Markenprofil anlegen: Name, Stimme, Themen, Branche.

Argumente

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

set_default_brand_profilemcp:write

Festlegen, welches Markenprofil der Standard im Team ist.

Argumente

brandProfileIdstring

Menschen

talking_avatarmcp:write

Ein Gesicht liest Ihr Skript oder Ihr Audio.

Argumente

imageUrlstring
scriptstring
voicestring
audioUrlstring
clientRequestIdstring

Rueckgabe

Sofort eine requestId. Das Video braucht etwa eine bis drei Minuten. Prüfen Sie es mit get_talking_avatar_status. Die Antwort enthält creditsCharged.

get_talking_avatar_statusmcp:read

Der Lipsync-Clip, sobald er fertig ist.

Argumente

requestIdstring

Rueckgabe

Der Status des Auftrags. Wenn der Auftrag fertig ist, die URL des fertigen Videos.

Vorlagen und Fotos

list_image_templatesmcp:read

Der Vorlagen-Katalog, durchsuchbar.

Argumente

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

Rueckgabe

Eine Seite mit Vorlagenkarten. Jede Karte hat eine ID, einen Slug, einen Titel, Hashtags und Vorschaubilder. Der Prompt ist nicht enthalten.

get_image_templatemcp:read

Eine Vorlage mit Modell und Format.

Argumente

idstring
slugstring

Rueckgabe

Die Vorschaubilder, der Titel, die Beschreibung und die Hashtags, dazu das Modell, das Seitenverhältnis und die Größe, die die Vorlage nutzt. Der Prompt wird nicht zurückgegeben.

Modelle, Plan und Arbeitsbereich

list_image_modelsmcp:read

Bildmodelle, mit den Kosten pro Modell.

Argumente

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

Rueckgabe

Für jedes Modell: seine ID, was es kann, die unterstützten Seitenverhältnisse und seine Credit-Kosten pro Bild.

list_video_modelsmcp:read

Videomodelle, mit Dauer und Kosten.

Argumente

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

Rueckgabe

Für jedes Modell: seine ID, was es kann, die erlaubten Längen und Auflösungen und seine Credit-Kosten pro Sekunde.

import_chat_imagemcp:write

Bilder aus Ihrer Nachricht, in Assets gespeichert.

Argumente

imagesarray · erforderlich
1 … 4

upload_assetmcp:write

Dateiauswahl im Chat. Die Datei landet in Assets.

Argumente

Keine Argumente.

Rueckgabe

Die URL der Datei, die Sie hinzugefügt haben. Geben Sie sie als Bild an apply_image_template, edit_image oder generate_design weiter.

MCP-Ressourcen

Ressourcen sind nur lesbarer Kontext, den der Client per MCP resources/read abrufen kann. Claude laedt sie zu Beginn des Gespraechs, um Account-, Team- und Markenkontext zu haben.

designerbox://account/summary

Plan, verbrauchte / verbleibende KI-Credits, Design-Anzahl, aktiver Teamname und Ordneranzahl.

designerbox://brand-profiles/active

Das aktive Markenprofil des aktuellen Teams mit LLM-relevanten Feldern.

designerbox://teams/current

Aktuelle Team-Metadaten (teamId, teamName) und Gesamtanzahl verfügbarer Teams.

designerbox://recent-designs

Die 10 neuesten Designs des aktiven Teams, vorab in Claudes Kontext geladen.

ui://upload-asset/widget.html

Die Dateiauswahl im Chat, die ein Bild oder ein Video zu Assets hinzufügt.

Benannte Workflows

Slash-Menue-Shortcuts, die mehrere Tools verketten. Wählen Sie einen aus und lassen Sie Ihren KI-Assistenten mehrere Schritte durchlaufen, mit Bestaetigung vor jeder Aenderung.

/weekly-design-batch

Liest Markenprofil und aktuelle Designs, dann schlaegt Design-Themen und Ordnerziele für die kommende Woche vor.

/audit-gallery

Geht aktuelle Designs mit list_designs durch und markiert Elemente, die vom aktiven Markenprofil abweichen. Nur lesend.

/brand-sync

Vergleicht Designs mit dem aktiven Markenprofil und zeigt Luecken auf. Schlaegt Aktualisierungen vor; Sie genehmigen, bevor sich etwas aendert.

/regenerate-with-style

Ein bestehendes Design in einem anderen Stil neu generieren. Ruft get_asset, dann list_skills bei Bedarf, dann generate_design auf.

Discovery- und OAuth-Endpoints

Standardkonformes Metadaten-Dokument, damit jeder MCP-Client sich automatisch konfigurieren kann.

  • 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

Steuern Sie Ihren Design-Workflow aus jedem KI-Assistenten

Eine OAuth-Anmeldung verbindet DesignerBox mit Claude, ChatGPT oder Cursor. Dann starten Sie Vorlagen, Workflows und Apps aus Ihrem KI-Chat, in Ihrer Marke.