Referencia de herramientas MCP

list_designsmcp:read

Listar disenos del equipo actual, con filtro de carpeta opcional y paginacion.

Argumentos

Devuelve

Un objeto con designs: [{id, title, folderId, brandProfileId, createdAt, updatedAt}].

Ejemplo

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

get_designmcp:read

Obtener metadatos completos de un diseño incluyendo título, carpeta, referencias de perfil de marca y fecha de creación.

Argumentos

Devuelve

Un objeto con metadatos completos del diseno: id, title, folderId, brandProfileId, createdAt, updatedAt.

Ejemplo

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

search_designsmcp:read

Busqueda de texto completo en titulos y descripciones de disenos del equipo activo.

Argumentos

Devuelve

Un objeto con designs: [{id, title, folderId, snippet, updatedAt}].

Ejemplo

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

list_brand_profilesmcp:read

Devolver todos los perfiles de marca del equipo actual con voz, temas, nicho e industria.

Argumentos

Sin argumentos.

Devuelve

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

Ejemplo

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

list_foldersmcp:read

Listar carpetas en el espacio de trabajo del equipo activo. Util para limitar list_designs a una carpeta especifica.

Argumentos

Sin argumentos.

Devuelve

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

Ejemplo

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

list_photo_packsmcp:read

Explorar paquetes de fotos disponibles. Acepta parámetro de idioma opcional para etiquetas de categoría.

Argumentos

Devuelve

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

Ejemplo

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

list_teamsmcp:read

Devolver los equipos a los que pertenece el usuario autenticado, con el equipo activo marcado.

Argumentos

Sin argumentos.

Devuelve

Un objeto con currentTeamId y teams: [{teamId, teamName, isCurrent}].

Ejemplo

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

get_plan_limitsmcp:read

Leer el nivel de suscripción actual y las cuotas por nivel (almacenamiento y créditos de IA). El bloque aiCredits anida los créditos mensuales de la suscripción, purchasedBalance de paquetes puntuales, total y disponible restante. Disponible en todos los planes.

Argumentos

Sin argumentos.

Devuelve

Un objeto con tier, isPaid, isTrial, upgradeUrl, limits.storage ({limit, current, exceeded}), limits.aiCredits ({monthly:{limit,current,exceeded}, purchasedBalance, total, available}) y creditsAvailable ({monthly, purchasedBalance, total}). Con ULTRA Unlimited, limits.aiCredits.monthly.limit y limits.aiCredits.total valen -1, limits.aiCredits.available es null, y creditsAvailable.monthly y creditsAvailable.total son null. purchasedBalance siempre es un número (cero cuando no hay packs).

Ejemplo

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

get_planmcp:read

Leer nombre del plan, ciclo de facturación (mensual o anual), estado de la suscripción de Stripe, moneda, fecha de renovación, fin de prueba y número de asientos. Combina con get_plan_limits. Disponible en todos los planes sin coste de créditos de IA.

Argumentos

Sin argumentos.

Devuelve

Un objeto con tier, isPaid, isTrial, billingCycle (mensual o anual o null), status (estado de Stripe), currency, renewalDate (ISO 8601), trialEnd (ISO 8601 o null), quantity (asientos o null), cancelAtPeriodEnd y upgradeUrl.

Ejemplo

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

search_toolsmcp:read

Buscar el catálogo de herramientas MCP por texto, categoría o intención. Devuelve categorías, scope y descripciones.

Argumentos

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

Devuelve

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

Ejemplo

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

create_avatarmcp:writePlan de pago

Generar una imagen de avatar de IA a partir de un prompt de texto. Requiere créditos de IA y un plan de pago.

Argumentos

Devuelve

Un objeto con taskId, status, imageUrl (cuando listo) y creditsUsed.

Ejemplo

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

set_current_teammcp:write

Cambiar el equipo activo para este token Bearer. El usuario debe ser miembro. Efecto inmediato para herramientas posteriores.

Argumentos

Devuelve

Un objeto con teamId, teamName, persisted y una nota opcional.

Ejemplo

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

update_brand_profilemcp:write

Actualizar el perfil de marca activo. Campos permitidos: brandVoice, mainThemes, contentGoals, contentTypes, primaryNiche, subNiches, industry, industries.

Argumentos

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

Devuelve

Un objeto con profileId, name, updated: [nombres de campos cambiados] y los valores actuales despues del patch.

Ejemplo

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

list_avatarsmcp:read

Lista tareas de generación de avatares para el usuario actual (en ámbito de usuario, no de equipo). Filtro de estado opcional y límite (predeterminado 50, máximo 100).

Argumentos

Ejemplo

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

get_avatarmcp:read

Recupera el detalle completo de una tarea de avatar por taskUUID. Devuelve el estado de la tarea, incluyendo las imágenes generadas al completarse. Cuando la teamId está resuelta, los accesos entre equipos se rechazan.

Argumentos

Ejemplo

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

get_avatar_statusmcp:read

Consulta el progreso de una tarea de avatar. Devuelve un estado breve (status, progress, message). Usa get_avatar para el detalle completo.

Argumentos

Ejemplo

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

list_assetsmcp:read

Lista activos (imágenes, vídeos y archivos subidos) del equipo activo. Filtros opcionales por carpeta o prefijo MIME. Usa get_asset para el detalle completo.

Argumentos

Ejemplo

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

get_assetmcp:read

Recupera el detalle completo de un activo por ID. El servicio subyacente rechaza accesos entre equipos.

Argumentos

Ejemplo

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

list_brand_assetsmcp:read

Lista activos de marca (logos, fuentes, paletas y similares) del equipo activo. Filtros opcionales por perfil de marca, tipo de archivo, categoría, etiquetas o búsqueda libre. Distinto de los perfiles de marca, que describen voz y temas.

Argumentos

Ejemplo

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

generate_imagemcp:writePlan de pago

Genera una o varias imágenes IA de forma síncrona (unos 30 segundos). El coste en créditos depende del modelo. El plan FREE está bloqueado. Pasa clientRequestId para reintentos idempotentes durante 5 minutos. Devuelve las URL de las imágenes generadas inmediatamente.

Argumentos

Ejemplo

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

generate_videomcp:writePlan de pago

Envía una tarea de generación de vídeo IA. Devuelve un taskUUID inmediatamente; la tarea se procesa de forma asíncrona (respaldada por BullMQ). Usa get_video_status para sondear. El coste en créditos se calcula por modelo y duración. El plan FREE está bloqueado.

Argumentos

Ejemplo

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

get_video_statusmcp:read

Consulta el progreso de una tarea de generación de vídeo. Devuelve el estado completo y la URL final del vídeo al completarse. Respaldado por una cola BullMQ (asíncrono real).

Argumentos

Ejemplo

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

search_stock_photosmcp:read

Busca fotografías de stock simultáneamente en Unsplash, Pexels y Pixabay. Devuelve resultados de cada proveedor más errores por proveedor. Solo búsqueda; no hay listado.

Argumentos

Ejemplo

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

list_community_workflowsmcp:read

Lista workflows publicados por la comunidad. Filtra por categoría, ordena por populares, recientes o vistas, y limita a propios, de equipo o todos. Usa get_community_workflow para el grafo completo.

Argumentos

Ejemplo

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

get_community_workflowmcp:read

Recupera el detalle completo de un workflow comunitario incluyendo su grafo de nodos y aristas. Usa list_community_workflows para explorar.

Argumentos

Ejemplo

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

list_pipelinesmcp:read

Lista pipelines (canvases de workflow) del equipo activo. Devuelve una forma reducida con conteo de nodos; usa get_pipeline para el grafo completo.

Argumentos

Ejemplo

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

get_pipelinemcp:read

Recupera un pipeline (canvas de workflow) por ID, en el ámbito del equipo activo. Devuelve el grafo completo de nodos y aristas.

Argumentos

Ejemplo

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

list_whiteboardsmcp:read

Lista los whiteboards de MySpace del usuario actual, en el ámbito del equipo activo. El contenido del whiteboard se omite en la vista de lista; usa el endpoint dedicado de lectura para el contenido.

Argumentos

Sin argumentos.

Ejemplo

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

list_conversationsmcp:read

Lista las conversaciones del Asistente IA del usuario para el equipo activo. Filtro opcional de estado (active o archived) y de etiquetas. Usa get_conversation para el historial completo.

Argumentos

Ejemplo

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

get_conversationmcp:read

Recupera una conversación del Asistente IA con su historial completo de mensajes. Los accesos entre usuarios y entre equipos son rechazados por el servicio.

Argumentos

Ejemplo

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

generate_designmcp:writePlan de pago

Genera un diseño de galería aplicando un skill a una imagen fuente (image-to-image). Síncrono ~30-45s. Cuesta 1 crédito de IA por llamada. El tier FREE está bloqueado. Usa list_skills para descubrir valores skillId válidos. Pasa clientRequestId para reintentos idempotentes dentro de 5 minutos.

Argumentos

Ejemplo

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

list_galleriesmcp:read

Lista los assets de galeria IA (disenos generados con generate_design) del equipo y usuario activos. Soporta paginacion y un filtro de categoria opcional. Devuelve una forma reducida: assetId, assetUrl, slug, displayName, galleryCategory, createdAt.

Argumentos

Ejemplo

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

list_skillsmcp:read

Lista los skills activos disponibles para generate_design. Devuelve skillId, name, type (image o video), group y category. Usalo para descubrir valores skillId validos antes de llamar a generate_design.

Argumentos

Ejemplo

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

generate_cinema_studiomcp:writePlan de pago

Genera imágenes IA cinematográficas usando una combinación de cuerpo de cámara, objetivo, distancia focal, apertura y proporción. Síncrono, unos 30 segundos. El coste en créditos depende del modelo. El plan FREE está bloqueado. Pasa referenceImageUrl para cambiar al modo de imagen de referencia (transferencia de estilo). Pasa clientRequestId para reintentos idempotentes durante 5 minutos.

Argumentos

Ejemplo

{"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:writeDestructivo

Cancela una tarea de generación de avatar pendiente o en curso. El reembolso del lado del servicio devuelve los créditos previamente cobrados. Las tareas en estado final (completed o failed) no se pueden cancelar; la llamada devuelve un error estructurado.

Argumentos

Ejemplo

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

cancel_video_taskmcp:writeDestructivo

Cancela una tarea de generación de video pendiente o en curso. El reembolso del lado del servicio devuelve los créditos previamente cobrados. Las tareas en estado final (completed o failed) no se pueden cancelar; la llamada devuelve un error estructurado.

Argumentos

Ejemplo

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

list_video_tasksmcp:read

Lista las tareas de generación de video del usuario actual (por usuario, paridad con list_avatars). Filtro de estado opcional (pending, processing, completed, failed, cancelled) y límite (predeterminado 20, max 100). Usa get_video_status para detalle completo de polling.

Argumentos

Ejemplo

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

get_brand_profilemcp:read

Recupera el detalle completo de un único perfil de marca por ID. El acceso entre equipos se rechaza con un not-found genérico (sin fuga de existencia). Usa list_brand_profiles para enumerar IDs.

Argumentos

Ejemplo

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

get_brand_assetmcp:read

Recupera el detalle completo de un único asset de marca por ID. El acceso entre equipos se rechaza con un not-found genérico (sin fuga de existencia). Usa list_brand_assets para enumerar IDs.

Argumentos

Ejemplo

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

get_photo_packmcp:read

Recupera una única categoría de photo-pack incluyendo sus imágenes. Forma de catálogo (no por equipo). Código de idioma opcional; recurre a inglés si el locale solicitado falta.

Argumentos

Ejemplo

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

get_whiteboardmcp:read

Recupera un único whiteboard por ID incluyendo su blob de contenido completo. Los whiteboards son por usuario (solo creador); el acceso entre usuarios se rechaza con un not-found genérico.

Argumentos

Ejemplo

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

delete_designmcp:writeDestructivo

Borra un diseño. Tu cliente te lo pregunta antes.

Argumentos

delete_assetmcp:writeDestructivo

Borra una imagen o un vídeo de Assets.

Argumentos

edit_imagemcp:write

Cambia una parte de la imagen y conserva el resto.

Argumentos

Devuelve

La respuesta incluye creditsCharged, los créditos que ha gastado la edición.

apply_image_templatemcp:write

Ejecuta una plantilla por su nombre con tu foto.

Argumentos

Devuelve

La respuesta incluye creditsCharged, los créditos que ha gastado la ejecución. El prompt de la plantilla nunca se devuelve.

remove_backgroundmcp:write

Un PNG transparente del producto.

Argumentos

Devuelve

La URL de un PNG con fondo transparente.

photo_anglesmcp:write

Otro ángulo de cámara del mismo producto.

Argumentos

spotlightmcp:write

Cambia la luz: dirección, tipo, brillo y color.

Argumentos

flat_laymcp:write

Un flat lay con varias fotos de producto.

Argumentos

product_admcp:write

Una imagen de anuncio desde una foto.

Argumentos

virtual_try_onmcp:write

Una prenda puesta a la persona de tu foto.

Argumentos

skin_retouchmcp:write

Piel limpia, con la pose y el fondo intactos.

Argumentos

fashion_videomcp:write

Movimiento de pasarela sin cambiar la ropa.

Argumentos

Devuelve

Un taskUUID. El vídeo se genera en segundo plano. Compruébalo con get_video_status.

styled_scenemcp:write

Una escena por ciudad, estación y hora.

Argumentos

create_video_projectmcp:write

Una línea de tiempo: clips, rótulos, sonido y estilo.

Argumentos

Devuelve

El id del proyecto de vídeo nuevo. La llamada no renderiza el vídeo y no gasta créditos.

render_video_projectmcp:write

Convierte la línea de tiempo en un MP4.

Argumentos

Devuelve

La llamada responde al instante. El render tarda entre uno y cinco minutos. Compruébalo con get_video_render_status.

get_video_render_statusmcp:read

El MP4 cuando la línea de tiempo termina.

Argumentos

Devuelve

La URL del MP4 final cuando el render termina. El error cuando el render falla.

delete_video_projectmcp:writeDestructivo

Borra una línea de tiempo que ya no necesitas.

Argumentos

run_pipelinemcp:write

Ejecuta un flujo de trabajo y lee cada paso.

Argumentos

Devuelve

Los resultados de cada paso: imágenes, vídeos o texto. La llamada espera a que la ejecución termine, hasta unos ocho minutos.

create_pipelinemcp:write

Guarda un flujo de trabajo nuevo.

Argumentos

Devuelve

El id del flujo de trabajo nuevo. La llamada guarda el flujo de trabajo y no lo ejecuta.

update_pipelinemcp:write

Cambia los pasos de un flujo de trabajo.

Argumentos

delete_pipelinemcp:writeDestructivo

Borra un flujo de trabajo del espacio de trabajo.

Argumentos

run_appmcp:write

Ejecuta una app con sus campos rellenos.

Argumentos

Devuelve

Un runId. La ejecución sigue en segundo plano. Compruébala con get_app_run.

get_app_runmcp:read

El progreso de una ejecución y sus resultados.

Argumentos

Devuelve

El estado de la ejecución, su progreso (completados, total y porcentaje) y el error, si lo hay. Cuando la ejecución termina, las imágenes del resultado.

create_designmcp:write

Guarda un diseño de Studio, hasta veinte páginas.

Argumentos

Devuelve

El id del diseño nuevo. Puedes abrir el diseño en el editor de Studio. La llamada no genera ninguna imagen.

create_brand_profilemcp:write

Crea un perfil de marca: nombre, voz, temas, sector.

Argumentos

set_default_brand_profilemcp:write

Elige qué perfil de marca es el predeterminado del equipo.

Argumentos

talking_avatarmcp:write

Una cara que lee tu guion o tu audio.

Argumentos

Devuelve

Un requestId, al instante. El vídeo tarda entre uno y tres minutos. Compruébalo con get_talking_avatar_status. La respuesta incluye creditsCharged.

get_talking_avatar_statusmcp:read

El clip sincronizado cuando está listo.

Argumentos

Devuelve

El estado de la tarea. Cuando la tarea termina, la URL del vídeo final.

list_image_templatesmcp:read

El catálogo de plantillas, con búsqueda.

Argumentos

Devuelve

Una página de tarjetas de plantillas. Cada tarjeta tiene un id, un slug, un título, hashtags e imágenes de vista previa. El prompt no se incluye.

get_image_templatemcp:read

Una plantilla con su modelo y su tamaño.

Argumentos

Devuelve

Las imágenes de vista previa, el título, la descripción y los hashtags, además del modelo, la relación de aspecto y el tamaño que usa la plantilla. El prompt no se devuelve.

list_image_modelsmcp:read

Modelos de imagen y lo que cuesta cada uno.

Argumentos

Devuelve

Para cada modelo: su id, lo que puede hacer, las relaciones de aspecto que admite y su coste en créditos por imagen.

list_video_modelsmcp:read

Modelos de vídeo, con duración y coste.

Argumentos

Devuelve

Para cada modelo: su id, lo que puede hacer, las duraciones y resoluciones que permite y su coste en créditos por segundo.

import_chat_imagemcp:write

Las imágenes que adjuntas a un mensaje, guardadas en Assets.

Argumentos

upload_assetmcp:write

Un selector de archivos en el chat. El archivo va a Assets.

Argumentos

Sin argumentos.

Devuelve

La URL del archivo que has añadido. Pásala como imagen a apply_image_template, edit_image o generate_design.