ContentStudio: Unified Social Media Management Tool

Ping

Responds with pong

Validate Token

Validate API token via /api/v1/me

Fetch Workspaces

Get user workspaces with pagination

Fetch Social Accounts

Get workspace social accounts with optional platform filter and pagination

Fetch Content Categories

Get content categories for a workspace. Use this when user wants to create a content category post. Categories contain pre-configured accounts.

Fetch Posts

List posts in a workspace with optional filters. Each post also returns linkedin_options and approval_workflow ({ workflow_id, workflow_name, status, current_level, total_levels, notes, submitted_at, levels[] }) when set.

Create Post

Create a new post in a workspace. 📅 CURRENT DATE: 2026-09-10 (Thursday) Use this to calculate dates like "tomorrow", "next Sunday", "coming Monday", etc. ⚠️ BEFORE CALLING THIS TOOL - MUST SHOW PREVIEW & GET CONFIRMATION: 1. Show preview with ALL details (workspace, accounts, content, post_type, publish_type, schedule, approval) 2. Ask: "Create this post? (yes/no/change)" 3. ONLY call this tool after user says "yes" ❌ NEVER call without preview and user confirmation! ⚠️ SCHEDULE DATE RULE - C

Update Post

Update an existing post in a workspace (PUT). Sends the SAME body as create_post — resend the full post body plus the post_id to update. ⚠️ STATUS RULE: An update is ONLY allowed when the post status is NOT "published" and NOT "processing". Otherwise the backend returns 422. ✅ APPROVAL — TWO MUTUALLY EXCLUSIVE OPTIONS (pick at most one): A) LEGACY simple approval — approvers, approve_option ("anyone"|"everyone"), approval_notes. B) APPROVAL WORKFLOW (multi-level) — approval_workflow. On UPDATE

Delete Post

Delete a post by ID

Fetch Approval Workflows

List the multi-level approval workflows configured for a workspace. Each workflow: { id, name, is_default, levels: [{ level_number, title, rule: "anyone"|"everyone", members: [{ user_id }] }] }. Use a workflow's id as approval_workflow.workflow_id when attaching it via create_post or update_post.

Approve Post

Approve or reject a single post that is under review with an optional comment.

Fetch Comments

List comments on a post with pagination.

Add Comment

Add a comment or internal note to a post.

List Facebook Text Backgrounds

List the Facebook colored-background presets available for text-only posts. Call this before create_post when the user asks for a "colored background", "red background", "gradient background", etc. on a Facebook post. Pick a preset whose description matches the user's intent and pass its `id` as `facebook_background_id` to create_post. Each preset has: id, type (solid/gradient/image), background_color (CSS value), color (text color), description, category. ⚠️ Backgrounds only apply to plain t

Fetch Optimal Times

Best time to post: analyses the historical engagement of a workspace's connected accounts and returns the highest-scoring posting times, both pooled across accounts (global) and per account (individual). A "slot" is one recommended posting time — a weekday and an hour (e.g. Wednesday 14 = 2 PM on Wednesdays), not a specific date. Slots come back ranked best-first. The slot counts below only decide how many ranked results to return; they never change the analysis. Omit `entities` to analyse every

Fetch Media

List media assets (images, videos, GIFs) from a workspace's media library. Returns a paginated flat list (Laravel paginator metadata + a `data` array). Each media asset uses `id`. Use this to find media IDs/URLs to attach to posts. All filters are optional.

Upload Media

Import a media asset into a workspace's media library from a public URL. This imports media from a publicly accessible URL only — local file upload is NOT supported via MCP. Provide a direct, public URL to an image, video, or GIF. Optionally place it in a specific folder. Returns 201 with the created media asset (uses `id`).

Help

Interactive help and guidance for ContentStudio MCP tools

Discover

Search the long-tail operation map (196 operations) by keyword across the ai-image, ai-video, analytics, connections, inbox, organization, team, workspace-admin toolsets. Returns matching operation names, HTTP methods, descriptions, and parameter summaries. Examples: discover({ query: "facebook top posts" }), discover({ query: "hide comment" }), discover({ toolset: "analytics" }) to browse everything in a toolset. AI image/video generation is available on this endpoint — try discover({ query: "g

Execute Read

Run a READ-ONLY operation from the discover map by name (e.g. an Analytics report). Get the operation name and its param shape from discover first — this refuses write operations. Example: execute_read({ operation: "facebook_analytics_summary", params: { workspace_id, platform_id, start_date, end_date } }).

Execute Write

Run a WRITE operation from the discover map by name (e.g. an Inbox action — reply, hide, tag, merge). Get the operation name and its param shape from discover first — this refuses read-only operations. Destructive operations (discover reports destructive: true) delete or irreversibly change data — confirm with the user before calling those. Example: execute_write({ operation: "inbox_hide_comment", params: { workspace_id, comment_id } }).