MCPツールリファレンス

list_designsmcp:read

フォルダフィルターとページネーションを任意で指定して、現在のチームのデザインを一覧表示します。

引数

戻り値

designsを含むオブジェクト：[{id, title, folderId, brandProfileId, createdAt, updatedAt}]。最大でlimit件の結果。

例

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

有効なチームのデザインのタイトルと説明を全文検索します。フィルター：limit（1〜100、デフォルト20）。

引数

戻り値

designsを含むオブジェクト：[{id, title, folderId, snippet, updatedAt}]。snippetには一致した箇所の文脈が含まれます。

例

{"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、合計上限、残りの利用可能分が含まれます。変更系ツールを呼ぶ前に、呼び出しが成功するかを予測するのに役立ちます。

引数

引数なし。

戻り値

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は常に数値です（パックがない場合はゼロ）。

例

{"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（monthly、yearly、または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ツールカタログを検索します。カテゴリ、requiresScope、1行の説明、一致したユースケースタグを返します。すべてのプランで無料です（ディスカバリー用）。

引数

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

戻り値

totalTools、matchCount、categories：[string[]]、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アバター画像を生成します。生成された画像のURLとタスクIDを返します。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トークンの有効なチームを切り替えます。ユーザーはそのメンバーである必要があります。OAuthトークンに保存され、セッション内での変更は、同じ会話内の以降のツールに即時反映されます。

引数

戻り値

teamId、teamName、persisted（OAuthならtrue、APIキーならfalse）、および任意のnoteを含むオブジェクト。

例

{"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：[更新された項目名]、および更新後のbrandVoice、mainThemes、contentGoals、contentTypes、primaryNiche、industryの現在値を含むオブジェクト。

例

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

list_avatarsmcp:read

現在のユーザーのアバター生成タスクを一覧表示します（チーム単位ではなくユーザー単位）。任意のステータスフィルターとlimit（デフォルト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有料プラン

1枚以上の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

公開されたコミュニティワークフローを一覧表示します。カテゴリで絞り込み、人気順、新着順、閲覧数順で並べ替え、mine、team、allの範囲を指定できます。グラフ全体は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アシスタントチャット会話を一覧表示します。任意のステータスフィルター（activeまたはarchived）とタグフィルターを指定できます。メッセージ履歴全体はget_conversationを使います。

引数

例

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

get_conversationmcp:read

単一のAIアシスタント会話を、メッセージ履歴をすべて含めて取得します。ユーザーやチームをまたぐアクセスは、基盤サービスによって拒否されます。

引数

例

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

generate_designmcp:write有料プラン

ソース画像にスキルを適用してギャラリーデザインを生成します（image-to-image）。同期処理で約30〜45秒。1回の呼び出しにつき1AIクレジットを消費します。FREEティアは利用できません。有効なskillIdの値はlist_skillsで確認します。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）とlimit（デフォルト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

複数の商品写真から1枚のフラットレイ。

引数

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

タイムラインを1本の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

テンプレートのカタログ、検索できます。

引数

戻り値

テンプレートカードの1ページ。各カードにはid、slug、タイトル、ハッシュタグ、プレビュー画像があります。プロンプトは含まれません。

get_image_templatemcp:read

1つのテンプレートのモデルとサイズ。

引数

戻り値

プレビュー画像、タイトル、説明、ハッシュタグと、テンプレートが使うモデル、アスペクト比、サイズ。プロンプトは返されません。

list_image_modelsmcp:read

画像モデルと、それぞれの費用。

引数

戻り値

モデルごとに、id、できること、対応するアスペクト比、1枚あたりのクレジット費用。

list_video_modelsmcp:read

動画モデルと、長さと費用。

引数

戻り値

モデルごとに、id、できること、選べる長さと解像度、1秒あたりのクレジット費用。

import_chat_imagemcp:write

メッセージに添付した画像をAssetsに保存します。

引数

upload_assetmcp:write

チャット内のファイル選択画面。ファイルはAssetsに入ります。

引数

引数なし。

戻り値

追加したファイルのURL。apply_image_template、edit_image、generate_designに画像として渡せます。