Tool reference

Mark a finished owned carousel as reviewed and ready to publish. This does not publish or schedule. Requires the user’s approval in Caroush.

Create a draft generation automation using an existing product and connected accounts. Does not enable or run it. UGC requires cta_asset_id referencing an owned 3–15 second stored video; carousel accepts an optional stored image CTA.

Create an image post or carousel from 1–10 existing owned media image IDs, in the supplied order. No URLs are downloaded and no publication occurs.

Save a product and queue Caroush product analysis. Provide a meaningful description; audience and content themes are optional reviewed editorial preferences.

Save a text-only post in Caroush. This does not publish or schedule it and does not consume image credits.

Delete an automation after browser approval, cancel unfinished runs and preserve existing published output. Releases reserved credits for unfinished video generation.

Permanently remove an owned Caroush content record, its local delivery/history records and unreferenced media files. Does not remove posts already published on social platforms. Requires browser approval.

Remove an owned product. Existing automation configurations depending on it can no longer generate new content. Requires browser approval.

Pause future runs for an automation. Pausing remains available even if a referenced product or account was removed.

Enable a saved automation after browser approval. Validates subscription, credits, product, media and connected accounts. Finished TikTok content still requires per-post review.

Fetch a public HTTP/HTTPS product page and suggest its audience and content themes using the existing product analyzer. Returns suggestions without saving a product. Runs asynchronously.

Generate and save 3–5 TikTok-focused caption variants with hooks, CTAs and hashtags through Caroush. Runs asynchronously; the source field distinguishes provider AI from the existing local fallback.

Queue a real 3–10 slide carousel for an owned product. Uses reviewed product audiences by default. Costs 5 credits per AI-generated image; an optional existing CTA image replaces the final generated slide. Poll get_carousel; creation does not publish.

Generate one concise on-screen UGC video hook from a creative brief using the same prompt as Studio. Runs asynchronously; returns text only and does not render or publish a video.

Read saved, real performance for posts published through Caroush in the authorized workspace. Pro is required. Days filters publication cohorts; metrics are lifetime totals at the last sync, with coverage and missing values preserved.

Read your subscription tier, account-wide resource quotas and the effective permissions of this MCP connection.

Read one automation’s configuration and current runtime credit price. IDs are separate for carousel and video automations; specify kind.

Read progress of an existing native automation run, including generated post and publishing statuses. kind is carousel or video; run_id is not the automation ID.

Read a paginated history of one automation’s runs and each publication destination. No provider calls or new jobs are started.

Return up to five Caroush posts ranked by reported views in a publication-date cohort. Pro is required. Posts without available view metrics are excluded; comparisons across platforms have different view definitions.

Read an owned carousel by its post ID: saved slide images/copy, progress, errors, credit balance and approval state. A queued response is not finished content.

Read saved copy and slide roles from an owned carousel specification once its planning is complete. This performs no generation and exposes no internal storage paths or prompts.

Read the current credit balance, earned/spent totals and runtime price per generated image. Reads do not spend credits.

Read an MCP operation created by this connection. Its result can contain a separate native carousel/automation run ID: poll that resource for generation or publication completion. Never assume queued work is finished.

Read one owned image/video asset by its media ID.

Read one owned post, its ordered assets and confirmed live post links. IDs from another user or workspace are rejected.

Read the latest saved metrics for one published Caroush delivery. Pro is required. schedule_id identifies a publication on one account. Does not fetch providers.

Read one owned product and its reviewed audience/content preferences.

Read your authenticated identity and onboarding status. No authentication secrets or billing customer IDs are returned.

Read one publishing delivery, including its real permalink when available. schedule_id is a delivery ID, not a generated post ID.

Read the workspace chosen during OAuth consent. This never changes the workspace selected in your browser.

List saved carousel or video generation automations. Video includes 2×2, single fade and AI UGC. These schedules support daily times in an IANA timezone.

List Caroush’s currently supported carousel design systems and slide roles. Use these IDs when generating; retired designs are not accepted.

List connected accounts in the authorized workspace, including connection health. Credentials are never returned.

List owned content that has never been scheduled to a destination. Generated images and caption variants can also be drafts.

List owned image/video assets already saved in Caroush. Returned media IDs can be used for image posts and CTA artwork.

List your saved Caroush content with cursor pagination. Status filters use destination delivery state; draft means never scheduled. Dates filter content creation time.

List existing reference images, screenshots and logos attached to an owned product.

List the products you own in the authorized workspace, including reviewed audiences and editorial content themes.

List this user’s delivery records in the authorized workspace, filtered by platform, status, post, account or scheduled date. Reads saved records only.

Publish an existing approved post to connected accounts after browser approval. Publication runs in the background; provider processing may remain pending. TikTok must use the Caroush review composer.

Queue a revision of an owned carousel. Targets slide/image require slide_index; other targets forbid it. New images cost 5 credits each; copy/hook/layout reuse images. Uploaded CTA artwork cannot be regenerated. Existing images remain available on failure.

Resume an eligible failed original carousel from saved checkpoints. Reuses reserved credits or charges refunded credits again according to the existing recovery rules. Poll get_carousel for completion.

Queue one real generation-and-publishing occurrence after browser approval. Uses the request idempotency key to reuse the same native run on retries. Poll get_automation_run for completion; TikTok output requires browser review.

Schedule an existing approved post to connected accounts. Requires browser approval. TikTok must be reviewed and submitted in the Caroush composer; this tool never supplies TikTok consent.

Search owned saved image/video asset titles and captions. Returns IDs and existing public media URLs, never storage credentials or paths.

Search your saved post titles and briefs in the authorized workspace. Returns bounded content and delivery summaries.

Update a saved generation automation while preserving omitted settings. Browser approval is required because an active definition controls future publishing. CTA must be an owned stored asset.

Update an owned product and queue fresh analysis. Name is required; omitted description and URL fields retain the existing values. Existing brand/features remain intact.