TikTok Ads

Call when you need orientation — at the start of a new conversation, when resuming after a gap, or when unsure what is possible. Returns this app's entry points (each maps a goal to its starting tool) and the current flow state snapshot (established milestones and candidate_tools). Read-only, no side effects.

Validate and re-render supplied product data on the product_review card without scraping or calling any external API. Use to refresh the card after the user edits product details; pass the full current product object with only the requested fields changed.

Render drafted storyboard scenes on the storyboard_preview card and return the server-composed video generation arguments. Each scene uses split visual fields (shot / subject / action / setting / lighting / texture) plus a short title and summary. Use for the initial render and to re-render after the user revises scenes. Does not generate a video.

Build and render a local Smart+ campaign plan preview (campaign_settings card) from product, creative, budget, and targeting inputs, applying the server's Smart+ defaults. Creates no TikTok entities. The video source can be a video_id, a video_task_id, or a downloadable video_url; when a creative was produced in this conversation the server can recover the video source automatically.

Enable a previously created disabled Smart+ draft, activating live ad delivery. Requires the user's explicit publish confirmation. Call once per campaign.

Fetch and parse a public product page URL into structured product details (title, brand, description, price, features, rating) plus reference images, rendered on the product_review card. Use when the user provides a product or store URL to advertise. Read-only.

List the TikTok Ads advertiser accounts the user has authorized. Resolves silently when exactly one exists; with several it renders a picker card the user must answer. Call it at the moment something consumes the advertiser account (for example connecting the TikTok identity, or creating the campaign draft), when the user asks about their accounts, or when the user agrees to settle it ahead of time — never uninvited. Never invent or pass a placeholder advertiser_id.

Use this when the user appears frustrated, dissatisfied, blocked, or explicitly asks to send feedback to the TikTok Ads team. Before calling this tool, summarize the user's frustration in plain language and ask the user to confirm that exact feedback should be sent. Call only after explicit confirmation; pass the confirmed verbatim feedback text in feedback and set confirmed=true. Do not call for ordinary workflow edits or support questions unless the user confirms they want feedback sent.

Render the own-video entry card so the user can hand over THEIR OWN finished ad video — file upload or direct-download MP4/MOV URL, up to 500MB; vertical 9:16 and 5-60s work best. Use the moment the user wants to advertise with an existing video. The hand-off is recorded server-side; call once per video.

Record the user-confirmed product reference image set (up to 3 images, each at least 512x512) and return the canonical list with quality warnings. Use after the user has seen and approved the images on the product card; if the user edited images that are not rendered yet, re-render with present_product and get approval first.

Internal polling endpoint for the video_status card. Invoked automatically by the card; not intended for assistant use.