add_brand
ChatGPTStart tracking a new brand so its ads can be researched. Finds the brand's page in the ad library and begins ingesting its ads, which takes a minute or two. Pass the pageId from find_competitors when available so the exact page is tracked.
add_negative_keywords
ChatGPTAdd campaign-level negative keywords to a Google Search campaign in the user's connected account, so the listed searches no longer trigger its ads. Two-step preview-and-confirm with a confirmToken.
add_product
ChatGPTSave a specific product page URL to the user's catalog. The product's name, description, price, and photos are extracted so ads can feature the real product. Use for e-commerce users who want an ad about one specific product. Distinct from save_my_brand, which stores the brand as a whole.
clear_my_brand
ChatGPTDelete the user's saved brand profile, including product, website, audience, tone, logo, and colors. Use only when the user asks to clear, reset, or forget their saved brand. To switch to a different brand, use save_my_brand instead.
compare_brands
ChatGPTCompare two or three tracked brands side by side on ad counts, creative formats, hooks, and activity. Get brand ids from search_brands first. Use when the user asks how brands' advertising compares.
connect_ad_account
ChatGPTConnect one of the user's own Meta, Google Ads, TikTok Ads, X Ads, or Reddit Ads accounts through the platform's authorization screen; ChatGPT Ads connects through a secure key page this tool links to. LinkedIn Ads is coming. Availability depends on the authenticated account.
create_ad_group
ChatGPTAdd a new ad group with its ads to an existing campaign in the user's connected account. For Google Search, the new ad group includes its keywords and a responsive search ad; for ChatGPT Ads, it adds an ad group with one or more chat-card ads. Two-step preview-and-confirm with a confirmToken.
create_audience
ChatGPTCreate an audience in the user's connected Meta ad account for use in campaign targeting. Two-step preview-and-confirm with a confirmToken.
create_tiktok_ad_script
ChatGPTCreate 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.
find_competitors
ChatGPTFind advertisers verified to be currently running ads in the user's market, ranked by active-ad count. Uses the user's saved brand automatically; pass niche only to search a different market. Present verified advertisers separately from unverified names, and call this tool instead of suggesting competitor names from general knowledge.
generate_brief
ChatGPTGenerate a competitive advertising brief for a tracked brand, including longevity patterns, engagement signals where available, creative iteration, frequent hooks, formats, longest-running ads, and a positioning summary. Includes a PDF download link.
get_account_performance
ChatGPTReport 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_brand_ads
ChatGPTReturn 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_stats
ChatGPTReturn 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_my_brand
ChatGPTReturn 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.
inspect_ad_account
ChatGPTRead 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.
launch_campaign
ChatGPTCreate 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_cloned_ad
ChatGPTLaunch 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_meta_ad
ChatGPTLaunch 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_pmax_campaign
ChatGPTCreate 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_search_campaign
ChatGPTCreate 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_tiktok_campaign
ChatGPTCreate 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.
list_ad_accounts
ChatGPTList the ad accounts the user has connected for campaign management. Use this to find the accountId that other campaign tools require.
list_campaigns
ChatGPTList 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_my_creatives
ChatGPTList 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_products
ChatGPTList 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.
pause_campaign
ChatGPTPause a running campaign in the user's connected ad account so it stops delivering and spending. Takes effect immediately.
remove_product
ChatGPTDelete 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.
research_competitor_keywords
ChatGPTGiven 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_keywords
ChatGPTReturn 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_tiktok_ads
ChatGPTTwo 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.
resume_campaign
ChatGPTResume 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.
save_my_brand
ChatGPTSave 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.
search_ad_targeting
ChatGPTLook 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_ads
ChatGPTSearch 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_brands
ChatGPTSearch tracked brands by name. Returns brand names, ad counts, and brand ids. Use this first to get the brandId that other research tools require.
update_budget
ChatGPTChange 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_campaign_locations
ChatGPTRead 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_keywords
ChatGPTPause, 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.