ツール一覧

TAGRU の MCP サーバーで呼び出せるツールです。結果は JSON(structuredContent)で返ります。

ツール名のきまり

  • 名前が workspaces_ で始まらないツールは、あなた自身のアカウントを対象にします。
  • workspaces_ で始まるツールは、引数 workspace_id で指定したワークスペースを対象にします。ID は workspaces_me で確認できます。
  • 「スコープ」の表示が無いツールは、接続できていれば使えます。「ワークスペース」の表示は、ワークスペース用ツールを使えるメンバーの条件(参加メンバー、またはオーナー・管理者)です。

接続確認・ワークスペース

接続できているか、どのワークスペースを操作できるかを確認するツールです。

  • health_ping

    MCP サーバーが動いているかを確認します。

  • auth_whoami

    認証中のユーザー ID と、付与されているスコープを返します。プランの確認を行わないため、認証の問題かプランの問題かの切り分けに使えます。

  • workspaces_me

    MCP で操作できるワークスペースの一覧(ID・名前・あなたの立場)を返します。ワークスペース用ツールに渡す workspace_id はここで確認します。

下書き・メディア

下書きの作成・一覧と、下書きに添付するメディアのアップロードです。

  • draft_createworkspaces_draft_create
    スコープ: draft.write ワークスペース: オーナー・管理者

    下書きを作成します。メディアを添付する場合は、先にメディアのアップロードで返された path を media に渡します。メディアを渡さない場合は media_prompts を 1 件以上指定します。

    主な引数

    • parameters.title(必須・100 文字まで)
    • parameters.text(必須・2000 文字まで)
    • parameters.media(任意・アップロード済みの path、5 件まで)
    • parameters.media_prompts(media が無いとき必須・5 件まで、各 200 文字まで)
    • parameters.hashtags(任意・5 件まで、各 20 文字まで)
    • parameters.why(任意・500 文字まで)
    • parameters.workspace_id(ワークスペース用のみ・必須)
  • draft_listworkspaces_draft_list
    ワークスペース: オーナー・管理者

    下書きを更新日の新しい順に 9 件ずつ返します。続きは、前のページの最後の下書き ID を start_after に渡して取得します。

    主な引数

    • start_after(任意)
    • workspace_id(ワークスペース用のみ・必須)
  • media_uploadworkspaces_media_upload
    スコープ: draft.write ワークスペース: オーナー・管理者

    画像(png / jpg / jpeg)または動画(mp4 / mov)をアップロードし、下書きに渡す path を返します。1 ファイル 100MB まで。mov は mp4 に変換して保存します。

    主な引数

    • content(必須・ファイルを Base64 にした文字列)
    • filename(必須・拡張子付き)
    • kind(必須・image または video)
    • workspace_id(ワークスペース用のみ・必須)

画像の作成・編集

TAGRU の「画像作成」「画像編集」と同じ画像生成です(投稿案の画像とは別)。生成した画像は画面と同じ月間の上限を使い、指示(プロンプト)は画面のプロンプトの履歴にも残ります。

  • image_generateworkspaces_image_generate
    スコープ: draft.write ワークスペース: 参加メンバー

    mode が create なら指示(prompt)から画像を作成し、edit なら元の画像(main_image_path)から画像を作ります。元の画像には、メディアのアップロードで返された path、素材の path、以前に作った画像の path を渡します。生成した画像の path(paths)を返すので、そのまま下書きの作成の media に渡せます(1 時間以内)。結果には生成した画像の縮小版(長辺 512px の JPEG)も入り、AI がその場で見て確かめられます(n 枚目の縮小版は paths の n 番目。大きさの上限に入らない分は省きますが、paths はそのまま使えます)。preview に false を渡すと縮小版を入れません。時間切れのあとに画像の履歴の一覧から受け取った画像は、画像の縮小版の受け取り(image_preview_get)で見られます。生成には 1 分ほどかかることがあります(AI クライアント側で時間切れになっても生成は続き、上限を使います。すぐにやり直さず、画像の履歴の一覧で自分の生成(mine)を作成日時と指示から探し、status が done になっていればその paths を使ってください)。月間の上限に達すると error.code が image_limit_exceeded になります。

    主な引数

    • mode(必須・create または edit)
    • prompt(create のとき必須)
    • main_image_path(edit のとき必須)
    • sub_image_path(任意・edit で合成に使う画像)
    • aspect_ratio(任意・1:1 / 3:4 / 4:3 / 9:16 / 16:9。既定は 3:4)
    • preview(任意・false で縮小版を入れない。既定は true)
    • workspace_id(ワークスペース用のみ・必須)
  • image_history_listworkspaces_image_history_list
    ワークスペース: 参加メンバー

    画像の作成・編集の履歴(画面で作ったものも含む)を新しい順に返します。各件に id・作成日時(created_at。生成を始めた時刻)・mode・status・生成した画像の path(paths)・縦横比・指示(長いものは短くします)・mine・stalled・draft_usable_until が入ります。status は done(完成。paths に画像)、processing(生成中。1 分ほどしてから読み直し、作成日時から 5 分たっても processing のままなら読み直しをやめて利用者に伝えます)、error(失敗。上限は使っています)のどれかで、stalled が true の processing は止まっていてもう終わりません(true になるのは生成を始めてから 1 時間後です)。mine は自分が作ったものなら true(ワークスペースでは他のメンバーのものは false、作った人を記録する前の履歴は null)。draft_usable_until は paths を下書きの media に渡せる期限です(下書きに渡せるのは 1 時間以内に作った画像だけ)。limit は 1〜24 件(既定 10 件)で、続きは next_cursor を cursor に渡して取得します。画像の作成・編集が時間切れになったときに、mine が true で作成日時が呼び出した直後・指示が一致するものを探し、生成し直さずに使います。一覧には縮小版は入らないので、画像を見て確かめるときは画像の縮小版の受け取り(image_preview_get)に id を渡します。読み取りなので上限は使いません。

    主な引数

    • limit(任意・1〜24。既定は 10)
    • cursor(任意・前の結果の next_cursor)
    • workspace_id(ワークスペース用のみ・必須)
  • image_preview_getworkspaces_image_preview_get
    ワークスペース: 参加メンバー

    画像の履歴の 1 件(id)の画像の縮小版(長辺 512px の JPEG)を返し、AI がその場で見て確かめられます。時間切れのあとに画像の履歴の一覧から受け取った画像を見るときに使います。index を省くとその履歴の画像を全部(大きさの上限まで)、指定するとその 1 枚だけを返します。previews に返した縮小版の index と path が縮小版と同じ順で入り、count はその履歴の画像の枚数です(返した縮小版で大きさの上限に達すると、残りの画像は読まずに省きます。省いた画像は failures には入らないので、index を指定して読み直します)。読めなかった画像は飛ばして failures に理由(image_not_found は画像が消えている、image_preview_failed は読み込み・縮小の失敗で画像は残っている、image_preview_too_large はその画像の縮小版だけで大きさの上限を超え、呼び直しても同じ)と一緒に入ります。存在しない id・範囲外の index・画像の無い履歴(生成中など)・消えた画像は error.code が image_not_found、読み込み・縮小の失敗で 1 枚も作れなかったときは image_preview_failed(画像は残っているので作り直さず、時間をおいて呼び直します。1〜2 回呼び直しても同じなら呼び直しをやめ、paths をそのまま使います)、大きさだけが原因なら image_preview_too_large(呼び直さず、paths をそのまま使います)になります。読み取りなので上限は使いません。

    主な引数

    • id(必須・画像の履歴の一覧の id)
    • index(任意・0 始まり。省くと全部)
    • workspace_id(ワークスペース用のみ・必須)

動画の生成

TAGRU の動画作成(プレミアム動画)・tagru video と同じ動画の生成です。動画の生成が有効なアカウント・ワークスペースでだけツール一覧に出ます(有効でないときは一覧に出ず、名前を指定して呼んでも Unknown tool になり、料金は発生しません)。AI クライアントはツール一覧を接続したときに読み込むため、動画の生成を有効にした後は、AI クライアントから TAGRU MCP に接続し直してください。従量課金で、カード払いの場合はデポジット(前払い)の残高から支払います。生成には数分以上かかるため、開始と、状態・結果の確認を分けています。

  • video_estimateworkspaces_video_estimate
    ワークスペース: 参加メンバー

    開始せずに上限見積(estimate_jpy。尺を使い切った場合の金額で、実際の請求はこれ以下になることがあります)と、デポジットの要否・残高、使えるモデルの一覧(models)を返します。料金は発生しません。

    主な引数

    • target_seconds(任意・15 / 30 / 60 / 90 / 120。既定は 60)
    • model_id(任意・既定のモデル)
    • resolution(任意・モデルが受け付ける値)
    • sound(任意・使いません。音声は TAGRU が作ります)
    • workspace_id(ワークスペース用のみ・必須)
  • video_generateworkspaces_video_generate
    スコープ: draft.write ワークスペース: 参加メンバー

    実現したいこと(intent)から動画の生成のジョブを作り、ジョブの ID を返します(完成は待ちません。生成は 5 分ほどのうちに TAGRU 側で始まります)。max_jpy には利用者が了承した上限の金額を渡します。上限見積がそれを超えるときは開始せず error.code が video_estimate_exceeds_max になります。開始時に上限見積の全額をデポジットから引き、完成後に差額を戻します。request_id(呼び出し側が動画ごとに新しく作る値。例の値や固定の文字列は使わない)を付けると、時間切れでやり直すときに同じ request_id・同じ引数で呼び直せば、開始済みならそのジョブが返り、二重に開始・課金されません。request_id を付けずに時間切れになったときは開始済みのことがあるので、すぐにやり直さず、ジョブの一覧で作成日時と intent から確かめてください。

    主な引数

    • intent(必須・1000 文字まで)
    • max_jpy(必須・了承した上限の金額(円))
    • target_seconds(任意・15 / 30 / 60 / 90 / 120。既定は 60)
    • model_id / resolution / aspect_ratio(任意・モデルが受け付ける値)
    • sound(任意・使いません。音声は TAGRU が作ります)
    • request_id(任意・やり直しで二重に開始しないための値。8〜128 文字の英数字・-・_)
    • workspace_id(ワークスペース用のみ・必須)
  • video_job_getworkspaces_video_job_get
    ワークスペース: 参加メンバー

    ジョブを 1 件返します。状態(status)・進み具合・上限見積・確定した請求額と、完成した動画の URL(video_url。完成するまでは null)を確認できます。

    主な引数

    • job_id(必須)
    • workspace_id(ワークスペース用のみ・必須)
  • video_job_listworkspaces_video_job_list
    ワークスペース: 参加メンバー

    ジョブを作成日時の新しい順に返します。status で絞り込むか、active_only で進行中のジョブだけにできます。続きは next_cursor を cursor に渡して取得します。

    主な引数

    • status(任意・queued / running / waiting_input / done / error / cancelled)
    • limit(任意・1〜100。既定は 20)
    • cursor(任意)
    • active_only(任意)
    • workspace_id(ワークスペース用のみ・必須)

素材

ロゴや商品写真など、生成で使う素材(ファイル+名称+説明)の登録・確認・名称の変更・分類し直しです。TAGRU・TAGRU Ads の「素材」と同じデータで、個人領域・ワークスペースごとに 20 件まで登録できます。削除は画面から行います(MCP からは削除できません)。

  • asset_createworkspaces_asset_create
    スコープ: draft.write ワークスペース: 参加メンバー

    素材を 1 件登録し、アセット ID と保存先(workspace_id。個人領域は null)を返します。形式は JPEG / PNG / WebP / PDF、1 ファイル 10MB(Base64 にする前)まで。ただしファイルは Base64 の文字列としてツールの呼び出しに入れて送るため、AI クライアントから実際に送れるのは数百 KB 程度までです。大きいファイルは TAGRU の「素材」画面から登録してください。説明は生成時に AI が素材を探す唯一の手がかりなので、何が写っているか(ブランド名・商品名・色・形)と用途(ロゴ・商品・背景など)を書きます。個人用ツールに workspace_id を付けると asset_invalid_input になります(ワークスペースへの登録は workspaces_asset_create を使います)。

    主な引数

    • content(必須・ファイルを Base64 にした文字列)
    • filename(必須・拡張子付き。例: logo.png)
    • name(必須・30 文字まで)
    • description(必須・200 文字まで)
    • workspace_id(ワークスペース用のみ・必須)
  • asset_listworkspaces_asset_list
    ワークスペース: 参加メンバー

    登録済みの素材を新しい順に返します(最大 20 件)。ファイルの中身は含めず、ID・名称・説明・形式・サイズ・保存先のパスと、件数・上限を返します。

    主な引数

    • workspace_id(ワークスペース用のみ・必須)
  • asset_getworkspaces_asset_get
    ワークスペース: 参加メンバー

    素材を ID で 1 件返します。ファイルの中身は含めません。

    主な引数

    • asset_id(必須)
    • workspace_id(ワークスペース用のみ・必須)
  • asset_renameworkspaces_asset_rename
    スコープ: draft.write ワークスペース: 参加メンバー

    素材の名称だけを変更し、変更後の素材を返します。TAGRU の「素材」画面の「名称を変更」と同じ処理で、種類・説明・要点とファイルは変わらず、AI による読み直しもしません。名称は前後の空白を除いて 30 文字までです。変更前の名称は返さないため、変える前に利用者に確かめてください。

    主な引数

    • asset_id(必須)
    • name(必須・30 文字まで)
    • workspace_id(ワークスペース用のみ・必須)
  • asset_reclassifyworkspaces_asset_reclassify
    スコープ: draft.write ワークスペース: 参加メンバー

    未分類(label が null)の素材を、保存済みのファイルで AI に読み直させ、種類・説明・要点を付けます。TAGRU の「素材」画面の「分類し直す」と同じ処理です。呼ぶたびに AI を 1 回使い、AI の利用に費用がかかるため、必要なときだけ呼んでください。分類済みの素材は asset_already_classified(AI は使いません)、AI の分類に失敗したときは asset_classification_failed を返し、素材は未分類のままです。ツールは自動でやり直しません。同じ素材は前回の試行から 5 分たつまで試せず、その間は AI を使わずに asset_reclassify_cooldown を返します(error.retry_after_seconds と文言で、あと何分で試せるかを伝えます)。応答が返らなかったときは、サーバーでは分類が済んでいることがあるため、呼び直す前に asset_get で label を確かめてください。asset_not_found は、その領域に無い ID のほか、保存したファイルが見つからないときにも返ります。

    主な引数

    • asset_id(必須)
    • workspace_id(ワークスペース用のみ・必須)

投稿

予約中の投稿と、投稿済みの投稿を確認するツールです。

  • scheduled_posts_listworkspaces_scheduled_posts_list
    ワークスペース: 参加メンバー

    まだ投稿されていない予約投稿の一覧を返します。

    主な引数

    • workspace_id(ワークスペース用のみ・必須)
  • posted_posts_listworkspaces_posted_posts_list
    ワークスペース: 参加メンバー

    投稿済みの投稿を 9 件ずつ返します。各投稿には発信の柱(pillar_id / pillar_title、分からないときは null)が付きます。続きは、前のページの最後の投稿 ID を start_after に渡して取得します。

    主な引数

    • start_after(任意)
    • workspace_id(ワークスペース用のみ・必須)

戦略・週次計画

TAGRU で設定した運用戦略と、週次の計画・分析を読み取ります。

  • strategy_getworkspaces_strategy_get
    ワークスペース: 参加メンバー

    設定済みの運用戦略と、発信の柱(コンテンツの柱)を返します。

    主な引数

    • workspace_id(ワークスペース用のみ・必須)
  • weekly_plans_listworkspaces_weekly_plans_list
    ワークスペース: 参加メンバー

    週次計画の ID(week_id)の一覧を返します。

    主な引数

    • workspace_id(ワークスペース用のみ・必須)
  • weekly_plans_focus_actions_getworkspaces_weekly_plans_focus_actions_get
    ワークスペース: 参加メンバー

    指定した週の、注力するアクションを返します。

    主な引数

    • week_id(必須)
    • workspace_id(ワークスペース用のみ・必須)
  • weekly_plans_analysis_getworkspaces_weekly_plans_analysis_get
    ワークスペース: 参加メンバー

    指定した週の分析結果を返します。その週に媒体ごとの集計(platform_insights)がある媒体については、指標の数え方(metric_definitions)も付きます。同じ名前でも媒体ごとに数え方が違うため、その媒体の前の週と比べて読みます。aggregates_24h_* が definition_version=post_lifetime_v2 の場合は、TAGRU の成功配信の投稿累計だけを集計します。閲覧・再生数は成立条件が媒体ごとに違うため views_by_platform に媒体別で持ち、views_sum_total は対象が 1 媒体の場合だけ値を持ちます(複数媒体なら null)。X の表示回数は含めません。いいね・コメント数は X を含む既知の 4 媒体の投稿累計を合算します。指標ごとの対象媒体は metric_platforms で確認できます。対象なし・欠測・比較不能は null、保存された数値のゼロは 0 です。ER は分子・分母が同じ対象配信で計測済み、閲覧・再生数が正の場合のみ計算します(X が混じる場合は null)。週の差分は同じ版・対象媒体で両週とも計測済みの場合のみ計算します。24時間ちょうどの値ではなく、保存時点の累計です。版の無い旧集計や posts_24h・time_buckets には定義の違いが残るため、新集計の内訳や比較対象として使いません。

    主な引数

    • week_id(必須)
    • workspace_id(ワークスペース用のみ・必須)

SNS 連携・分析

SNS の連携状況と、分析指標・よく見られた投稿を読み取ります。

  • social_connections_getworkspaces_social_connections_get
    ワークスペース: 参加メンバー

    Instagram・X・TikTok・YouTube・WordPress の連携状況を返します。

    主な引数

    • workspace_id(ワークスペース用のみ・必須)
  • analytics_insights_listworkspaces_analytics_insights_list
    ワークスペース: 参加メンバー

    指定した期間の、アカウント単位の分析指標を返します。

    主な引数

    • platform(必須・instagram / x / tiktok / youtube)
    • start_date / end_date(任意・YYYY-MM-DD。省略時は直近 30 日)
    • workspace_id(ワークスペース用のみ・必須)
  • follower_history_getworkspaces_follower_history_get
    ワークスペース: 参加メンバー

    連携中のアカウントのフォロワー数の推移を、媒体ごとに日付順で返します。アカウントを繋ぎ替えた場合、以前のアカウントの数値は含めません。

    主な引数

    • days(任意・既定 90、最大 365)
    • platform(任意・instagram / x / tiktok / youtube)
    • workspace_id(ワークスペース用のみ・必須)
  • analytics_posts_insights_getworkspaces_analytics_posts_insights_get
    ワークスペース: 参加メンバー

    投稿ごとの反応(エンゲージメント)を新しい順に返します。続きは前のページの最後の ID を start_after に渡して取得します。

    主な引数

    • platform(任意・instagram / x / tiktok / youtube)
    • limit(任意・既定 30、最大 50)
    • start_after(任意)
    • workspace_id(ワークスペース用のみ・必須)
  • instagram_top_posts_getworkspaces_instagram_top_posts_get
    ワークスペース: 参加メンバー

    Instagram の投稿を、反応の多い順に返します。

    主な引数

    • start_date / end_date(任意・YYYY-MM-DD。省略時は直近 30 日)
    • workspace_id(ワークスペース用のみ・必須)
  • x_top_posts_getworkspaces_x_top_posts_get
    ワークスペース: 参加メンバー

    X の投稿を、表示回数(インプレッション)の多い順に返します。

    主な引数

    • start_date / end_date(任意・YYYY-MM-DD。省略時は直近 30 日)
    • workspace_id(ワークスペース用のみ・必須)
  • tiktok_top_videos_getworkspaces_tiktok_top_videos_get
    ワークスペース: 参加メンバー

    TikTok の動画を、再生数の多い順に返します。

    主な引数

    • start_date / end_date(任意・YYYY-MM-DD。省略時は直近 30 日)
    • workspace_id(ワークスペース用のみ・必須)
  • youtube_top_videos_getworkspaces_youtube_top_videos_get
    ワークスペース: 参加メンバー

    YouTube の動画を、再生数の多い順に返します。

    主な引数

    • start_date / end_date(任意・YYYY-MM-DD。省略時は直近 30 日)
    • workspace_id(ワークスペース用のみ・必須)