Riferimento degli strumenti MCP

list_designsmcp:read

Elenca i progetti del team corrente, con filtro cartella e paginazione opzionali.

Argomenti

Restituisce

Un oggetto con designs: [{id, title, folderId, brandProfileId, createdAt, updatedAt}]. Fino a limit risultati.

Esempio

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

get_designmcp:read

Recupera tutti i metadati di un singolo progetto, inclusi titolo, cartella, riferimenti al profilo brand e data di creazione.

Argomenti

Restituisce

Un oggetto con tutti i metadati del progetto: id, title, folderId, brandProfileId, createdAt, updatedAt e gli eventuali dati provider associati.

Esempio

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

search_designsmcp:read

Ricerca a testo completo tra i titoli e le descrizioni dei progetti del team attivo. Filtri: limit (1-100, default 20).

Argomenti

Restituisce

Un oggetto con designs: [{id, title, folderId, snippet, updatedAt}]. Snippet contiene il contesto corrispondente.

Esempio

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

list_brand_profilesmcp:read

Restituisce tutti i profili brand del team corrente con i campi voice, temi, nicchia e settore.

Argomenti

Nessun argomento.

Restituisce

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

Esempio

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

list_foldersmcp:read

Elenca le cartelle nel workspace del team attivo. Utile per indirizzare list_designs a una cartella specifica.

Argomenti

Nessun argomento.

Restituisce

Un oggetto con folders: [{id, name, designCount, createdAt}].

Esempio

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

list_photo_packsmcp:read

Esplora i photo pack disponibili. Accetta un parametro lingua opzionale per filtrare le etichette di categoria.

Argomenti

Restituisce

Un oggetto con packs: [{id, name, category, imageCount, language}].

Esempio

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

list_teamsmcp:read

Restituisce i team di cui l'utente autenticato è proprietario o membro, con il team attivo contrassegnato.

Argomenti

Nessun argomento.

Restituisce

Un oggetto con currentTeamId e teams: [{teamId, teamName, isCurrent}].

Esempio

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

get_plan_limitsmcp:read

Leggi il livello di abbonamento corrente e le quote per livello (spazio e crediti AI). Il bucket aiCredits contiene i crediti dell'abbonamento mensile, il purchasedBalance dei pack di crediti una tantum, il tetto totale e la disponibilità residua. Utile prima degli strumenti di modifica per prevedere se la chiamata andrà a buon fine.

Argomenti

Nessun argomento.

Restituisce

Un oggetto con tier, isPaid, isTrial, upgradeUrl, limits.storage ({limit, current, exceeded}), limits.aiCredits ({monthly:{limit,current,exceeded}, purchasedBalance, total, available}) e creditsAvailable ({monthly, purchasedBalance, total}). Per ULTRA Unlimited, limits.aiCredits.monthly.limit e limits.aiCredits.total valgono entrambi -1, limits.aiCredits.available è null e creditsAvailable.monthly e creditsAvailable.total sono entrambi null. purchasedBalance è sempre un numero (zero quando non ci sono pack).

Esempio

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

get_planmcp:read

Leggi il nome del piano, il ciclo di fatturazione (mensile o annuale), lo stato dell'abbonamento Stripe, la valuta, la data di rinnovo, la fine della prova e il numero di postazioni. Si abbina a get_plan_limits, che restituisce l'utilizzo delle quote. Disponibile su ogni piano senza costo in crediti AI.

Argomenti

Nessun argomento.

Restituisce

Un oggetto con tier, isPaid, isTrial, billingCycle (monthly o yearly o null), status (stato dell'abbonamento Stripe), currency, renewalDate (ISO 8601), trialEnd (ISO 8601 o null), quantity (numero di postazioni o null), cancelAtPeriodEnd e upgradeUrl.

Esempio

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

search_toolsmcp:read

Cerca nel catalogo strumenti MCP per query a testo libero, categoria o intento. Restituisce categorie, requiresScope, descrizioni in una riga e i tag di caso d'uso corrispondenti. Gratuito per tutti i piani (superficie di discovery).

Argomenti

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

Restituisce

Un oggetto con totalTools, matchCount, categories: [string[]] e tools: [{name, category, requiresScope, description, useCases, matchedOn: [name|category|description|use_case]}].

Esempio

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

create_avatarmcp:writePiano a pagamento

Genera un'immagine avatar AI da un prompt testuale. Restituisce un URL all'immagine generata e l'ID del task. Richiede crediti AI e un piano a pagamento.

Argomenti

Restituisce

Un oggetto con taskId, status, imageUrl (quando pronta) e creditsUsed.

Esempio

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

set_current_teammcp:write

Cambia il team attivo per questo Bearer token. L'utente deve esserne membro. Viene salvato sul token OAuth; la modifica in sessione lo rende effettivo immediatamente per gli strumenti successivi nella stessa conversazione.

Argomenti

Restituisce

Un oggetto con teamId, teamName, persisted (true se OAuth, false se API key) e una nota opzionale.

Esempio

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

update_brand_profilemcp:write

Modifica il profilo brand attivo. Campi consentiti: brandVoice, mainThemes, contentGoals, contentTypes, primaryNiche, subNiches, industry, industries. Qualsiasi altro campo viene ignorato silenziosamente.

Argomenti

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

Restituisce

Un oggetto con profileId, name, updated: [nomi dei campi modificati] e i valori attuali di brandVoice, mainThemes, contentGoals, contentTypes, primaryNiche, industry dopo la modifica.

Esempio

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

list_avatarsmcp:read

Elenca i task di generazione avatar dell'utente corrente (a livello utente, non di team). Filtro di stato opzionale e limit (default 50, max 100).

Argomenti

Esempio

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

get_avatarmcp:read

Recupera tutti i dettagli di un singolo task avatar tramite taskUUID. Restituisce lo stato del task incluse le immagini generate al completamento. L'accesso cross-team viene rifiutato quando teamId è risolto.

Argomenti

Esempio

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

get_avatar_statusmcp:read

Interroga l'avanzamento di un task avatar. Restituisce uno snapshot di stato essenziale (status, progress, message). Usa get_avatar per recuperare tutti i dettagli incluse le immagini generate al completamento.

Argomenti

Esempio

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

list_assetsmcp:read

Elenca gli asset (immagini, video e file caricati) del team attivo. Filtri opzionali per cartella o prefisso di tipo MIME. Usa get_asset per tutti i dettagli.

Argomenti

Esempio

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

get_assetmcp:read

Recupera tutti i dettagli di un singolo asset tramite ID. L'accesso cross-team viene rifiutato dal servizio sottostante.

Argomenti

Esempio

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

list_brand_assetsmcp:read

Elenca gli asset del brand (logo, font, campioni di palette e simili) del team attivo. Filtri opzionali per profilo brand, tipo di file, categoria, tag o ricerca a testo libero. Diverso dai profili brand, che descrivono voice e temi.

Argomenti

Esempio

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

generate_imagemcp:writePiano a pagamento

Genera una o più immagini AI in modo sincrono (circa 30 secondi). Il costo in crediti dipende dal modello. Il livello FREE è bloccato. Passa clientRequestId per nuovi tentativi idempotenti entro 5 minuti. Restituisce subito gli URL delle immagini generate.

Argomenti

Esempio

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

generate_videomcp:writePiano a pagamento

Invia un task di generazione video AI. Restituisce subito un taskUUID; il task viene elaborato in modo asincrono (supportato da BullMQ). Usa get_video_status per verificarne il completamento. Il costo in crediti è calcolato in base al modello e alla durata. Il livello FREE è bloccato.

Argomenti

Esempio

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

get_video_statusmcp:read

Interroga l'avanzamento di un task di generazione video. Restituisce lo stato completo del task incluso l'URL finale del video al completamento. Supportato da una coda BullMQ (asincrono reale).

Argomenti

Esempio

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

search_stock_photosmcp:read

Cerca foto stock su Unsplash, Pexels e Pixabay simultaneamente. Restituisce i risultati di ogni provider più gli eventuali errori per provider. Solo ricerca; nessun elenco o esplorazione.

Argomenti

Esempio

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

list_community_workflowsmcp:read

Elenca i workflow pubblicati dalla community. Filtra per categoria, ordina per popolari, recenti o visualizzazioni e limita a mine, team o all. Usa get_community_workflow per il grafo completo.

Argomenti

Esempio

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

get_community_workflowmcp:read

Recupera tutti i dettagli di un workflow della community incluso il grafo di nodi e collegamenti. Usa list_community_workflows per l'esplorazione.

Argomenti

Esempio

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

list_pipelinesmcp:read

Elenca le pipeline (canvas dei workflow) del team attivo. Restituisce una struttura essenziale con il numero di nodi; usa get_pipeline per il grafo completo.

Argomenti

Esempio

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

get_pipelinemcp:read

Recupera una pipeline (canvas del workflow) tramite ID, limitata al team attivo. Restituisce il grafo completo di nodi e collegamenti.

Argomenti

Esempio

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

list_whiteboardsmcp:read

Elenca le lavagne MySpace dell'utente corrente, limitate al team attivo. Il contenuto delle lavagne è omesso nella vista elenco; usa l'endpoint di lettura dedicato per il contenuto.

Argomenti

Nessun argomento.

Esempio

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

list_conversationsmcp:read

Elenca le conversazioni chat dell'AI Assistant dell'utente per il team attivo. Filtro di stato opzionale (active o archived) e filtro per tag. Usa get_conversation per l'intera cronologia dei messaggi.

Argomenti

Esempio

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

get_conversationmcp:read

Recupera una singola conversazione dell'AI Assistant inclusa l'intera cronologia dei messaggi. L'accesso cross-user e cross-team viene rifiutato dal servizio sottostante.

Argomenti

Esempio

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

generate_designmcp:writePiano a pagamento

Genera un design di galleria applicando una skill a un'immagine sorgente (image-to-image). Sincrono ~30-45s. Costa 1 credito AI per chiamata. Il livello FREE è bloccato. Usa list_skills per scoprire i valori skillId validi. Passa clientRequestId per tentativi idempotenti entro 5 minuti.

Argomenti

Esempio

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

list_galleriesmcp:read

Elenca gli asset di galleria AI (design generati tramite generate_design) per il team e l'utente attivi. Supporta la paginazione e un filtro di categoria opzionale. Restituisce una struttura essenziale: assetId, assetUrl, slug, displayName, galleryCategory, createdAt.

Argomenti

Esempio

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

list_skillsmcp:read

Elenca le skill attive disponibili per generate_design. Restituisce skillId, name, type (image o video), group e category. Usalo per scoprire i valori skillId validi prima di chiamare generate_design.

Argomenti

Esempio

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

generate_cinema_studiomcp:writePiano a pagamento

Genera immagini AI cinematografiche usando una combinazione di corpo macchina, obiettivo, lunghezza focale, apertura e rapporto d'aspetto. Sincrono, circa 30 secondi. Il costo in crediti dipende dal modello. Il livello FREE è bloccato. Fornisci referenceImageUrl per passare alla modalità reference-image (trasferimento di stile). Passa clientRequestId per nuovi tentativi idempotenti entro 5 minuti.

Argomenti

Esempio

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

cancel_avatar_taskmcp:writeDistruttivi

Annulla un task di generazione avatar in attesa o in corso. Il percorso di rimborso lato servizio restituisce i crediti addebitati in precedenza. I task in stato terminale (completed o failed) non possono essere annullati; la chiamata restituisce un errore strutturato.

Argomenti

Esempio

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

cancel_video_taskmcp:writeDistruttivi

Annulla un task di generazione video in attesa o in corso. Il percorso di rimborso lato servizio restituisce i crediti addebitati in precedenza. I task in stato terminale (completed o failed) non possono essere annullati; la chiamata restituisce un errore strutturato.

Argomenti

Esempio

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

list_video_tasksmcp:read

Elenca i task di generazione video dell'utente corrente (a livello utente, in parità con list_avatars). Filtro di stato opzionale (pending, processing, completed, failed, cancelled) e limit (default 20, max 100). Usa get_video_status per i dettagli completi di polling.

Argomenti

Esempio

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

get_brand_profilemcp:read

Recupera tutti i dettagli di un singolo profilo brand tramite ID. L'accesso cross-team viene rifiutato con un generico not-found (nessuna rivelazione di esistenza). Usa list_brand_profiles per enumerare gli ID.

Argomenti

Esempio

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

get_brand_assetmcp:read

Recupera tutti i dettagli di un singolo asset del brand tramite ID. L'accesso cross-team viene rifiutato con un generico not-found (nessuna rivelazione di esistenza). Usa list_brand_assets per enumerare gli ID.

Argomenti

Esempio

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

get_photo_packmcp:read

Recupera una singola categoria di photo pack incluse le sue immagini. Strutturato come catalogo (non limitato al team). Codice lingua opzionale; ripiega sull'inglese quando la localizzazione richiesta manca.

Argomenti

Esempio

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

get_whiteboardmcp:read

Recupera una singola lavagna tramite ID incluso l'intero blob di contenuto. Le lavagne sono a livello utente (solo il creatore); l'accesso cross-user viene rifiutato con un generico not-found.

Argomenti

Esempio

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

delete_designmcp:writeDistruttivi

Elimina un progetto. Il tuo client te lo chiede prima.

Argomenti

delete_assetmcp:writeDistruttivi

Elimina un'immagine o un video da Asset.

Argomenti

edit_imagemcp:write

Cambia una parte dell'immagine, il resto resta.

Argomenti

Restituisce

La risposta include creditsCharged, i crediti che la modifica ha consumato.

apply_image_templatemcp:write

Esegui un template per nome, con la tua foto.

Argomenti

Restituisce

La risposta include creditsCharged, i crediti che l'esecuzione ha consumato. Il prompt del template non viene mai restituito.

remove_backgroundmcp:write

Un PNG trasparente del prodotto.

Argomenti

Restituisce

L'URL di un PNG con sfondo trasparente.

photo_anglesmcp:write

Un nuovo angolo di ripresa dello stesso prodotto.

Argomenti

spotlightmcp:write

Cambia la luce: direzione, tipo, intensità, colore.

Argomenti

flat_laymcp:write

Un flat lay da più foto di prodotto.

Argomenti

product_admcp:write

Un'immagine per annunci da una foto di prodotto.

Argomenti

virtual_try_onmcp:write

Un capo indossato dalla persona nella tua foto.

Argomenti

skin_retouchmcp:write

Pelle pulita, con posa e sfondo mantenuti.

Argomenti

fashion_videomcp:write

Camminata in passerella, outfit identico.

Argomenti

Restituisce

Un taskUUID. Il video viene generato in background. Controllalo con get_video_status.

styled_scenemcp:write

Una scena per città, stagione e ora del giorno.

Argomenti

create_video_projectmcp:write

Una timeline: clip, titoli, audio e un look.

Argomenti

Restituisce

L'id del nuovo progetto video. La chiamata non esegue il rendering del video e non consuma crediti.

render_video_projectmcp:write

Trasforma la timeline in un file MP4.

Argomenti

Restituisce

La chiamata risponde subito. Il rendering richiede da uno a cinque minuti circa. Controllalo con get_video_render_status.

get_video_render_statusmcp:read

L'MP4 quando la timeline è finita.

Argomenti

Restituisce

L'URL dell'MP4 finale quando il rendering è finito. L'errore quando il rendering non è riuscito.

delete_video_projectmcp:writeDistruttivi

Elimina una timeline che non ti serve più.

Argomenti

run_pipelinemcp:write

Esegui un workflow e leggi ogni passaggio.

Argomenti

Restituisce

I risultati di ogni passaggio: immagini, video o testo. La chiamata aspetta la fine dell'esecuzione, fino a circa otto minuti.

create_pipelinemcp:write

Salva un nuovo workflow nello spazio di lavoro.

Argomenti

Restituisce

L'id del nuovo workflow. La chiamata salva il workflow e non lo esegue.

update_pipelinemcp:write

Cambia i passaggi di un workflow che hai.

Argomenti

delete_pipelinemcp:writeDistruttivi

Elimina un workflow dallo spazio di lavoro.

Argomenti

run_appmcp:write

Esegui un'app con i campi del modulo compilati.

Argomenti

Restituisce

Un runId. L'esecuzione continua in background. Controllala con get_app_run.

get_app_runmcp:read

A che punto è un'esecuzione, poi i risultati.

Argomenti

Restituisce

Lo stato dell'esecuzione, il suo avanzamento (completati, totale e percentuale) e l'eventuale errore. Quando l'esecuzione è finita, le immagini del risultato.

create_designmcp:write

Salva un progetto Studio, fino a venti pagine.

Argomenti

Restituisce

L'id del nuovo progetto. Puoi aprire il progetto nell'editor Studio. La chiamata non genera immagini.

create_brand_profilemcp:write

Crea un profilo brand: nome, voice, temi, settore.

Argomenti

set_default_brand_profilemcp:write

Scegli quale profilo brand è il predefinito del team.

Argomenti

talking_avatarmcp:write

Un volto che legge il tuo copione o il tuo audio.

Argomenti

Restituisce

Un requestId, subito. Il video richiede da uno a tre minuti circa. Controllalo con get_talking_avatar_status. La risposta include creditsCharged.

get_talking_avatar_statusmcp:read

La clip con la voce sincronizzata, quando è pronta.

Argomenti

Restituisce

Lo stato del lavoro. Quando il lavoro è finito, l'URL del video finale.

list_image_templatesmcp:read

Il catalogo dei template, con ricerca.

Argomenti

Restituisce

Una pagina di schede dei template. Ogni scheda ha un id, uno slug, un titolo, degli hashtag e delle immagini di anteprima. Il prompt non è incluso.

get_image_templatemcp:read

Un template con il suo modello e il formato.

Argomenti

Restituisce

Le immagini di anteprima, il titolo, la descrizione e gli hashtag, più il modello, le proporzioni e le dimensioni che il template usa. Il prompt non viene restituito.

list_image_modelsmcp:read

Modelli di immagini, con il costo di ognuno.

Argomenti

Restituisce

Per ogni modello: il suo id, cosa sa fare, le proporzioni che supporta e il suo costo in crediti per immagine.

list_video_modelsmcp:read

Modelli video, con durate e costo.

Argomenti

Restituisce

Per ogni modello: il suo id, cosa sa fare, le durate e le risoluzioni che consente e il suo costo in crediti al secondo.

import_chat_imagemcp:write

Le immagini allegate a un messaggio, salvate in Asset.

Argomenti

upload_assetmcp:write

Un selettore di file nella chat. Il file va in Asset.

Argomenti

Nessun argomento.

Restituisce

L'URL del file che hai aggiunto. Passalo come immagine a apply_image_template, edit_image o generate_design.