ツール一覧

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（ワークスペース用のみ・必須）

投稿

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

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

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

    主な引数

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

    投稿済みの投稿を 9 件ずつ返します。続きは、前のページの最後の投稿 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
    ワークスペース: 参加メンバー

    指定した週の分析結果を返します。

    主な引数

    • 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（ワークスペース用のみ・必須）
  • 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（ワークスペース用のみ・必須）