XCut AI – Viral Content Research
Measured conclusion: Deep-tested. L2 outcome: tools_ok.
Find viral posts, outliers, hooks and ads on Instagram, TikTok, YouTube and Facebook, then write.
| Author | ai.xcut |
|---|---|
| Access | remote |
| Publisher key required | No |
| Measured state | Deep-tested |
| L1 liveness | alive |
| L1 latency | 115 ms |
| Last measured | 2026-10-24 |
Add to your agent
Copy this into your MCP client config:
{
"mcpServers": {
"XCut AI – Viral Content Research": {
"url": "https://mcp.xcut.ai/mcp",
"transport": "streamable-http"
}
}
}
Measured tools (39)
xcut_find_hooksread-onlyUse 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).
Parameters:
topic(required) — string — What the post is about, in English. e.g. 'pricing mistakes for small bakeries'limit— integer — How many templates (default 8).category— Optional hook family to restrict to.
Hints: read-only yes · destructive no · idempotent yes · open-world no
xcut_get_playbookread-onlyUse 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).
Parameters:
goal(required) — 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— Optional: structure (formats), principle, hook_type, ad_framework or platform_fact.limit— integer — How many entries (default 3).
Hints: read-only yes · destructive no · idempotent yes · open-world no
xcut_hook_ideasread-onlyUse 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.
Parameters:
platform(required) — string — Where the hooks will be used.niche(required) — string — The creator's niche, e.g. "fitness for busy moms".topic(required) — string — What the post is about.
Hints: read-only yes · destructive no · idempotent yes · open-world yes
xcut_write_captionread-onlyUse 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.
Parameters:
platform(required) — string — Where the caption will be posted.concept(required) — string — What the post shows or says, in a sentence or two.tone— string — Voice of the caption, e.g. "engaging", "funny", "calm".
Hints: read-only yes · destructive no · idempotent yes · open-world yes
xcut_rewrite_bioread-onlyUse 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.
Parameters:
platform(required) — string — Which profile the bio is for.current_bio(required) — string — The bio as it reads today.niche— The creator's niche, if not obvious from the bio.
Hints: read-only yes · destructive no · idempotent yes · open-world yes
xcut_youtube_titlesread-onlyUse 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.
Parameters:
topic(required) — string — What the YouTube video is about.niche— The channel's niche, optional.
Hints: read-only yes · destructive no · idempotent yes · open-world yes
xcut_analyze_scriptread-onlyUse 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.
Parameters:
script(required) — string — The full script to score (at least 50 characters).
Hints: read-only yes · destructive no · idempotent yes · open-world yes
xcut_audit_contentread-onlyUse 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.
Parameters:
titles_or_captions(required) — array — 3 to 10 past titles or captions, one per item.platform— string — Platform they were posted on, e.g. "instagram"; "general" if mixed.
Hints: read-only yes · destructive no · idempotent yes · open-world yes
xcut_posting_planread-onlyUse 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.
Parameters:
niche(required) — string — The creator's niche.platform(required) — string — Which platform the plan is for.posting_frequency(required) — string — e.g. '3x/week', '1x/day'content_pillars(required) — array — 1 to 5 themes the account posts about.
Hints: read-only yes · destructive no · idempotent yes · open-world yes
xcut_competitor_gapsread-onlyUse 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.
Parameters:
niche(required) — string — The niche to compare in.competitor_names(required) — array — 1 to 5 competitor names or handles.
Hints: read-only yes · destructive no · idempotent yes · open-world yes
xcut_check_nicheread-onlyUse 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.
Parameters:
niche_description(required) — string — The niche to check, described in a sentence or two.
Hints: read-only yes · destructive no · idempotent yes · open-world yes
xcut_repurpose_contentread-onlyUse 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.
Parameters:
title(required) — string — Title of the piece to repurpose.description— What the piece covers, optional but gives better angles.
Hints: read-only yes · destructive no · idempotent yes · open-world yes
xcut_get_accountread-onlyUse 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).
Hints: read-only yes · destructive no · idempotent yes · open-world no
xcut_list_canvasesread-onlyUse 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.
Parameters:
limit— integer — Most canvases to return, 1-100. Default 30.include_shared— boolean — Also list canvases shared with the user.
Hints: read-only yes · destructive no · idempotent yes · open-world no
xcut_get_canvasread-onlyUse 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).
Parameters:
canvas_id(required) — string — Canvas id (a UUID) from xcut_list_canvases.limit— integer — Most items to return, 1-100. Default 50.offset— integer — Items to skip, for paging through a large canvas. Default 0.item_type— Only list this kind of item.
Hints: read-only yes · destructive no · idempotent yes · open-world no
xcut_create_canvasUse 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.
Parameters:
name(required) — string — Name for the new canvas, e.g. "Q4 launch" or "Client: Glow Skincare".
Hints: read-only no · destructive no · idempotent no · open-world no
xcut_get_brandread-onlyUse 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).
Parameters:
canvas_id(required) — string — Canvas id (a UUID) from xcut_list_canvases. The brand attached to this canvas is returned.
Hints: read-only yes · destructive no · idempotent yes · open-world no
xcut_save_memoryUse 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.
Parameters:
canvas_id(required) — string — Canvas id (a UUID) from xcut_list_canvases. The fact is saved to this canvas's brand.text(required) — string — The fact, in one or two sentences.category— string — What kind of fact it is.
Hints: read-only no · destructive no · idempotent no · open-world no
xcut_update_memorydestructiveUse 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).
Parameters:
canvas_id(required) — string — Canvas id (a UUID) from xcut_list_canvases.memory_id(required) — string — Id of the fact to change, from xcut_get_brand.text(required) — string — The fact's new text.category— New kind of fact. Omit to keep the current one.
Hints: read-only no · destructive yes · idempotent yes · open-world no
xcut_delete_memorydestructiveUse 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).
Parameters:
canvas_id(required) — string — Canvas id (a UUID) from xcut_list_canvases.memory_id(required) — string — Id of the memory fact to remove, from xcut_get_brand.
Hints: read-only no · destructive yes · idempotent yes · open-world no
xcut_list_calendarread-onlyUse 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).
Parameters:
end— ISO date, e.g. 2026-10-31.limit— integer — Most posts to return, 1-200. Default 60.start— ISO date, e.g. 2026-10-01.canvas_id— Only posts planned for this canvas (UUID). Omit for all canvases.
Hints: read-only yes · destructive no · idempotent yes · open-world no
xcut_add_to_calendarUse 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.
Parameters:
title(required) — string — Short working title, e.g. "3 myths about retinol".platform(required) — string — Where it will be posted: instagram, facebook, tiktok, youtube or meta (Meta ads).scheduled_at(required) — string — ISO date or date-time.status— string — draft, in_review, approved, scheduled or published. Default draft. Setting it never publishes anything.caption— Full caption or script text, if written.hashtags— Hashtags without spaces, e.g. ["#skincare", "#retinol"]. Up to 30.canvas_id— Canvas (UUID) the post belongs to. Optional.post_type— string — Format: post, image, video, carousel, reel, story, idea, script or ad. Default post.
Hints: read-only no · destructive no · idempotent no · open-world no
xcut_update_calendar_postdestructiveUse 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.
Parameters:
post_id(required) — string — Id (UUID) of the calendar post, from xcut_list_calendar.title— New title.status— New status: draft, in_review, approved, scheduled or published. Never publishes anything.caption— New caption or script text.hashtags— New hashtag list; replaces the old one. Up to 30.post_type— New format: post, image, video, carousel, reel, story, idea, script or ad.scheduled_at— New date and time in ISO 8601, e.g. "2026-11-03T18:00:00Z".
Hints: read-only no · destructive yes · idempotent yes · open-world no
xcut_delete_calendar_postdestructiveUse 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).
Parameters:
post_id(required) — string — Id (UUID) of the calendar post to remove, from xcut_list_calendar.
Hints: read-only no · destructive yes · idempotent yes · open-world no
xcut_get_breakoutsread-onlyUse 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).
Parameters:
limit— integer — Most breakout alerts to return, 1-50. Default 20.
Hints: read-only yes · destructive no · idempotent yes · open-world no
xcut_scan_watchlistUse 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).
Parameters:
estimate— boolean — true returns the credit cost without scanning. Default false.
Hints: read-only no · destructive no · idempotent no · open-world yes
xcut_search_viralUse 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).
Parameters:
platform(required) — string — instagram, tiktok, youtube, facebook, or meta_ads for the Meta Ad Library.query(required) — string — A topic, or a handle when mode is profile.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.cursor— next_cursor from the previous page.
Hints: read-only no · destructive no · idempotent yes · open-world yes
xcut_find_outliersUse 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).
Parameters:
profile(required) — string — Profile link or @handle.platform(required) — string — instagram, tiktok, youtube or facebook.posts— integer — How many recent posts to analyse: 20, 30, 50 or 100. Default 30.canvas_id— Canvas (UUID) that owns the thumbnails. Optional. The results are returned here, not placed on the canvas.
Hints: read-only no · destructive no · idempotent yes · open-world yes
xcut_profile_analyticsUse 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).
Parameters:
profile(required) — string — Profile link or @handle.platform(required) — string — instagram, tiktok, youtube or facebook.days— Or: posts from the last N days.posts— Last N posts (default 20).canvas_id— Canvas (UUID) that owns the thumbnails. Optional. The table is returned here, not placed on the canvas.
Hints: read-only no · destructive no · idempotent yes · open-world yes
xcut_get_jobUse 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.
Parameters:
job_id(required) — string — The `job_id` an XcutAI tool returned, unchanged.
Hints: read-only no · destructive no · idempotent yes · open-world no
xcut_import_postUse 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).
Parameters:
url(required) — string — Post or video link.canvas_id— Optional. Leave it out unless the user names a canvas: XcutAI then uses their "From AI apps" canvas. Ids come from xcut_list_canvases.
Hints: read-only no · destructive no · idempotent no · open-world yes
xcut_import_websiteUse 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).
Parameters:
url(required) — string — Page link.canvas_id— Optional. Leave it out unless the user names a canvas: XcutAI then uses their "From AI apps" canvas. Ids come from xcut_list_canvases.
Hints: read-only no · destructive no · idempotent no · open-world yes
xcut_import_meta_adUse 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).
Parameters:
url(required) — string — Meta Ad Library link (facebook.com/ads/library/?id=…).canvas_id— Optional. Leave it out unless the user names a canvas: XcutAI then uses their "From AI apps" canvas. Ids come from xcut_list_canvases.
Hints: read-only no · destructive no · idempotent no · open-world yes
xcut_import_profileUse 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).
Parameters:
profile(required) — string — Profile link or @handle.platform(required) — string — instagram, tiktok, youtube or facebook.posts— integer — How many recent posts (default 6).canvas_id— Optional. Leave it out unless the user names a canvas: XcutAI then uses their "From AI apps" canvas. Ids come from xcut_list_canvases.
Hints: read-only no · destructive no · idempotent no · open-world yes
xcut_add_noteUse 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).
Parameters:
text(required) — string — Markdown text.title— Optional note title, e.g. "Week 1 scripts".canvas_id— Optional. Leave it out unless the user names a canvas: XcutAI then uses their "From AI apps" canvas. Ids come from xcut_list_canvases.
Hints: read-only no · destructive no · idempotent no · open-world no
xcut_get_contentUse 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).
Parameters:
canvas_id(required) — string — Canvas id (a UUID) from xcut_list_canvases.item_id(required) — string — Item id from xcut_get_canvas, or the `item_id` an import returned.before— Chats only: message id to page back from.
Hints: read-only no · destructive no · idempotent yes · open-world no
xcut_write_contentUse 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.
Parameters:
request(required) — string — What to write, as the user would ask in the canvas chat.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.item_ids— Only use these canvas items (default: the whole canvas).canvas_id— 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.
Hints: read-only no · destructive no · idempotent no · open-world no
xcut_run_playbookUse 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).
Parameters:
playbook(required) — 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.days— Plan length, for month/week plans.notes— Extra instructions from the user.platform— The platform to write for, when the playbook follows one.canvas_id— 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.
Hints: read-only no · destructive no · idempotent no · open-world no
xcut_generate_imageUse 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.
Parameters:
prompt(required) — 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— Up to 5 public https image links to guide style or to edit.
Hints: read-only no · destructive no · idempotent no · open-world yes
Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.