AdWhispr Ads Marketing Manager

Report spend, impressions, and clicks for campaigns in a connected ad account, defaulting to the last 30 days. Use when the user asks how their own campaigns are performing.

get_account_performance

Return up to 5 individual ads per tracked brand with creative-pattern enrichment and inline media. For one named brand, pass brandName. When the user asks for two or three brands, pass all names once in brandNames so one grouped viewer shows a separate section for each brand; do not make parallel calls. Pass the requested count per brand when it is 1–5; otherwise use 5. For image-only or video-only requests pass mediaType ('image' or 'video'). AdWhispr creative-pattern scores are heuristic research signals, not verified campaign performance.

get_brand_ads

Return aggregate creative research statistics for a tracked brand. Use this tool by itself for aggregate or snapshot requests; do not fetch individual ads unless the user asks to see or analyze examples. Any AdWhispr creative-pattern score is heuristic, not verified campaign performance.

get_brand_stats

Return the user's saved brand profile (business, product, niche). Call this first when the user asks about ads or competitors in their own market without naming a specific brand. If nothing is saved, ask the user for their product URL or a description of their business.

get_my_brand

Read the full state of the user's connected Meta ad account: every campaign, ad set, and ad with the status the platform itself reports, including review, rejection, and billing states. Read-only. Use when the user asks why something is not delivering or what is currently live.

inspect_ad_account

Create a new campaign in the user's connected ad account. The campaign is always created paused and spends nothing until the user resumes it. Two-step: the first call returns a preview and a confirmToken; calling again with that token creates the campaign. Ask the user for the campaign objective if they have not stated one.

launch_campaign

Launch an image the user already created in the AdWhispr web app as a paused ad in their connected Meta account, creating the campaign, ad set, creative, and ad. Only the image comes from the clone: write message (primary text, and optionally headline) fresh for the user's own product, and the destination link is the user's own page (falls back to their saved website) — the source ad's URL and copy are never used. Nothing spends until the user resumes it. Two-step preview-and-confirm with a confirmToken; the preview shows the exact link and copy — show them to the user. Ask for the objective if the user has not stated one.

launch_cloned_ad

Create a Google Performance Max campaign in the user's connected Google Ads account, with creative assets generated from the user's saved brand profile. campaignType can also run a video (YouTube) campaign from the user's own videos, or a Shopping campaign from a linked Merchant Center feed. Always created paused. Two-step preview-and-confirm with a confirmToken. Requires conversion tracking in the account and a saved brand logo and website.

launch_pmax_campaign

Create a Google Search campaign — campaign, ad group, keywords, and a responsive search ad — in the user's connected Google Ads account. Always created paused; nothing serves until the user resumes it. Two-step: the first call returns a preview and a confirmToken; calling again with that token creates it.

launch_search_campaign

Launch the user's own images or videos from their creative library as a paused single-image, carousel, or single-video ad in their connected Meta account. Nothing spends until the user resumes it. Two-step preview-and-confirm with a confirmToken. For an image the user created in the AdWhispr web app, use launch_cloned_ad instead.

launch_meta_ad

Create a TikTok campaign — campaign, ad group, video upload, and video ad — in the user's connected TikTok Ads account, using a video the user owns. Always created paused. Two-step preview-and-confirm with a confirmToken. Requires a linked TikTok identity on the ad account; the minimum daily budget is 20 in the ad account's currency.

launch_tiktok_campaign

List existing campaigns in one of the user's connected ad accounts, including name, status, budget, and campaign id. Use before adjusting a campaign; the returned id feeds pause_campaign, resume_campaign, and update_budget.

list_campaigns

List the ad accounts the user has connected for campaign management. Use this to find the accountId that other campaign tools require.

list_ad_accounts

List the user's own uploaded ad videos and images, with names and creative ids. Use when the user references their own video or creative, or before launching a TikTok campaign that needs one.

list_my_creatives

List the products saved in the user's catalog, with names, prices, photo counts, and product ids. Check this before creating a video ad for an e-commerce user; if several products are saved, ask which one the ad should feature.

list_my_products

Pause a running campaign in the user's connected ad account so it stops delivering and spending. Takes effect immediately.

pause_campaign

Delete one saved product from the user's catalog by productId (from list_my_products). Use when the user asks to remove a product. The brand profile itself is not affected.

remove_product

Given a competitor's URL or domain, return the keywords Google associates with that page's content, each with search volume, cost-per-click range, and competition level. This reflects the site's content themes, not its actual ad bids; present it that way.

research_competitor_keywords

Two modes. Default (content 'ads'): return a competitor's ads from TikTok's public Commercial Content Library (last 90 days, EEA countries), sorted by how long each ad has been shown; coverage is limited to advertisers active in the European Economic Area, and spend and impression data are not available; if the auto-selected advertiser account is wrong, call again with an advertiserId from the result's candidate list. Organic mode (content 'organic'): return a creator's own posted TikToks for the given @handle, with views, likes, comments, shares, and saves, sorted by 'popular' or 'latest'; this works for any public account and is not limited to the EEA.

research_tiktok_ads

Return Google Keyword Planner data — average monthly search volume, cost-per-click ranges, and competition level — for one or more seed keywords. Use when the user asks which keywords to target, what a click costs, or for keyword ideas. Country and language are configurable.

research_keywords

Resume a paused campaign, which makes its ads eligible to deliver publicly and begin spending. Two-step: the first call returns a warning and a confirmToken; calling again with that token takes the campaign live. Requires clear user confirmation.

resume_campaign

Save or update the user's own business profile from a product URL or a plain-text description, so research and creative tools can use it. Call this whenever the user states what their business is. Saving replaces the previously saved profile.

save_my_brand

Look up ad-targeting options in the user's connected account before launching: interest ids, location ids, existing custom audiences, or installed pixels, depending on kind. Read-only lookups; to create a new audience, use create_audience. Never invent ids and never reuse ids across platforms.

search_ad_targeting

Search a tracked brand's ads by concept or theme (for example, testimonial ads or before-and-after ads) using semantic matching. Requires a brandId from search_brands. Use when the user describes the kind of ad they want to see rather than asking for a sorted list.

search_ads

Search tracked brands by name. Returns brand names, ad counts, and brand ids. Use this first to get the brandId that other research tools require.

search_brands

Change a campaign's daily budget, or rename a campaign, in the user's connected ad account. Two-step: the first call returns a preview and a confirmToken; calling again with that token applies the change.

update_budget

Read or change the geographic targeting of an existing campaign in the user's connected account. For Google, add or remove location ids found with search_ad_targeting; for Meta, adjust where a live ad set delivers without rebuilding it. Changes use a two-step preview-and-confirm with a confirmToken.

update_campaign_locations

Pause, re-enable, or change the bid of keywords that already exist in a Google Search campaign in the user's connected account. Two-step preview-and-confirm with a confirmToken.

update_keywords

Create a shot-by-shot TikTok ad concept and written script based on a competitor's TikTok ad, adapted to the user's product. The output is text the user films themselves; this tool does not render, publish, or launch media. Get the advertiser name and adId from research_tiktok_ads first.

create_tiktok_ad_script