MCP 도구 참조

list_designsmcp:read

선택적 폴더 필터와 페이지네이션으로 현재 팀의 디자인을 나열합니다.

인수

반환

designs: [{id, title, folderId, brandProfileId, createdAt, updatedAt}] 객체.

예시

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

get_designmcp:read

제목, 폴더, 브랜드 프로필 참조 및 생성 날짜를 포함한 단일 디자인의 전체 메타데이터를 가져옵니다.

인수

반환

전체 디자인 메타데이터를 포함한 객체: id, title, folderId, brandProfileId, createdAt, updatedAt.

예시

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

search_designsmcp:read

활성 팀의 디자인 제목과 설명에 대한 전체 텍스트 검색입니다.

인수

반환

designs: [{id, title, folderId, snippet, updatedAt}] 객체.

예시

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

list_brand_profilesmcp:read

현재 팀의 모든 브랜드 프로필을 목소리, 테마, 틈새, 업종과 함께 반환합니다.

인수

인수 없음.

반환

profiles: [{id, name, brandVoice, mainThemes, primaryNiche, industry, isActive}] 객체.

예시

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

list_foldersmcp:read

활성 팀 워크스페이스의 폴더를 나열합니다. list_designs를 특정 폴더로 제한하는 데 유용합니다.

인수

인수 없음.

반환

folders: [{id, name, designCount, createdAt}] 객체.

예시

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

list_photo_packsmcp:read

사용 가능한 사진팩을 탐색합니다. 카테고리 레이블에 대한 선택적 언어 매개변수를 허용합니다.

인수

반환

packs: [{id, name, category, imageCount, language}] 객체.

예시

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

list_teamsmcp:read

인증된 사용자가 속한 팀과 현재 활성 팀을 반환합니다.

인수

인수 없음.

반환

currentTeamId와 teams: [{teamId, teamName, isCurrent}] 객체.

예시

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

get_plan_limitsmcp:read

현재 구독 계층과 계층별 할당량(저장 공간과 AI 크레딧)을 읽습니다. aiCredits 블록은 월간 구독 크레딧, 일회성 크레딧 팩의 purchasedBalance, total 한도, 남은 available을 중첩합니다. 모든 플랜에서 사용 가능합니다.

인수

인수 없음.

반환

tier, isPaid, isTrial, upgradeUrl, limits.storage ({limit, current, exceeded}), limits.aiCredits ({monthly:{limit,current,exceeded}, purchasedBalance, total, available}), creditsAvailable ({monthly, purchasedBalance, total})를 포함한 객체. ULTRA Unlimited인 경우 limits.aiCredits.monthly.limit와 limits.aiCredits.total은 둘 다 -1, limits.aiCredits.available은 null, creditsAvailable.monthly와 creditsAvailable.total은 둘 다 null입니다. purchasedBalance는 항상 숫자입니다(팩이 없으면 0).

예시

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

get_planmcp:read

플랜 이름, 청구 주기(월간 또는 연간), Stripe 구독 상태, 통화, 갱신일, 체험 종료일, 좌석 수를 읽습니다. get_plan_limits와 한 쌍입니다. 모든 플랜에서 AI 크레딧 비용 없이 사용 가능합니다.

인수

인수 없음.

반환

tier, isPaid, isTrial, billingCycle(월간 또는 연간 또는 null), status(Stripe 상태), currency, renewalDate(ISO 8601), trialEnd(ISO 8601 또는 null), quantity(좌석 수 또는 null), cancelAtPeriodEnd, upgradeUrl을 포함한 객체.

예시

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

search_toolsmcp:read

텍스트, 카테고리 또는 의도로 MCP 도구 카탈로그를 검색합니다. 카테고리, 범위, 설명을 반환합니다.

인수

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

반환

totalTools, matchCount, categories, tools: [{name, category, requiresScope, description, useCases, matchedOn: [name|category|description|use_case]}] 객체.

예시

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

create_avatarmcp:write유료 플랜

텍스트 프롬프트로 AI 아바타 이미지를 생성합니다. AI 크레딧과 유료 플랜이 필요합니다.

인수

반환

taskId, status, imageUrl (준비 시), creditsUsed를 포함한 객체.

예시

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

set_current_teammcp:write

이 Bearer 토큰의 활성 팀을 전환합니다. 사용자가 멤버여야 합니다. 이후 도구에 즉시 적용됩니다.

인수

반환

teamId, teamName, persisted, 선택적 메모를 포함한 객체.

예시

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

update_brand_profilemcp:write

활성 브랜드 프로필을 업데이트합니다. 허용된 필드: brandVoice, mainThemes, contentGoals, contentTypes, primaryNiche, subNiches, industry, industries.

인수

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

반환

profileId, name, updated: [변경된 필드 이름], 패치 후 현재 값을 포함한 객체.

예시

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

list_avatarsmcp:read

현재 사용자의 아바타 생성 작업을 나열합니다(사용자 범위, 팀 범위 아님). 선택적 상태 필터와 한도(기본 50, 최대 100).

인수

예시

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

get_avatarmcp:read

taskUUID로 단일 아바타 작업의 전체 세부정보를 가져옵니다. 완료 시 생성된 이미지를 포함한 작업 상태를 반환합니다. teamId가 해결되면 팀 간 접근은 거부됩니다.

인수

예시

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

get_avatar_statusmcp:read

아바타 작업 진행 상황을 폴링합니다. 간단한 상태 스냅샷(status, progress, message)을 반환합니다. 완료 후 생성된 이미지를 포함한 전체 세부정보는 get_avatar를 사용하세요.

인수

예시

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

list_assetsmcp:read

활성 팀의 자산(업로드된 이미지, 비디오, 파일)을 나열합니다. 폴더 또는 MIME 접두사로 선택적 필터링이 가능합니다. 전체 세부정보는 get_asset을 사용하세요.

인수

예시

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

get_assetmcp:read

ID로 단일 자산의 전체 세부정보를 가져옵니다. 팀 간 접근은 기본 서비스에서 거부됩니다.

인수

예시

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

list_brand_assetsmcp:read

활성 팀의 브랜드 자산(로고, 폰트, 팔레트 등)을 나열합니다. 브랜드 프로필, 파일 유형, 카테고리, 태그 또는 자유 텍스트로 선택적 필터링이 가능합니다. 음성과 테마를 설명하는 브랜드 프로필과는 다릅니다.

인수

예시

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

generate_imagemcp:write유료 플랜

하나 이상의 AI 이미지를 동기적으로 생성합니다(약 30초). 크레딧 비용은 모델에 따라 다릅니다. FREE 플랜은 차단됩니다. 5분 내 멱등 재시도를 위해 clientRequestId를 전달하세요. 생성된 이미지 URL을 즉시 반환합니다.

인수

예시

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

generate_videomcp:write유료 플랜

AI 비디오 생성 작업을 제출합니다. 즉시 taskUUID를 반환하며 작업은 비동기적으로 처리됩니다(BullMQ 지원). 완료 폴링에는 get_video_status를 사용하세요. 크레딧 비용은 모델과 길이에 따라 계산됩니다. FREE 플랜은 차단됩니다.

인수

예시

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

get_video_statusmcp:read

비디오 생성 작업 진행 상황을 폴링합니다. 완료 시 최종 비디오 URL을 포함한 전체 작업 상태를 반환합니다. BullMQ 큐(실제 비동기)로 지원됩니다.

인수

예시

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

search_stock_photosmcp:read

Unsplash, Pexels, Pixabay에서 동시에 스톡 사진을 검색합니다. 각 공급자의 결과와 공급자별 오류를 반환합니다. 검색만 가능하며 목록 또는 탐색은 없습니다.

인수

예시

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

list_community_workflowsmcp:read

게시된 커뮤니티 워크플로우를 나열합니다. 카테고리로 필터링하고 인기, 최신, 조회수로 정렬하며 내 것, 팀 또는 모두로 범위를 지정합니다. 전체 그래프는 get_community_workflow를 사용하세요.

인수

예시

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

get_community_workflowmcp:read

커뮤니티 워크플로우의 노드 그래프와 엣지를 포함한 전체 세부정보를 가져옵니다. 탐색은 list_community_workflows를 사용하세요.

인수

예시

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

list_pipelinesmcp:read

활성 팀의 파이프라인(워크플로우 캔버스)을 나열합니다. 노드 수가 포함된 간소화된 형태를 반환하며 전체 그래프는 get_pipeline을 사용하세요.

인수

예시

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

get_pipelinemcp:read

활성 팀 범위에서 ID로 파이프라인(워크플로우 캔버스)을 가져옵니다. 전체 노드 및 엣지 그래프를 반환합니다.

인수

예시

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

list_whiteboardsmcp:read

활성 팀 범위에서 현재 사용자의 MySpace 화이트보드를 나열합니다. 화이트보드 콘텐츠는 목록 보기에서 생략되며, 콘텐츠는 전용 읽기 엔드포인트를 사용하세요.

인수

인수 없음.

예시

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

list_conversationsmcp:read

활성 팀에 대한 사용자의 AI Assistant 채팅 대화를 나열합니다. 선택적 상태 필터(active 또는 archived)와 태그 필터. 전체 메시지 기록은 get_conversation을 사용하세요.

인수

예시

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

get_conversationmcp:read

단일 AI Assistant 대화의 전체 메시지 기록을 가져옵니다. 사용자 간 및 팀 간 접근은 기본 서비스에서 거부됩니다.

인수

예시

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

generate_designmcp:write유료 플랜

소스 이미지에 스킬을 적용하여 갤러리 디자인을 생성합니다 (image-to-image). 동기 ~30-45초. 호출당 1 AI 크레딧. FREE 티어는 차단됩니다. list_skills를 사용하여 유효한 skillId 값을 발견하십시오. 5분 이내 멱등 재시도를 위해 clientRequestId를 전달하십시오.

인수

예시

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

list_galleriesmcp:read

활성 팀과 사용자의 AI 갤러리 자산 (generate_design으로 생성된 디자인)을 나열합니다. 페이지네이션과 선택적 카테고리 필터를 지원합니다. 슬림 형태로 반환합니다: assetId, assetUrl, slug, displayName, galleryCategory, createdAt.

인수

예시

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

list_skillsmcp:read

generate_design에 사용 가능한 활성 스킬을 나열합니다. skillId, name, type (image 또는 video), group, category를 반환합니다. generate_design을 호출하기 전에 유효한 skillId 값을 발견하는 데 사용하십시오.

인수

예시

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

generate_cinema_studiomcp:write유료 플랜

카메라 바디, 렌즈, 초점 거리, 조리개, 화면 비율 조합을 사용하여 시네마틱 AI 이미지를 생성합니다. 동기 방식이며 약 30초가 걸립니다. 크레딧 비용은 모델에 따라 다릅니다. FREE 플랜은 차단됩니다. referenceImageUrl을 제공하면 reference-image(스타일 전이) 모드로 전환됩니다. 5분 이내 멱등 재시도를 위해 clientRequestId를 전달하세요.

인수

예시

{"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:write파괴적

대기 중이거나 진행 중인 아바타 생성 작업을 취소합니다. 서비스 측 환불 경로가 이전에 청구된 크레딧을 반환합니다. 종료 상태 (completed 또는 failed) 작업은 취소할 수 없으며, 호출은 구조화된 오류를 반환합니다.

인수

예시

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

cancel_video_taskmcp:write파괴적

대기 중이거나 진행 중인 비디오 생성 작업을 취소합니다. 서비스 측 환불 경로가 이전에 청구된 크레딧을 반환합니다. 종료 상태 (completed 또는 failed) 작업은 취소할 수 없으며, 호출은 구조화된 오류를 반환합니다.

인수

예시

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

list_video_tasksmcp:read

현재 사용자의 비디오 생성 작업을 나열합니다 (사용자 범위, list_avatars와 동등). 선택적 상태 필터 (pending, processing, completed, failed, cancelled)와 한도 (기본값 20, 최대 100). 전체 폴링 상세 정보는 get_video_status를 사용하십시오.

인수

예시

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

get_brand_profilemcp:read

ID로 단일 브랜드 프로필의 전체 상세 정보를 검색합니다. 팀 간 접근은 일반적인 not-found로 거부됩니다 (존재 누출 없음). ID 열거에는 list_brand_profiles를 사용하십시오.

인수

예시

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

get_brand_assetmcp:read

ID로 단일 브랜드 자산의 전체 상세 정보를 검색합니다. 팀 간 접근은 일반적인 not-found로 거부됩니다 (존재 누출 없음). ID 열거에는 list_brand_assets를 사용하십시오.

인수

예시

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

get_photo_packmcp:read

이미지를 포함한 단일 포토팩 카테고리를 검색합니다. 카탈로그 형태 (팀 범위 없음). 선택적 언어 코드; 요청된 로케일이 없으면 영어로 대체됩니다.

인수

예시

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

get_whiteboardmcp:read

전체 콘텐츠 블롭을 포함한 단일 화이트보드를 ID로 검색합니다. 화이트보드는 사용자 범위 (생성자 전용)이며, 사용자 간 접근은 일반적인 not-found로 거부됩니다.

인수

예시

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

delete_designmcp:write파괴적

디자인 삭제, 실행 전에 클라이언트가 먼저 확인

인수

delete_assetmcp:write파괴적

Assets에서 이미지나 영상 삭제

인수

edit_imagemcp:write

이미지 한 부분만 바꾸고 나머지 유지

인수

반환

응답에는 이 편집에 쓴 크레딧인 creditsCharged가 들어 있습니다.

apply_image_templatemcp:write

내 사진으로 템플릿 실행

인수

반환

응답에는 이 실행에 쓴 크레딧인 creditsCharged가 들어 있습니다. 템플릿의 프롬프트는 반환하지 않습니다.

remove_backgroundmcp:write

제품의 투명 PNG

인수

반환

배경이 투명한 PNG의 URL.

photo_anglesmcp:write

같은 제품의 새 카메라 앵글

인수

spotlightmcp:write

사진 조명 변경: 방향, 종류, 밝기, 색

인수

flat_laymcp:write

제품 사진 여러 장으로 만든 플랫 레이

인수

product_admcp:write

제품 사진으로 만든 광고 이미지

인수

virtual_try_onmcp:write

사진 속 인물이 입은 옷

인수

skin_retouchmcp:write

포즈와 배경을 지킨 피부 리터칭

인수

fashion_videomcp:write

착장을 그대로 지킨 런웨이 움직임

인수

반환

taskUUID. 영상은 백그라운드에서 만들어집니다. get_video_status로 확인합니다.

styled_scenemcp:write

도시와 계절, 시간대로 만드는 장면

인수

create_video_projectmcp:write

타임라인: 클립, 타이틀, 사운드, 색감

인수

반환

새 영상 프로젝트의 id. 이 호출은 영상을 렌더링하지 않고 크레딧도 쓰지 않습니다.

render_video_projectmcp:write

타임라인을 MP4 파일 하나로

인수

반환

호출은 바로 응답합니다. 렌더링에는 약 1분에서 5분이 걸립니다. get_video_render_status로 확인합니다.

get_video_render_statusmcp:read

타임라인이 끝난 뒤의 MP4

인수

반환

렌더링이 끝나면 완성된 MP4의 URL. 렌더링에 실패하면 그 오류.

delete_video_projectmcp:write파괴적

더 이상 필요 없는 타임라인 삭제

인수

run_pipelinemcp:write

워크플로우 실행과 단계별 결과

인수

반환

각 단계의 결과: 이미지, 영상 또는 텍스트. 호출은 실행이 끝날 때까지 최대 약 8분 동안 기다립니다.

create_pipelinemcp:write

워크스페이스에 새 워크플로우 저장

인수

반환

새 워크플로우의 id. 이 호출은 워크플로우를 저장만 하고 실행하지 않습니다.

update_pipelinemcp:write

가지고 있는 워크플로우의 단계 변경

인수

delete_pipelinemcp:write파괴적

워크스페이스에서 워크플로우 삭제

인수

run_appmcp:write

양식을 채워 앱 실행

인수

반환

runId. 실행은 백그라운드에서 계속됩니다. get_app_run으로 확인합니다.

get_app_runmcp:read

실행 진행 상황과 결과

인수

반환

실행의 상태, 진행 상황(완료 수, 전체 수, 퍼센트), 오류가 있으면 그 내용. 실행이 끝나면 결과 이미지도 반환합니다.

create_designmcp:write

Studio 디자인 저장, 최대 20페이지

인수

반환

새 디자인의 id. 디자인은 Studio 편집기에서 열 수 있습니다. 이 호출은 이미지를 만들지 않습니다.

create_brand_profilemcp:write

브랜드 프로필 만들기: 이름, 목소리, 테마, 업종

인수

set_default_brand_profilemcp:write

팀의 기본 브랜드 프로필 선택

인수

talking_avatarmcp:write

대본이나 음성을 읽는 얼굴

인수

반환

requestId를 바로 반환합니다. 영상에는 약 1분에서 3분이 걸립니다. get_talking_avatar_status로 확인합니다. 응답에는 creditsCharged가 들어 있습니다.

get_talking_avatar_statusmcp:read

완성된 립싱크 클립

인수

반환

작업의 상태. 작업이 끝나면 완성된 영상의 URL.

list_image_templatesmcp:read

검색할 수 있는 템플릿 카탈로그

인수

반환

템플릿 카드 한 페이지. 카드마다 id, slug, 제목, 해시태그, 미리보기 이미지가 있습니다. 프롬프트는 들어 있지 않습니다.

get_image_templatemcp:read

템플릿 하나의 모델과 크기

인수

반환

미리보기 이미지, 제목, 설명, 해시태그와 템플릿이 쓰는 모델, 화면 비율, 크기. 프롬프트는 반환하지 않습니다.

list_image_modelsmcp:read

이미지 모델과 모델별 비용

인수

반환

모델마다 id, 할 수 있는 일, 지원하는 화면 비율, 이미지 한 장당 크레딧 비용.

list_video_modelsmcp:read

영상 모델과 길이, 비용

인수

반환

모델마다 id, 할 수 있는 일, 선택할 수 있는 길이와 해상도, 초당 크레딧 비용.

import_chat_imagemcp:write

메시지에 첨부한 이미지, Assets에 저장

인수

upload_assetmcp:write

채팅 안의 파일 선택 창, 파일은 Assets로

인수

인수 없음.

반환

추가한 파일의 URL. apply_image_template, edit_image, generate_design에 이미지로 넘길 수 있습니다.