Find viral posts, outliers, hooks and ads on Instagram, TikTok, YouTube and Facebook, then write.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Use this when the user wants a script, hook list, plan or other text saved to XcutAI. Accepts Markdown; with no canvas named it goes to the user's "From AI apps" canvas. Free. Do not use for calendar posts (use xcut_add_to_calendar).
Markdown text.
Optional note title, e.g. "Week 1 scripts".
Optional. Leave it out unless the user names a canvas: XcutAI then uses their "From AI apps" canvas. Ids come from xcut_list_canvases.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Use this when the user wants a script, hook list, plan or other text saved to XcutAI. Accepts Markdown; with no canvas named it goes to the user's "From AI apps" canvas. Free. Do not use for calendar posts (use xcut_add_to_calendar).
| Argument | Type | Description |
|---|---|---|
| text* | string | Markdown text. |
| title | any | Optional note title, e.g. "Week 1 scripts". |
| canvas_id | any | Optional. Leave it out unless the user names a canvas: XcutAI then uses their "From AI apps" canvas. Ids come from xcut_list_canvases. |
{
"type": "object",
"title": "xcut_add_noteArguments",
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"title": "Text",
"maxLength": 100000,
"minLength": 1,
"description": "Markdown text."
},
"title": {
"anyOf": [
{
"type": "string",
"maxLength": 120
},
{
"type": "null"
}
],
"title": "Title",
"default": null,
"description": "Optional note title, e.g. \"Week 1 scripts\"."
},
"canvas_id": {
"anyOf": [
{
"type": "string",
"pattern": "^[0-9a-fA-F-]{36}$"
},
{
"type": "null"
}
],
"title": "Canvas Id",
"default": null,
"description": "Optional. Leave it out unless the user names a canvas: XcutAI then uses their \"From AI apps\" canvas. Ids come from xcut_list_canvases."
}
}
}Use this when the user wants a planned post saved to their XcutAI content calendar: title, platform, type, date, and optionally caption and hashtags. Saved as a draft unless a status is given. Free. Do not use to publish: XcutAI never posts to social media.
| Argument | Type | Description |
|---|---|---|
| title* | string | Short working title, e.g. "3 myths about retinol". |
| status | string | draft, in_review, approved, scheduled or published. Default draft. Setting it never publishes anything. |
| caption | any | Full caption or script text, if written. |
| hashtags | any | Hashtags without spaces, e.g. ["#skincare", "#retinol"]. Up to 30. |
| platform* | string | Where it will be posted: instagram, facebook, tiktok, youtube or meta (Meta ads). |
| canvas_id | any | Canvas (UUID) the post belongs to. Optional. |
| post_type | string | Format: post, image, video, carousel, reel, story, idea, script or ad. Default post. |
| scheduled_at* | string | ISO date or date-time. |
Use this when the user wants a script scored on its hook, pacing, retention risk and CTA. Free; no sign-in. Output is generic: for work based on the user's own posts, canvases or brand, use the signed-in XcutAI tools. Do not use for writing unrelated to social media or marketing content.
| Argument | Type | Description |
|---|---|---|
| script* | string | The full script to score (at least 50 characters). |
{
"type": "object",
"title": "xcut_analyze_scriptArguments",
"required": [
"script"
],
"properties": {
"script": {
"type": "string",
"title": "Script",
"maxLength": 3000,
"minLength": 50,
"description": "The full script to score (at least 50 characters)."
}
}
}Use this when the user wants a consistency check across 3 to 10 of their past titles or captions. Free; no sign-in. Output is generic: for work based on the user's own posts, canvases or brand, use the signed-in XcutAI tools. Do not use for writing unrelated to social media or marketing content.
| Argument | Type | Description |
|---|---|---|
| platform | string | Platform they were posted on, e.g. "instagram"; "general" if mixed. |
| titles_or_captions* | array | 3 to 10 past titles or captions, one per item. |
{
"type": "object",
"title": "xcut_audit_contentArguments",
"required": [
"titles_or_captions"
],
"properties": {
"platform": {
"type": "string",
"title": "Platform",
"default": "general",
"maxLength": 50,
"description": "Platform they were posted on, e.g. \"instagram\"; \"general\" if mixed."
},
"titles_or_captions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 3000
},
"title": "Titles Or Captions",
"maxItems": 10,
"minItems": 3,
"description": "3 to 10 past titles or captions, one per item."
}
}
}Use this when the user wants to know whether a niche is viable before committing to it. Free; no sign-in. Output is generic: for work based on the user's own posts, canvases or brand, use the signed-in XcutAI tools. Do not use for writing unrelated to social media or marketing content.
| Argument | Type | Description |
|---|---|---|
| niche_description* | string | The niche to check, described in a sentence or two. |
{
"type": "object",
"title": "xcut_check_nicheArguments",
"required": [
"niche_description"
],
"properties": {
"niche_description": {
"type": "string",
"title": "Niche Description",
"maxLength": 3000,
"minLength": 10,
"description": "The niche to check, described in a sentence or two."
}
}
}Use this when the user wants content gaps versus named competitors in their niche. Free; no sign-in. Output is generic: for work based on the user's own posts, canvases or brand, use the signed-in XcutAI tools. Do not use for writing unrelated to social media or marketing content.
| Argument | Type | Description |
|---|---|---|
| niche* | string | The niche to compare in. |
| competitor_names* | array | 1 to 5 competitor names or handles. |
{
"type": "object",
"title": "xcut_competitor_gapsArguments",
"required": [
"niche",
"competitor_names"
],
"properties": {
"niche": {
"type": "string",
"title": "Niche",
"maxLength": 100,
"minLength": 2,
"description": "The niche to compare in."
},
"competitor_names": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"title": "Competitor Names",
"maxItems": 5,
"minItems": 1,
"description": "1 to 5 competitor names or handles."
}
}
}Use this when the user asks for a new, separate XcutAI canvas for a project, client or campaign. Returns its id. Free. Do not use just to import or write: those tools pick a canvas automatically.
| Argument | Type | Description |
|---|---|---|
| name* | string | Name for the new canvas, e.g. "Q4 launch" or "Client: Glow Skincare". |
{
"type": "object",
"title": "xcut_create_canvasArguments",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"title": "Name",
"maxLength": 120,
"minLength": 1,
"description": "Name for the new canvas, e.g. \"Q4 launch\" or \"Client: Glow Skincare\"."
}
}
}Use this when the user explicitly asks to remove a post from their XcutAI content calendar. Do not use to reschedule or edit (use xcut_update_calendar_post).
| Argument | Type | Description |
|---|---|---|
| post_id* | string | Id (UUID) of the calendar post to remove, from xcut_list_calendar. |
{
"type": "object",
"title": "xcut_delete_calendar_postArguments",
"required": [
"post_id"
],
"properties": {
"post_id": {
"type": "string",
"title": "Post Id",
"pattern": "^[0-9a-fA-F-]{36}$",
"description": "Id (UUID) of the calendar post to remove, from xcut_list_calendar."
}
}
}Use this when the user asks to remove a saved brand memory fact from XcutAI. Needs the fact's id from xcut_get_brand. Do not use to change a fact (use xcut_update_memory).
| Argument | Type | Description |
|---|---|---|
| canvas_id* | string | Canvas id (a UUID) from xcut_list_canvases. |
| memory_id* | string | Id of the memory fact to remove, from xcut_get_brand. |
{
"type": "object",
"title": "xcut_delete_memoryArguments",
"required": [
"canvas_id",
"memory_id"
],
"properties": {
"canvas_id": {
"type": "string",
"title": "Canvas Id",
"pattern": "^[0-9a-fA-F-]{36}$",
"description": "Canvas id (a UUID) from xcut_list_canvases."
},
"memory_id": {
"type": "string",
"title": "Memory Id",
"maxLength": 100,
"minLength": 1,
"description": "Id of the memory fact to remove, from xcut_get_brand."
}
}
}Use this when the user wants hooks, opening lines or first sentences for a post, Reel, TikTok, Short, YouTube video or ad. Returns proven hook templates matched to the topic, from XcutAI's library of about 1,000 hooks taken from posts that performed, each with slots for the user's subject. The library and topic search are in English. Free; no sign-in. Do not use for formats, script structures or platform facts (use xcut_get_playbook) or for a finished caption (use xcut_write_caption).
| Argument | Type | Description |
|---|---|---|
| limit | integer | How many templates (default 8). |
| topic* | string | What the post is about, in English. e.g. 'pricing mistakes for small bakeries' |
| category | any | Optional hook family to restrict to. |
{
"type": "object",
"title": "xcut_find_hooksArguments",
"required": [
"topic"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 8,
"maximum": 15,
"minimum": 1,
"description": "How many templates (default 8)."
},
"topic": {
"type": "string",
"title": "Topic",
"maxLength": 200,
"minLength": 2,
"description": "What the post is about, in English. e.g. 'pricing mistakes for small bakeries'"
},
"category": {
"anyOf": [
{
"enum": [
"EDUCATIONAL",
"COMPARISON",
"MYTH BUSTING",
"STORYTELLING",
"RANDOM",
"AUTHORITY",
"DAY IN THE LIFE"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Category",
"default": null,
"description": "Optional hook family to restrict to."
}
}
}Use this when the user asks which of a creator's, competitor's or their own posts performed best or beat the account's normal, or what works for an account before writing. Scores the latest 20, 30, 50 or 100 posts against that account's own median and says by how much each beat it. About 1-2 credits for 30 posts. Longer runs return a `job_id` for xcut_get_job. Do not use for a full metrics table (use xcut_profile_analytics) or for a topic across many accounts (use xcut_search_viral).
| Argument | Type | Description |
|---|---|---|
| posts | integer | How many recent posts to analyse: 20, 30, 50 or 100. Default 30. |
| profile* | string | Profile link or @handle. |
| platform* | string | instagram, tiktok, youtube or facebook. |
| canvas_id | any | Canvas (UUID) that owns the thumbnails. Optional. The results are returned here, not placed on the canvas. |
{
"type": "object",
"title": "xcut_find_outliersArguments",
"required": [
"profile",
"platform"
],
"properties": {
"posts": {
"enum": [
20,
30,
50,
100
],
"type": "integer",
"title": "Posts",
"default": 30,
"description": "How many recent posts to analyse: 20, 30, 50 or 100. Default 30."
},
"profile": {
"type": "string",
"title": "Profile",
"maxLength": 500,
"minLength": 1,
"description": "Profile link or @handle."
},
"platform": {
"enum": [
"instagram",
"tiktok",
"youtube",
"facebook"
],
"type": "string",
"title": "Platform",
"description": "instagram, tiktok, youtube or facebook."
},
"canvas_id": {
"anyOf": [
{
"type": "string",
"pattern": "^[0-9a-fA-F-]{36}$"
},
{
"type": "null"
}
],
"title": "Canvas Id",
"default": null,
"description": "Canvas (UUID) that owns the thumbnails. Optional. The results are returned here, not placed on the canvas."
}
}
}Use this when the user wants a social media image made or edited: post graphic, carousel slide, thumbnail or ad visual, from a prompt and optional reference image links. Needs the Starter plan or higher; about 14 credits per image. Do not use for images unrelated to the user's content or marketing.
| Argument | Type | Description |
|---|---|---|
| prompt* | string | What to make or change, e.g. "bold carousel cover: '3 retinol myths', pink gradient, large serif headline". |
| aspect_ratio | string | 1:1, 4:5, 9:16, 16:9, 3:4 or 4:3. Default 1:1 (use 4:5 for Instagram feed, 9:16 for Reels and Stories). |
| reference_image_urls | any | Up to 5 public https image links to guide style or to edit. |
{
"type": "object",
"title": "xcut_generate_imageArguments",
"required": [
"prompt"
],
"properties": {
"prompt": {
"type": "string",
"title": "Prompt",
"maxLength": 8000,
"minLength": 3,
"description": "What to make or change, e.g. \"bold carousel cover: '3 retinol myths', pink gradient, large serif headline\"."
},
"aspect_ratio": {
"enum": [
"1:1",
"4:5",
"9:16",
"16:9",
"3:4",
"4:3"
],
"type": "string",
"title": "Aspect Ratio",
"default": "1:1",
"description": "1:1, 4:5, 9:16, 16:9, 3:4 or 4:3. Default 1:1 (use 4:5 for Instagram feed, 9:16 for Reels and Stories)."
},
"reference_image_urls": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"pattern": "^https://",
"maxLength": 2000
},
"maxItems": 5
},
{
"type": "null"
}
],
"title": "Reference Image Urls",
"default": null,
"description": "Up to 5 public https image links to guide style or to edit."
}
}
}Use this when the user asks about their XcutAI plan, credit balance, monthly allowance, next refill date or trial, or before starting an import or analysis that costs credits. Free. Do not use for usage history (that is in XcutAI Settings, not available here).
No arguments.
{
"type": "object",
"title": "xcut_get_accountArguments",
"properties": {}
}Use this when you are about to write for the user's brand and need its voice, niche, audience and offer, or the user asks what XcutAI knows about their brand. Returns the canvas's brand profile and saved memory facts with ids. Free. Do not use for public creators the user does not own (use xcut_find_outliers or xcut_search_viral).
| Argument | Type | Description |
|---|---|---|
| canvas_id* | string | Canvas id (a UUID) from xcut_list_canvases. The brand attached to this canvas is returned. |
{
"type": "object",
"title": "xcut_get_brandArguments",
"required": [
"canvas_id"
],
"properties": {
"canvas_id": {
"type": "string",
"title": "Canvas Id",
"pattern": "^[0-9a-fA-F-]{36}$",
"description": "Canvas id (a UUID) from xcut_list_canvases. The brand attached to this canvas is returned."
}
}
}Use this when the user asks what is breaking out or trending in their own niche right now: XcutAI's breakout alerts from the accounts on their watchlist, plus trending keywords, from the last scan. Free. Do not use for a topic or creator outside their watchlist (use xcut_search_viral).
| Argument | Type | Description |
|---|---|---|
| limit | integer | Most breakout alerts to return, 1-50. Default 20. |
{
"type": "object",
"title": "xcut_get_breakoutsArguments",
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 20,
"maximum": 50,
"minimum": 1,
"description": "Most breakout alerts to return, 1-50. Default 20."
}
}
}Use this when the user asks what is on one of their XcutAI canvases: its items (imported posts, notes, chats, groups, Meta ads, analytics tables, websites, media) with ids, counts by type and short previews. Filter with `item_type`; paginate with `offset`. Free. Do not use to read an item in full (use xcut_get_content).
| Argument | Type | Description |
|---|---|---|
| limit | integer | Most items to return, 1-100. Default 50. |
| offset | integer | Items to skip, for paging through a large canvas. Default 0. |
| canvas_id* | string | Canvas id (a UUID) from xcut_list_canvases. |
| item_type | any | Only list this kind of item. |
{
"type": "object",
"title": "xcut_get_canvasArguments",
"required": [
"canvas_id"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 50,
"maximum": 100,
"minimum": 1,
"description": "Most items to return, 1-100. Default 50."
},
"offset": {
"type": "integer",
"title": "Offset",
"default": 0,
"maximum": 10000,
"minimum": 0,
"description": "Items to skip, for paging through a large canvas. Default 0."
},
"canvas_id": {
"type": "string",
"title": "Canvas Id",
"pattern": "^[0-9a-fA-F-]{36}$",
"description": "Canvas id (a UUID) from xcut_list_canvases."
},
"item_type": {
"anyOf": [
{
"enum": [
"post",
"note",
"chat",
"group",
"ad",
"analytics",
"website",
"media"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Item Type",
"default": null,
"description": "Only list this kind of item."
}
}
}Use this when you need the full content of an item on the user's XcutAI canvas, by canvas id and item id (from xcut_get_canvas): a post or video's transcript and stats, a note, a chat's messages (paginate with `before`), a website's text, an analytics table, a Meta ad, or a group's contents. Free. Do not use to list a canvas (use xcut_get_canvas).
| Argument | Type | Description |
|---|---|---|
| before | any | Chats only: message id to page back from. |
| item_id* | string | Item id from xcut_get_canvas, or the `item_id` an import returned. |
| canvas_id* | string | Canvas id (a UUID) from xcut_list_canvases. |
{
"type": "object",
"title": "xcut_get_contentArguments",
"required": [
"canvas_id",
"item_id"
],
"properties": {
"before": {
"anyOf": [
{
"type": "string",
"maxLength": 100
},
{
"type": "null"
}
],
"title": "Before",
"default": null,
"description": "Chats only: message id to page back from."
},
"item_id": {
"type": "string",
"title": "Item Id",
"maxLength": 100,
"minLength": 3,
"description": "Item id from xcut_get_canvas, or the `item_id` an import returned."
},
"canvas_id": {
"type": "string",
"title": "Canvas Id",
"pattern": "^[0-9a-fA-F-]{36}$",
"description": "Canvas id (a UUID) from xcut_list_canvases."
}
}
}Use this when another XcutAI tool returned a `job_id`: it returns status `running` with a suggested wait, or the finished result (outlier analysis, profile analytics, imports with their transcript, agent replies). Free. Do not use without a `job_id` from an XcutAI tool.
| Argument | Type | Description |
|---|---|---|
| job_id* | string | The `job_id` an XcutAI tool returned, unchanged. |
{
"type": "object",
"title": "xcut_get_jobArguments",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"title": "Job Id",
"maxLength": 4096,
"minLength": 1,
"description": "The `job_id` an XcutAI tool returned, unchanged."
}
}
}Use this when the user asks how to structure a Reel, TikTok, Short, YouTube video, carousel, caption, content plan, offer or ad, or how a platform's algorithm, hashtags or profile setup work. Call it before writing so the answer follows formats that performed. Returns a short summary of each matching video format, storytelling or retention principle, hook family, paid-ad framework or platform fact. Free; no sign-in. Describe the goal in plain English with platform and format. Do not use for hook templates (use xcut_find_hooks).
| Argument | Type | Description |
|---|---|---|
| goal* | string | What is being made or decided, in English, with platform and format. e.g. 'instagram carousel that gets saved', 'tutorial reel structure', 'how many hashtags on instagram' |
| kind | any | Optional: structure (formats), principle, hook_type, ad_framework or platform_fact. |
| limit | integer | How many entries (default 3). |
{
"type": "object",
"title": "xcut_get_playbookArguments",
"required": [
"goal"
],
"properties": {
"goal": {
"type": "string",
"title": "Goal",
"maxLength": 300,
"minLength": 3,
"description": "What is being made or decided, in English, with platform and format. e.g. 'instagram carousel that gets saved', 'tutorial reel structure', 'how many hashtags on instagram'"
},
"kind": {
"anyOf": [
{
"enum": [
"structure",
"principle",
"hook_type",
"ad_framework",
"platform_fact"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Kind",
"default": null,
"description": "Optional: structure (formats), principle, hook_type, ad_framework or platform_fact."
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 3,
"maximum": 4,
"minimum": 1,
"description": "How many entries (default 3)."
}
}
}Use this when the user wants 10 new hook variations written for their niche and topic on YouTube, TikTok or Instagram. For proven hook templates from posts that performed, use xcut_find_hooks. Free; no sign-in. Output is generic: for work based on the user's own posts, canvases or brand, use the signed-in XcutAI tools. Do not use for writing unrelated to social media or marketing content.
| Argument | Type | Description |
|---|---|---|
| niche* | string | The creator's niche, e.g. "fitness for busy moms". |
| topic* | string | What the post is about. |
| platform* | string | Where the hooks will be used. |
{
"type": "object",
"title": "xcut_hook_ideasArguments",
"required": [
"platform",
"niche",
"topic"
],
"properties": {
"niche": {
"type": "string",
"title": "Niche",
"maxLength": 100,
"minLength": 2,
"description": "The creator's niche, e.g. \"fitness for busy moms\"."
},
"topic": {
"type": "string",
"title": "Topic",
"maxLength": 300,
"minLength": 2,
"description": "What the post is about."
},
"platform": {
"enum": [
"youtube",
"tiktok",
"instagram"
],
"type": "string",
"title": "Platform",
"description": "Where the hooks will be used."
}
}
}Use this when the user shares a Meta Ad Library link (facebook.com/ads/library) and wants the ad's copy, media and video transcript to study or remix. Holds up to 18 credits and charges the real cost. May return a `job_id` for xcut_get_job. Do not use for organic Facebook posts (use xcut_import_post).
| Argument | Type | Description |
|---|---|---|
| url* | string | Meta Ad Library link (facebook.com/ads/library/?id=…). |
| canvas_id | any | Optional. Leave it out unless the user names a canvas: XcutAI then uses their "From AI apps" canvas. Ids come from xcut_list_canvases. |
{
"type": "object",
"title": "xcut_import_meta_adArguments",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "Url",
"maxLength": 2048,
"minLength": 10,
"description": "Meta Ad Library link (facebook.com/ads/library/?id=…)."
},
"canvas_id": {
"anyOf": [
{
"type": "string",
"pattern": "^[0-9a-fA-F-]{36}$"
},
{
"type": "null"
}
],
"title": "Canvas Id",
"default": null,
"description": "Optional. Leave it out unless the user names a canvas: XcutAI then uses their \"From AI apps\" canvas. Ids come from xcut_list_canvases."
}
}
}Use this when the user shares an Instagram, TikTok, YouTube or Facebook post or video link and wants its transcript, a breakdown of why it worked, or their own version of it. XcutAI transcribes the video and reads the caption, visuals and stats. Don't ask which canvas: with none named it goes to the user's "From AI apps" canvas. A fraction of a credit plus transcription (1-2 credits for a short video). Returns a `job_id`; xcut_get_job returns the transcript when done. Do not use for website links (use xcut_import_website) or Meta Ad Library links (use xcut_import_meta_ad).
| Argument | Type | Description |
|---|---|---|
| url* | string | Post or video link. |
| canvas_id | any | Optional. Leave it out unless the user names a canvas: XcutAI then uses their "From AI apps" canvas. Ids come from xcut_list_canvases. |
{
"type": "object",
"title": "xcut_import_postArguments",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "Url",
"maxLength": 2048,
"minLength": 10,
"description": "Post or video link."
},
"canvas_id": {
"anyOf": [
{
"type": "string",
"pattern": "^[0-9a-fA-F-]{36}$"
},
{
"type": "null"
}
],
"title": "Canvas Id",
"default": null,
"description": "Optional. Leave it out unless the user names a canvas: XcutAI then uses their \"From AI apps\" canvas. Ids come from xcut_list_canvases."
}
}
}Use this when the user wants to study a creator's or brand's recent posts in depth (Instagram, TikTok, YouTube or Facebook): it adds them to a canvas as a group and transcribes and analyses each. About 1-15 credits plus transcription. Returns a `job_id` while the profile is read. Do not use just to rank posts (use xcut_find_outliers).
| Argument | Type | Description |
|---|---|---|
| posts | integer | How many recent posts (default 6). |
| profile* | string | Profile link or @handle. |
| platform* | string | instagram, tiktok, youtube or facebook. |
| canvas_id | any | Optional. Leave it out unless the user names a canvas: XcutAI then uses their "From AI apps" canvas. Ids come from xcut_list_canvases. |
{
"type": "object",
"title": "xcut_import_profileArguments",
"required": [
"profile",
"platform"
],
"properties": {
"posts": {
"type": "integer",
"title": "Posts",
"default": 6,
"maximum": 20,
"minimum": 1,
"description": "How many recent posts (default 6)."
},
"profile": {
"type": "string",
"title": "Profile",
"maxLength": 500,
"minLength": 1,
"description": "Profile link or @handle."
},
"platform": {
"enum": [
"instagram",
"tiktok",
"youtube",
"facebook"
],
"type": "string",
"title": "Platform",
"description": "instagram, tiktok, youtube or facebook."
},
"canvas_id": {
"anyOf": [
{
"type": "string",
"pattern": "^[0-9a-fA-F-]{36}$"
},
{
"type": "null"
}
],
"title": "Canvas Id",
"default": null,
"description": "Optional. Leave it out unless the user names a canvas: XcutAI then uses their \"From AI apps\" canvas. Ids come from xcut_list_canvases."
}
}
}Use this when the user shares a web page (product page, landing page, article) to use as context for writing their content. XcutAI reads the page and stores its text on a canvas. Up to about 3 credits. Returns a short preview. Do not use for social media post links (use xcut_import_post).
| Argument | Type | Description |
|---|---|---|
| url* | string | Page link. |
| canvas_id | any | Optional. Leave it out unless the user names a canvas: XcutAI then uses their "From AI apps" canvas. Ids come from xcut_list_canvases. |
{
"type": "object",
"title": "xcut_import_websiteArguments",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "Url",
"maxLength": 2048,
"minLength": 4,
"description": "Page link."
},
"canvas_id": {
"anyOf": [
{
"type": "string",
"pattern": "^[0-9a-fA-F-]{36}$"
},
{
"type": "null"
}
],
"title": "Canvas Id",
"default": null,
"description": "Optional. Leave it out unless the user names a canvas: XcutAI then uses their \"From AI apps\" canvas. Ids come from xcut_list_canvases."
}
}
}Use this when the user asks what content is planned or scheduled: posts on their XcutAI content calendar between two dates, optionally for one canvas, with status (draft, in review, approved, scheduled, published). Free. Do not use for posts already live on social media (use xcut_profile_analytics).
| Argument | Type | Description |
|---|---|---|
| end | any | ISO date, e.g. 2026-10-31. |
| limit | integer | Most posts to return, 1-200. Default 60. |
| start | any | ISO date, e.g. 2026-10-01. |
| canvas_id | any | Only posts planned for this canvas (UUID). Omit for all canvases. |
{
"type": "object",
"title": "xcut_list_calendarArguments",
"properties": {
"end": {
"anyOf": [
{
"type": "string",
"maxLength": 64
},
{
"type": "null"
}
],
"title": "End",
"default": null,
"description": "ISO date, e.g. 2026-10-31."
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 60,
"maximum": 200,
"minimum": 1,
"description": "Most posts to return, 1-200. Default 60."
},
"start": {
"anyOf": [
{
"type": "string",
"maxLength": 64
},
{
"type": "null"
}
],
"title": "Start",
"default": null,
"description": "ISO date, e.g. 2026-10-01."
},
"canvas_id": {
"anyOf": [
{
"type": "string",
"pattern": "^[0-9a-fA-F-]{36}$"
},
{
"type": "null"
}
],
"title": "Canvas Id",
"default": null,
"description": "Only posts planned for this canvas (UUID). Omit for all canvases."
}
}
}Use this when you need a canvas id or the user asks what XcutAI canvases (projects) they have, including ones shared with them, newest first. Free. Do not call it just to import a post or write: those tools use the user's "From AI apps" canvas when no canvas is named.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Most canvases to return, 1-100. Default 30. |
| include_shared | boolean | Also list canvases shared with the user. |
{
"type": "object",
"title": "xcut_list_canvasesArguments",
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 30,
"maximum": 100,
"minimum": 1,
"description": "Most canvases to return, 1-100. Default 30."
},
"include_shared": {
"type": "boolean",
"title": "Include Shared",
"default": true,
"description": "Also list canvases shared with the user."
}
}
}Use this when the user wants a posting plan drafted from a niche, posting frequency and content pillars. It is a text plan only; to put posts on the user's XcutAI calendar use xcut_add_to_calendar. Free; no sign-in. Output is generic: for work based on the user's own posts, canvases or brand, use the signed-in XcutAI tools. Do not use for writing unrelated to social media or marketing content.
| Argument | Type | Description |
|---|---|---|
| niche* | string | The creator's niche. |
| platform* | string | Which platform the plan is for. |
| content_pillars* | array | 1 to 5 themes the account posts about. |
| posting_frequency* | string | e.g. '3x/week', '1x/day' |
{
"type": "object",
"title": "xcut_posting_planArguments",
"required": [
"niche",
"platform",
"posting_frequency",
"content_pillars"
],
"properties": {
"niche": {
"type": "string",
"title": "Niche",
"maxLength": 100,
"minLength": 2,
"description": "The creator's niche."
},
"platform": {
"enum": [
"instagram",
"tiktok",
"youtube",
"linkedin"
],
"type": "string",
"title": "Platform",
"description": "Which platform the plan is for."
},
"content_pillars": {
"type": "array",
"items": {
"type": "string",
"maxLength": 3000
},
"title": "Content Pillars",
"maxItems": 5,
"minItems": 1,
"description": "1 to 5 themes the account posts about."
},
"posting_frequency": {
"type": "string",
"title": "Posting Frequency",
"pattern": "^\\d+x/(day|week|month)$",
"description": "e.g. '3x/week', '1x/day'"
}
}
}Use this when the user wants an account's per-post metrics (views, likes, comments, shares, engagement) over the last N posts or days, for a performance review or to compare accounts on Instagram, TikTok, YouTube or Facebook. Credit cost depends on platform and post count. Longer runs return a `job_id` for xcut_get_job. Do not use to find standout posts (use xcut_find_outliers).
| Argument | Type | Description |
|---|---|---|
| days | any | Or: posts from the last N days. |
| posts | any | Last N posts (default 20). |
| profile* | string | Profile link or @handle. |
| platform* | string | instagram, tiktok, youtube or facebook. |
| canvas_id | any | Canvas (UUID) that owns the thumbnails. Optional. The table is returned here, not placed on the canvas. |
{
"type": "object",
"title": "xcut_profile_analyticsArguments",
"required": [
"profile",
"platform"
],
"properties": {
"days": {
"anyOf": [
{
"type": "integer",
"maximum": 3650,
"minimum": 1
},
{
"type": "null"
}
],
"title": "Days",
"default": null,
"description": "Or: posts from the last N days."
},
"posts": {
"anyOf": [
{
"type": "integer",
"maximum": 50,
"minimum": 1
},
{
"type": "null"
}
],
"title": "Posts",
"default": null,
"description": "Last N posts (default 20)."
},
"profile": {
"type": "string",
"title": "Profile",
"maxLength": 500,
"minLength": 1,
"description": "Profile link or @handle."
},
"platform": {
"enum": [
"instagram",
"tiktok",
"youtube",
"facebook"
],
"type": "string",
"title": "Platform",
"description": "instagram, tiktok, youtube or facebook."
},
"canvas_id": {
"anyOf": [
{
"type": "string",
"pattern": "^[0-9a-fA-F-]{36}$"
},
{
"type": "null"
}
],
"title": "Canvas Id",
"default": null,
"description": "Canvas (UUID) that owns the thumbnails. Optional. The table is returned here, not placed on the canvas."
}
}
}Use this when the user wants one piece of content turned into TikTok, Reel, LinkedIn, X and email angles. Free; no sign-in. Output is generic: for work based on the user's own posts, canvases or brand, use the signed-in XcutAI tools. Do not use for writing unrelated to social media or marketing content.
| Argument | Type | Description |
|---|---|---|
| title* | string | Title of the piece to repurpose. |
| description | any | What the piece covers, optional but gives better angles. |
{
"type": "object",
"title": "xcut_repurpose_contentArguments",
"required": [
"title"
],
"properties": {
"title": {
"type": "string",
"title": "Title",
"maxLength": 300,
"minLength": 5,
"description": "Title of the piece to repurpose."
},
"description": {
"anyOf": [
{
"type": "string",
"maxLength": 3000
},
{
"type": "null"
}
],
"title": "Description",
"default": null,
"description": "What the piece covers, optional but gives better angles."
}
}
}Use this when the user wants their profile bio rewritten for Instagram, YouTube, TikTok, X or LinkedIn. Free; no sign-in. Output is generic: for work based on the user's own posts, canvases or brand, use the signed-in XcutAI tools. Do not use for writing unrelated to social media or marketing content.
| Argument | Type | Description |
|---|---|---|
| niche | any | The creator's niche, if not obvious from the bio. |
| platform* | string | Which profile the bio is for. |
| current_bio* | string | The bio as it reads today. |
{
"type": "object",
"title": "xcut_rewrite_bioArguments",
"required": [
"platform",
"current_bio"
],
"properties": {
"niche": {
"anyOf": [
{
"type": "string",
"maxLength": 100
},
{
"type": "null"
}
],
"title": "Niche",
"default": null,
"description": "The creator's niche, if not obvious from the bio."
},
"platform": {
"enum": [
"instagram",
"youtube",
"tiktok",
"twitter",
"linkedin"
],
"type": "string",
"title": "Platform",
"description": "Which profile the bio is for."
},
"current_bio": {
"type": "string",
"title": "Current Bio",
"maxLength": 500,
"minLength": 5,
"description": "The bio as it reads today."
}
}
}Use this when the user wants a ready-made content deliverable from what is on their canvas: a month or week content plan, 25 hooks, 3 scripts, breakout remix, competitor teardown or benchmark, prospect audit, ad-angle gap map, ad creatives, carousel or thumbnail concepts. Token-billed (a month plan is roughly 60-90 credits). Longer runs return a `job_id`. Do not use for a single custom request (use xcut_write_content).
| Argument | Type | Description |
|---|---|---|
| days | any | Plan length, for month/week plans. |
| notes | any | Extra instructions from the user. |
| platform | any | The platform to write for, when the playbook follows one. |
| playbook* | string | month or week (content plan), hooks (25 hooks), scripts (3 scripts), remix (breakout remix), teardown, benchmark, audit (prospect audit), angles (ad-angle gap map), adcreatives, carousel or thumbnails. |
| canvas_id | any | Optional. Leave it out unless the user names a canvas: XcutAI then uses their "From AI apps" canvas, where imports also land. Ids come from xcut_list_canvases. |
{
"type": "object",
"title": "xcut_run_playbookArguments",
"required": [
"playbook"
],
"properties": {
"days": {
"anyOf": [
{
"type": "integer",
"maximum": 120,
"minimum": 3
},
{
"type": "null"
}
],
"title": "Days",
"default": null,
"description": "Plan length, for month/week plans."
},
"notes": {
"anyOf": [
{
"type": "string",
"maxLength": 4000
},
{
"type": "null"
}
],
"title": "Notes",
"default": null,
"description": "Extra instructions from the user."
},
"platform": {
"anyOf": [
{
"enum": [
"instagram",
"tiktok",
"youtube",
"facebook"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Platform",
"default": null,
"description": "The platform to write for, when the playbook follows one."
},
"playbook": {
"enum": [
"remix",
"angles",
"benchmark",
"audit",
"month",
"week",
"hooks",
"teardown",
"scripts",
"adcreatives",
"carousel",
"thumbnails"
],
"type": "string",
"title": "Playbook",
"description": "month or week (content plan), hooks (25 hooks), scripts (3 scripts), remix (breakout remix), teardown, benchmark, audit (prospect audit), angles (ad-angle gap map), adcreatives, carousel or thumbnails."
},
"canvas_id": {
"anyOf": [
{
"type": "string",
"pattern": "^[0-9a-fA-F-]{36}$"
},
{
"type": "null"
}
],
"title": "Canvas Id",
"default": null,
"description": "Optional. Leave it out unless the user names a canvas: XcutAI then uses their \"From AI apps\" canvas, where imports also land. Ids come from xcut_list_canvases."
}
}
}Use this when the user states a lasting fact about their brand (voice, audience, offer, constraint, posting schedule) so every XcutAI agent uses it from now on. Adds a new fact; never changes or removes one. Free. Do not use to change an existing fact (use xcut_update_memory) or for one-off instructions that apply only to the current request.
| Argument | Type | Description |
|---|---|---|
| text* | string | The fact, in one or two sentences. |
| category | string | What kind of fact it is. |
| canvas_id* | string | Canvas id (a UUID) from xcut_list_canvases. The fact is saved to this canvas's brand. |
{
"type": "object",
"title": "xcut_save_memoryArguments",
"required": [
"canvas_id",
"text"
],
"properties": {
"text": {
"type": "string",
"title": "Text",
"maxLength": 2000,
"minLength": 2,
"description": "The fact, in one or two sentences."
},
"category": {
"enum": [
"subject_type",
"brand_name",
"niche",
"brand_voice",
"language",
"visual_style",
"audience",
"content_format",
"content_pillars",
"hook_patterns",
"cta_style",
"kpi_focus",
"platform",
"posting_schedule",
"offer",
"competitors",
"constraint",
"content_preference",
"fact",
"other"
],
"type": "string",
"title": "Category",
"default": "fact",
"description": "What kind of fact it is."
},
"canvas_id": {
"type": "string",
"title": "Canvas Id",
"pattern": "^[0-9a-fA-F-]{36}$",
"description": "Canvas id (a UUID) from xcut_list_canvases. The fact is saved to this canvas's brand."
}
}
}Use this when the user wants fresh breakouts now instead of waiting for the next scheduled scan. Rescans the accounts on their XcutAI watchlist; allowed once an hour; about 1 credit or less. Set `estimate` to true to get the cost without scanning. Do not use to read the latest results (use xcut_get_breakouts).
| Argument | Type | Description |
|---|---|---|
| estimate | boolean | true returns the credit cost without scanning. Default false. |
{
"type": "object",
"title": "xcut_scan_watchlistArguments",
"properties": {
"estimate": {
"type": "boolean",
"title": "Estimate",
"default": false,
"description": "true returns the credit cost without scanning. Default false."
}
}
}Use this when the user asks what is going viral, trending or performing right now on Instagram, TikTok, YouTube or Facebook for a topic or niche, what a creator posts that works, or what ads run in the Meta Ad Library. `mode` is keyword (a topic) or profile (an account). Returns posts with views, engagement, links and captions, plus `next_cursor` for more. A fraction of a credit per page (cached pages free). Do not use for general web or news search, or for one profile's outliers versus its own normal (use xcut_find_outliers).
| Argument | Type | Description |
|---|---|---|
| mode | string | keyword to search a topic (e.g. "meal prep"), or profile to see an account's top posts (query = @handle). Default keyword. Facebook supports profile only. |
| limit | integer | Posts per page, 1-30. Default 15. |
| query* | string | A topic, or a handle when mode is profile. |
| cursor | any | next_cursor from the previous page. |
| platform* | string | instagram, tiktok, youtube, facebook, or meta_ads for the Meta Ad Library. |
{
"type": "object",
"title": "xcut_search_viralArguments",
"required": [
"platform",
"query"
],
"properties": {
"mode": {
"enum": [
"keyword",
"profile"
],
"type": "string",
"title": "Mode",
"default": "keyword",
"description": "keyword to search a topic (e.g. \"meal prep\"), or profile to see an account's top posts (query = @handle). Default keyword. Facebook supports profile only."
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 15,
"maximum": 30,
"minimum": 1,
"description": "Posts per page, 1-30. Default 15."
},
"query": {
"type": "string",
"title": "Query",
"maxLength": 200,
"minLength": 2,
"description": "A topic, or a handle when mode is profile."
},
"cursor": {
"anyOf": [
{
"type": "string",
"maxLength": 2000
},
{
"type": "null"
}
],
"title": "Cursor",
"default": null,
"description": "next_cursor from the previous page."
},
"platform": {
"enum": [
"instagram",
"tiktok",
"youtube",
"facebook",
"meta_ads"
],
"type": "string",
"title": "Platform",
"description": "instagram, tiktok, youtube, facebook, or meta_ads for the Meta Ad Library."
}
}
}Use this when the user wants to change a post on their XcutAI calendar: date, caption, hashtags, title, type or status (for example mark it approved). Only the fields given change; their old values are not kept. Free. Do not use to publish: XcutAI never posts to social media.
| Argument | Type | Description |
|---|---|---|
| title | any | New title. |
| status | any | New status: draft, in_review, approved, scheduled or published. Never publishes anything. |
| caption | any | New caption or script text. |
| post_id* | string | Id (UUID) of the calendar post, from xcut_list_calendar. |
| hashtags | any | New hashtag list; replaces the old one. Up to 30. |
| post_type | any | New format: post, image, video, carousel, reel, story, idea, script or ad. |
| scheduled_at | any | New date and time in ISO 8601, e.g. "2026-11-03T18:00:00Z". |
{
"type": "object",
"title": "xcut_update_calendar_postArguments",
"required": [
"post_id"
],
"properties": {
"title": {
"anyOf": [
{
"type": "string",
"maxLength": 300,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Title",
"default": null,
"description": "New title."
},
"status": {
"anyOf": [
{
"enum": [
"draft",
"in_review",
"approved",
"scheduled",
"published"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Status",
"default": null,
"description": "New status: draft, in_review, approved, scheduled or published. Never publishes anything."
},
"caption": {
"anyOf": [
{
"type": "string",
"maxLength": 20000
},
{
"type": "null"
}
],
"title": "Caption",
"default": null,
"description": "New caption or script text."
},
"post_id": {
"type": "string",
"title": "Post Id",
"pattern": "^[0-9a-fA-F-]{36}$",
"description": "Id (UUID) of the calendar post, from xcut_list_calendar."
},
"hashtags": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"maxItems": 30
},
{
"type": "null"
}
],
"title": "Hashtags",
"default": null,
"description": "New hashtag list; replaces the old one. Up to 30."
},
"post_type": {
"anyOf": [
{
"enum": [
"post",
"image",
"video",
"carousel",
"reel",
"story",
"idea",
"script",
"ad"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Post Type",
"default": null,
"description": "New format: post, image, video, carousel, reel, story, idea, script or ad."
},
"scheduled_at": {
"anyOf": [
{
"type": "string",
"maxLength": 64,
"minLength": 4
},
{
"type": "null"
}
],
"title": "Scheduled At",
"default": null,
"description": "New date and time in ISO 8601, e.g. \"2026-11-03T18:00:00Z\"."
}
}
}Use this when the user asks to change a saved brand memory fact. Replaces that fact's text and category (the old text is not kept). Needs the fact's id from xcut_get_brand. Free. Do not use to add a new fact (use xcut_save_memory).
| Argument | Type | Description |
|---|---|---|
| text* | string | The fact's new text. |
| category | any | New kind of fact. Omit to keep the current one. |
| canvas_id* | string | Canvas id (a UUID) from xcut_list_canvases. |
| memory_id* | string | Id of the fact to change, from xcut_get_brand. |
{
"type": "object",
"title": "xcut_update_memoryArguments",
"required": [
"canvas_id",
"memory_id",
"text"
],
"properties": {
"text": {
"type": "string",
"title": "Text",
"maxLength": 2000,
"minLength": 2,
"description": "The fact's new text."
},
"category": {
"anyOf": [
{
"enum": [
"subject_type",
"brand_name",
"niche",
"brand_voice",
"language",
"visual_style",
"audience",
"content_format",
"content_pillars",
"hook_patterns",
"cta_style",
"kpi_focus",
"platform",
"posting_schedule",
"offer",
"competitors",
"constraint",
"content_preference",
"fact",
"other"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Category",
"default": null,
"description": "New kind of fact. Omit to keep the current one."
},
"canvas_id": {
"type": "string",
"title": "Canvas Id",
"pattern": "^[0-9a-fA-F-]{36}$",
"description": "Canvas id (a UUID) from xcut_list_canvases."
},
"memory_id": {
"type": "string",
"title": "Memory Id",
"maxLength": 100,
"minLength": 1,
"description": "Id of the fact to change, from xcut_get_brand."
}
}
}Use this when the user wants a finished caption (hook, body, CTA and hashtags) for an Instagram, TikTok or YouTube Shorts post from a short concept. Free; no sign-in. Output is generic: for work based on the user's own posts, canvases or brand, use the signed-in XcutAI tools. Do not use for writing unrelated to social media or marketing content.
| Argument | Type | Description |
|---|---|---|
| tone | string | Voice of the caption, e.g. "engaging", "funny", "calm". |
| concept* | string | What the post shows or says, in a sentence or two. |
| platform* | string | Where the caption will be posted. |
{
"type": "object",
"title": "xcut_write_captionArguments",
"required": [
"platform",
"concept"
],
"properties": {
"tone": {
"type": "string",
"title": "Tone",
"default": "engaging",
"maxLength": 50,
"description": "Voice of the caption, e.g. \"engaging\", \"funny\", \"calm\"."
},
"concept": {
"type": "string",
"title": "Concept",
"maxLength": 3000,
"minLength": 10,
"description": "What the post shows or says, in a sentence or two."
},
"platform": {
"enum": [
"instagram",
"tiktok",
"youtube_shorts"
],
"type": "string",
"title": "Platform",
"description": "Where the caption will be posted."
}
}
}Use this when the user wants XcutAI's agents to write for their brand: Reels, TikTok and Shorts scripts, YouTube scripts, Facebook posts, Meta ad copy, hooks, captions or plans, using their brand memory, imported posts and XcutAI's library of formats that performed. The conversation is saved to their canvas. Pick `agent` for the platform, or auto. Token-billed (typically 1-26 credits). Longer turns return a `job_id`. Do not use for writing unrelated to the user's social media or marketing content.
| Argument | Type | Description |
|---|---|---|
| agent | string | Which XcutAI writer to use: auto (picks from the request), instagram, tiktok, youtube_script, youtube_shorts, facebook, meta_ad or general. Default auto. |
| request* | string | What to write, as the user would ask in the canvas chat. |
| item_ids | any | Only use these canvas items (default: the whole canvas). |
| canvas_id | any | Optional. Leave it out unless the user names a canvas: XcutAI then uses their "From AI apps" canvas, where imports also land. Ids come from xcut_list_canvases. |
{
"type": "object",
"title": "xcut_write_contentArguments",
"required": [
"request"
],
"properties": {
"agent": {
"enum": [
"auto",
"instagram",
"tiktok",
"youtube_script",
"youtube_shorts",
"facebook",
"meta_ad",
"general"
],
"type": "string",
"title": "Agent",
"default": "auto",
"description": "Which XcutAI writer to use: auto (picks from the request), instagram, tiktok, youtube_script, youtube_shorts, facebook, meta_ad or general. Default auto."
},
"request": {
"type": "string",
"title": "Request",
"maxLength": 20000,
"minLength": 3,
"description": "What to write, as the user would ask in the canvas chat."
},
"item_ids": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"maxItems": 60
},
{
"type": "null"
}
],
"title": "Item Ids",
"default": null,
"description": "Only use these canvas items (default: the whole canvas)."
},
"canvas_id": {
"anyOf": [
{
"type": "string",
"pattern": "^[0-9a-fA-F-]{36}$"
},
{
"type": "null"
}
],
"title": "Canvas Id",
"default": null,
"description": "Optional. Leave it out unless the user names a canvas: XcutAI then uses their \"From AI apps\" canvas, where imports also land. Ids come from xcut_list_canvases."
}
}
}Use this when the user wants YouTube title options, with thumbnail ideas, for a video topic. Free; no sign-in. Output is generic: for work based on the user's own posts, canvases or brand, use the signed-in XcutAI tools. Do not use for writing unrelated to social media or marketing content.
| Argument | Type | Description |
|---|---|---|
| niche | any | The channel's niche, optional. |
| topic* | string | What the YouTube video is about. |
{
"type": "object",
"title": "xcut_youtube_titlesArguments",
"required": [
"topic"
],
"properties": {
"niche": {
"anyOf": [
{
"type": "string",
"maxLength": 100
},
{
"type": "null"
}
],
"title": "Niche",
"default": null,
"description": "The channel's niche, optional."
},
"topic": {
"type": "string",
"title": "Topic",
"maxLength": 300,
"minLength": 5,
"description": "What the YouTube video is about."
}
}
}{
"type": "object",
"title": "xcut_add_to_calendarArguments",
"required": [
"title",
"platform",
"scheduled_at"
],
"properties": {
"title": {
"type": "string",
"title": "Title",
"maxLength": 300,
"minLength": 1,
"description": "Short working title, e.g. \"3 myths about retinol\"."
},
"status": {
"enum": [
"draft",
"in_review",
"approved",
"scheduled",
"published"
],
"type": "string",
"title": "Status",
"default": "draft",
"description": "draft, in_review, approved, scheduled or published. Default draft. Setting it never publishes anything."
},
"caption": {
"anyOf": [
{
"type": "string",
"maxLength": 20000
},
{
"type": "null"
}
],
"title": "Caption",
"default": null,
"description": "Full caption or script text, if written."
},
"hashtags": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"maxItems": 30
},
{
"type": "null"
}
],
"title": "Hashtags",
"default": null,
"description": "Hashtags without spaces, e.g. [\"#skincare\", \"#retinol\"]. Up to 30."
},
"platform": {
"enum": [
"instagram",
"facebook",
"tiktok",
"youtube",
"meta"
],
"type": "string",
"title": "Platform",
"description": "Where it will be posted: instagram, facebook, tiktok, youtube or meta (Meta ads)."
},
"canvas_id": {
"anyOf": [
{
"type": "string",
"pattern": "^[0-9a-fA-F-]{36}$"
},
{
"type": "null"
}
],
"title": "Canvas Id",
"default": null,
"description": "Canvas (UUID) the post belongs to. Optional."
},
"post_type": {
"enum": [
"post",
"image",
"video",
"carousel",
"reel",
"story",
"idea",
"script",
"ad"
],
"type": "string",
"title": "Post Type",
"default": "post",
"description": "Format: post, image, video, carousel, reel, story, idea, script or ad. Default post."
},
"scheduled_at": {
"type": "string",
"title": "Scheduled At",
"maxLength": 64,
"minLength": 4,
"description": "ISO date or date-time."
}
}
}