Tools

Shows the current plan, connected account and creator limits, available credits, held credits and credits used this period.

Shows the status and result of a queued tool call.

Use when someone wants to connect their own TikTok, Instagram or YouTube account. Returns a browser link; the person must sign in to complete the connection.

Use to compare a connected account's performance with the previous period and review daily trends. Reads stored analytics only.

Lists your social accounts connected to Cuekoo in this workspace, including platform, handle, followers, connection status and sync status. Call this first to find the account IDs other tools need.

Use to review a connected account's published posts, engagement and performance against its own baseline. Reads stored data only.

Use to inspect one post's metrics, its outlier score (views / its creator's usual views; 2 or more is an outlier), virality score and engagement rate. API and MCP lookups of third-party posts cost 2 credits, even on a cache hit. Page reads of fresh saved metrics are free; a live refresh costs 2.

Use to see one creator's recent posts with each post's outlier score (views / the creator's usual views; 2 or more is an outlier), virality score and engagement rate. Each successful request retrieves the latest posts for 5 credits, including repeated requests.

Use to find creators on one platform by name, keyword or @handle, through the platform's own account search, in the platform's order (up to 20). TikTok and Instagram match names, handles and keywords, so use them to find creators by topic. YouTube matches channel names only: a topic keyword such as "skincare" returns nothing there, so search YouTube for a channel's name. To find accounts like a given @handle, use search_similar_creators instead. Instagram results have no follower counts, so followers cannot filter them. Each result carries the profile URL and, when known, name, avatar, short bio and follower count.

Use to discover creators similar to a public TikTok or Instagram account, as recommended by the platform, in recommendation order. YouTube and other platforms are not supported. Each result carries the profile URL and, when known, name, avatar, short bio and follower count; follower counts and bios are often unavailable for Instagram.

Use to find posts that beat their own creator's usual views at least twice. The outlier score is views / the creator's baseline, the median views of their latest 10 unpinned posts at least a day old. Searches up to 10 named creators when creators is given, the creators this workspace tracks with scope competitors, and otherwise every post Cuekoo has stored, there only from creators whose usual post reaches 1,000 views. Named or tracked creators Cuekoo has not stored, or without enough posts for a baseline, come back in skipped. Returns 10 posts per page with a next_cursor. API, MCP and Koo cost 1 credit per non-empty page; empty pages and direct web browsing are free.

Use to find recurring hooks and formats among standout posts by creators tracked in this workspace. Returns evidence posts and ways to adapt each pattern. Requires at least three saved standout posts.

Use to examine a TikTok, Instagram or YouTube video post's hook, timeline, transcript and reusable structure. Cost: 10 + 4 per started 30 seconds (14–34 credits). Videos up to 180 seconds. Results may contain unknowns where evidence is insufficient.

Use to see the workspace's competitor list: each competitor's platform, handle, display name, bio, avatar, check cadence, state and last check, plus what the list costs in credits per month and how many credits are left. Reads saved workspace data only.

Use to add creators to or remove them from the workspace's competitor list in one call. Add by profile link or platform and handle; new competitors are on the list as soon as the call returns, get their first check within minutes, and are checked daily after that. Each successful check costs credits: 10 for the first, then 2 per check, and nothing for creators the workspace already tracks in Creator Tracking. Removing stops its checks, so nothing more is charged for it.

Archive an idea the user no longer wants on the board, or restore an archived one with restore true. Archiving keeps everything; an archived idea still counts toward the plan's idea limit.

Read an idea's full content by its id: the Markdown body, properties, the posts embedded in the body, uploaded attachments and the posts made from it. Read it before drafting a post from it or updating it.

List the workspace's ideas, most recently updated first, optionally by group, tag, platform, assignee or due date, or the archived ones. Items carry an excerpt; use get_idea for the full body.

Create an idea on the workspace's Create board when the user asks to remember an idea or you developed a promising topic. The body is Markdown; a post link alone on a line shows as an embedded post. Each plan limits how many ideas a workspace keeps.

Change an idea's title, body, group, platforms, due date, assignee or tags. Read it with get_idea first and pass its version; if someone changed it since, the call fails with version_conflict and the current idea, so re-read and apply the change again. Only the user's confirmed changes should be written.

List the posts the workspace saved to Inspo, newest first, optionally one collection or the posts in none. Numbers are as of the day each post was saved.

Remove a post from the workspace's Inspo, which frees its slot. Ideas that embed the post keep the link.

Save another creator's TikTok, Instagram or YouTube post to the workspace's Inspo with its numbers frozen as of today. A post id from Discover or list_outliers saves free from stored data; a post_url is fetched fresh and costs 2 credits, charged only when the fetch succeeds (an invalid, private or deleted post is free). A duplicate recognized before fetching is free. A short link resolved by a successful fetch can still cost 2. A workspace keeps at most 1,000 posts.

Move a post saved in Inspo to another collection, or out of any collection with an empty collection_id.

List uploaded media ready to publish. Pass next_cursor as cursor to read the next page. Media must be uploaded in Cuekoo Studio first. If the list is empty, ask the user to upload the video or photos at /publish.

Create one post for one connected account. Use list_my_accounts for channel_id and list_media for uploaded media IDs. A draft may reference media that is still uploading, but publishing requires all media to be ready. mode now queues publishing and usually returns pending; check results in Cuekoo Studio (there is no status Tool yet). TikTok defaults to inbox delivery; even for inbox, mode now requires the user's explicit content_preview_confirmed and express_consent_given. Never set consent fields on the user's behalf. Ask the user to confirm the privacy level and the consent statements first. Minimal options: TikTok inbox {"delivery":"inbox","content_preview_confirmed":true,"express_consent_given":true} only after the user confirms both; Instagram {"content_type":"post"}; YouTube {"title":"Video title","visibility":"private"}. Direct TikTok also requires an explicit privacy_level and both confirmations. Set idea_id to link the post to an idea (get_idea); when the post goes live the idea moves to its done group. Set idempotency_key to a new UUID for each new post and send the same value when retrying the same call: a retry with the same key and input returns the original post instead of publishing twice.