add_ad_group_negative_keywords
ChatGPTAdd negative keywords scoped to a single ad group, not the whole campaign - use this when a search term is wasteful for one ad group's theme but still relevant to another in the same campaign. For a term that's wasteful everywhere, add_negative_keywords (campaign-level) is fewer calls.
add_callouts
ChatGPTAdd callouts (short trust/feature snippets shown under the ad, e.g. 'Read-only access', 'No card required') to a campaign. Free, and typically raises CTR/Quality Score the same way sitelinks do. Creates the assets and links them to the campaign in one atomic mutate, same as add_sitelinks.
add_keywords
ChatGPTAdd positive keywords to an ad group. Match type matters: BROAD reaches widest and spends fastest, PHRASE is narrower, EXACT is tightest. Added PAUSED by default.
add_negative_keywords
ChatGPTAdd campaign-level negative keywords, which stop ads showing for those searches. This only ever reduces reach and spend, so it is the safest write tool here and the usual first response to wasteful search terms found via get_search_terms.
add_sitelinks
ChatGPTAdd sitelinks (extra links below the main ad, e.g. to /pricing or /security) to a campaign. Free - extensions don't cost more per click - and they typically raise CTR and Quality Score, which can lower actual CPC. Creates the assets and links them to the campaign in one atomic mutate, so validateOnly validates the whole operation and a failure can't leave an orphaned, unlinked asset.
bing_add_site
ChatGPTAdd a website to this Bing Webmaster Tools account and get what's needed to verify ownership: a DNS CNAME record, a meta tag, or an XML file - any one of them. Bing has no data for a site until it's verified. After the record/tag/file is in place, call bing_verify_site. Safe to call again for a site that's already added (it just returns the verification details). Requires changes to be allowed on the Bing connection in Caybl.ai.
bing_backlinks
ChatGPTWho links to the site, from Bing's link index. Without url: the site's pages that have inbound links, with a link count each. With url: the pages linking to that one page and their anchor text. Results are paged; pass page to continue (see totalPages).
bing_crawl_health
ChatGPTIs Bing crawling and indexing the site, and what's broken? Returns daily crawl stats (pages crawled, pages in Bing's index, crawl errors, HTTP status counts, robots.txt blocks) and the list of URLs Bing has crawl issues with (redirects, 4xx/5xx, robots.txt blocks, DNS/timeouts, malware). Fixed issues can take a few days to drop off Bing's list.
bing_inspect_url
ChatGPTIs this page in Bing's index? Returns when Bing discovered and last crawled it, the HTTP status Bing saw, and its Bing clicks/impressions. The Bing counterpart of Search Console's inspect_url: use it to check a page before and after bing_submit_urls.
bing_keyword_research
ChatGPTSearch demand for a keyword on Bing: weekly impressions over recent months (exact match, plus 'broad' - searches containing the keyword) and related keywords with their volumes. Not tied to a site - any keyword works. Volumes count Bing searches only, so they're best read as relative demand and trends.
bing_list_sitemaps
ChatGPTThe sitemaps (and RSS/Atom feeds) Bing has for the site: status, when Bing last read each one, and how many URLs it contains. Pass sitemapUrl for a sitemap index's child sitemaps.
bing_list_sites
ChatGPTList the sites in this Bing Webmaster Tools account and whether each is verified (only verified sites have data). Pass one as siteUrl to the other bing_ tools - only needed when there's more than one.
bing_search_performance
ChatGPTDaily Bing search clicks and impressions for a site, with totals for the window - the Bing equivalent of Search Console's performance chart. Bing keeps roughly the last six months.
bing_submit_sitemap
ChatGPTAdd (or resubmit) a sitemap in Bing Webmaster Tools so Bing reads it - the most reliable way to get every page found. Requires write access on the site in Caybl.ai (refuses cleanly if changes are switched off).
bing_submit_urls
ChatGPTAsk Bing to crawl and index specific pages now - the step after publishing or updating a page, instead of waiting for Bing to find it. Every URL must be on the site. Bing allows a limited number of submissions per site per day; this checks the remaining quota first and reports what's left. Requires write access on the site in Caybl.ai (refuses cleanly if changes are switched off).
bing_top_pages
ChatGPTThe site's pages that get Bing search traffic, with clicks, impressions, CTR and average position, summed over the window and sorted by clicks. Pass page to instead see which searches that one page shows up for.
bing_top_queries
ChatGPTThe searches people make on Bing that show this site, with clicks, impressions, CTR and average position, summed over the window and sorted by clicks. Pass query to instead see which of the site's pages rank for that one search. Bing updates this weekly.
bing_verify_site
ChatGPTAsk Bing to check the ownership proof (DNS record, meta tag or XML file from bing_add_site) for a site and mark it verified. If Bing can't find it yet, DNS changes can take a few minutes to an hour to be seen - wait and try again. Requires changes to be allowed on the Bing connection in Caybl.ai.
create_ad_group
ChatGPTCreate a Search ad group inside a campaign. Created PAUSED by default. cpcBid is the default max CPC for keywords in this group, in account currency.
create_campaign
ChatGPTCreate a Search campaign against an existing budget. Created PAUSED by default so it cannot start spending before a human looks at it - pass status='ENABLED' only when that is intended. Create the budget first with create_campaign_budget.
create_campaign_budget
ChatGPTCreate a shared daily campaign budget. A campaign cannot be created without one, so this is normally the first write call. amount is a daily amount in account currency (not micros).
create_google_ads_link
ChatGPTLink a GA4 property to a Google Ads customer account (see list_google_ads_links to check what's already linked first - this errors if one already exists for that pair). Together with mark_key_event, this is what lets Google automatically sync a GA4 key event into a Google Ads conversion action - see update_ga4_conversion_action (Google Ads connector) for the one step still needed once that sync happens. Needs the analytics scope; a connection made before that scope was requested will refuse this until reconnected (see needsReconsent).
create_responsive_search_ad
ChatGPTCreate a responsive search ad in an ad group. Google requires 3 to 15 headlines (max 30 chars each) and 2 to 4 descriptions (max 90 chars each); those limits are enforced here before the call so a bad draft fails fast rather than as an opaque API error. Created PAUSED by default.
delete_google_ads_link
ChatGPTRemove the Google Ads link between a GA4 property and a customer account - e.g. to fix a link made to the wrong account (a manager instead of the actual client account, say). See list_google_ads_links to check what's currently linked first; errors if no link exists for that pair. Needs the analytics scope; a connection made before that scope was requested will refuse this until reconnected (see needsReconsent).
find_zero_visibility_pages
ChatGPTGiven the page URLs you track (e.g. a marketing site's master URL list), return which got zero impressions in Search Console over the window - worth a manual indexing check (noindex tag, orphaned internal links, thin/duplicate content) rather than assuming it's simply low demand. Caybl has no notion of your tracked-URL list on its own, which is why this takes urls rather than inferring them. Matches scheme (http/https) and trailing-slash variants of each URL automatically, since Search Console may report the same page in a different form than your list uses.
generate_keyword_ideas
ChatGPTKeyword Planner ideas for seed keywords and/or a URL: monthly search volume, a LOW/MEDIUM/HIGH competition score, and top-of-page bid estimates. Works pre-spend. Volume is bucketed by Google.
get_account_summaries
ChatGPTList the GA accounts and properties this connection can access.
get_ad_groups
ChatGPTList ad groups for an account (optionally filtered to one campaign): id, name, status, type, and their parent campaign.
get_ad_performance
ChatGPTPerformance broken down by individual ad, not just by campaign - which specific responsive search ad (and its headlines/descriptions) is actually winning. get_campaign_performance only reports at the campaign level. Defaults to the last 30 days; filter to one campaign or ad group with the optional ids.
get_campaign_criteria
ChatGPTEverything that controls WHERE, WHEN, and to WHOM a campaign can serve: location targeting, excluded devices, ad schedule, and campaign-level negative keywords. get_campaigns only covers structural fields (name, status, budget) - a campaign can look perfectly configured there while having no location targeting at all, which defaults to Google's broadest reach, not 'no targeting'. Check this before enabling any campaign meant for specific markets or hours.
get_campaign_performance
ChatGPTPer-campaign performance over a date range: impressions, clicks, cost, conversions, CTR, and average CPC. Costs are in the account currency (converted from micros). Defaults to the last 30 days.
get_campaigns
ChatGPTList campaigns for an account: id, name, status, channel type, bidding strategy, and daily budget. Structure only (no performance metrics) - use get_campaign_performance for spend/results.
get_custom_dimensions_and_metrics
ChatGPTList the custom dimensions and custom metrics defined on a GA4 property.
get_impression_share
ChatGPTYour own search impression-share metrics per campaign (share, top, absolute-top, and share lost to rank vs budget). NOTE: the Ads API does not expose the competitor-domain Auction Insights report - this is your account's share only, not named competitors. Defaults to the last 30 days.
get_property_details
ChatGPTReturn details about a specific GA4 property (name, timezone, currency, type, etc.).
get_resource_metadata
ChatGPTDescribe a Google Ads API resource type (e.g. 'campaign', 'ad_group', 'search_term_view'): its category, the metrics and segments selectable with it, and related resources. Helps construct GAQL for run_gaql_report.
get_search_console_property_details
ChatGPTReturn your permission level for a single Search Console property.
get_search_terms
ChatGPTThe actual search queries that triggered your ads, with impressions/clicks/cost/conversions. Useful for spotting wasted spend and negative-keyword candidates. Defaults to the last 30 days.
get_sitemap
ChatGPTStatus of one specific sitemap: last downloaded, errors/warnings, and URLs submitted vs. indexed.
inspect_url
ChatGPTLive index status for one URL: whether it's indexed, its Google-selected canonical, mobile usability, and any rich results detected. The tool for answering 'why isn't this page performing' before deciding what to change on it.
list_accessible_customers
ChatGPTList the Google Ads accounts (customer ids) this connection can access. Pass one as customerId for the other tools - only required when more than one account is reachable; the other tools auto-pick a single reachable account on their own.
list_google_ads_links
ChatGPTList the Google Ads account links configured on a GA4 property.
list_sitemaps
ChatGPTList the sitemaps Search Console knows about for a property, with their last-read status.
list_sites
ChatGPTList the Search Console properties (domain or URL-prefix) this connection can access, with your permission level on each. Pass one as siteUrl for the other tools - only required when more than one property is reachable; the other tools auto-pick a single reachable property on their own.
mark_key_event
ChatGPTMark a GA4 custom event (e.g. connect_success or first_tool_call_success, already flowing in via src/analytics/measurementProtocol.ts and GTM) as a key event - together with create_google_ads_link, the prerequisite for Google to automatically sync it into a Google Ads conversion action (there's no API call to trigger that sync; it happens once both exist). Once synced, see update_ga4_conversion_action (Google Ads connector) to set it as a primary MAXIMIZE_CONVERSIONS goal. Needs the analytics scope; a connection made before that scope was requested will refuse this until reconnected (see needsReconsent).
msads_add_ad_extensions
ChatGPTCreate sitelinks and/or callouts in the account's extension library. They are created UNATTACHED, so they do not serve until attached to a campaign or ad group with msads_set_ad_extension_attachment. Limits are checked first: sitelink text up to 25 characters (35 without descriptions), descriptions up to 35 and given together or not at all, callout text up to 25. Callouts only serve once there are at least 2 on a campaign or ad group. Use dryRun to review.
msads_add_keywords
ChatGPTAdd keywords to an ad group. They are created PAUSED unless status is 'Active', so nothing starts spending until someone turns it on. Keywords already in the ad group with the same text and match type are skipped. Each keyword can have its own bid (otherwise it uses the ad group's) and final URL. Up to 50 per call. Use dryRun to see what would be added.
msads_add_negative_keywords
ChatGPTAdd negative keywords to a campaign or an ad group, so ads stop showing for those searches (the usual fix for wasted spend found with msads_get_search_terms). Exact blocks only that search, Phrase blocks searches containing the words in order, Broad blocks searches containing all the words in any order - Exact is the safe default. Up to 50 per call; ones already present are skipped. Adding negatives can reduce traffic, so check the list with dryRun when unsure. Needs campaignId for an ad group as well as the ad group id.
msads_create_ad_group
ChatGPTCreate an ad group in a campaign. It is ALWAYS created paused. Give it a default max CPC bid (keywords without a bid of their own use it). Names must be unique within the campaign. Language is only needed if the campaign has none set. Use dryRun to review.
msads_create_campaign
ChatGPTCreate a search campaign. It is ALWAYS created paused: it cannot spend until someone adds an ad group, keywords and an ad and turns it on with msads_set_status. Give it either its own dailyBudget or a sharedBudgetId (from msads_get_budgets). The time zone defaults to the account's. Bid strategy: EnhancedCpc (default), MaxClicks, or MaxConversions (needs a UET tag and conversion goal, and works best with 30+ conversions a month). Names must be unique in the account. A new budget above 50 per day needs allowLargeChange. Use dryRun to review.
msads_create_conversion_goal
ChatGPTCreate a conversion goal that counts a visit to a page (for example a thank-you page) as a conversion, tied to a UET tag (see msads_get_conversion_tracking for tag ids). It is created PAUSED, so it records nothing until turned on with msads_set_conversion_goal_status. The goal's scope is the account and cannot be changed later. Microsoft turns on automatic click tagging (an msclkid parameter on your landing page URLs) for the account when a conversion goal is added. Because that changes a setting beyond the goal, you must pass acknowledgeAutoTagging: true. Other goal types (events, duration, pages per visit) are not offered here. Use dryRun to review.
msads_create_responsive_search_ad
ChatGPTCreate a responsive search ad in an ad group from headlines and descriptions that Microsoft mixes and matches. It is created PAUSED unless status is 'Active', so it does not serve until someone turns it on. Text limits are checked before anything is sent. Use dryRun to review the ad first. Write ads for the business honestly: do not invent offers, prices or claims the user did not give you.
msads_create_shared_budget
ChatGPTCreate a shared daily budget that several campaigns can draw on. Creating it spends nothing: it only matters once a campaign is linked to it with msads_set_campaign_budget_link. Names must be unique in the account. An amount above 50 per day needs allowLargeChange. Use dryRun to review.
msads_create_uet_tag
ChatGPTCreate a UET tag, the tracking snippet Microsoft Advertising needs on your website to record conversions. This only creates the tag and returns its id and the snippet; it does NOT install it on the site, which is a change to the website someone must make. One tag can serve all goals. Names must be unique for the customer. Use dryRun to review.
msads_get_account_status
ChatGPTThe account's standing: lifecycle status (Active, Pause, ...), any pause reason code, financial status, account mode, payment method type, and when and by whom it was last modified, plus a short needsAttention list. Use it when asked whether the account is in good standing or why ads aren't serving. It cannot read advertiser identity verification, change history, the diagnostics widget or invoices: those are only in the Microsoft Advertising UI, and the result lists them under cannotRead so you can say so. For why a campaign is paused, see msads_get_campaigns (statusMeaning) and msads_get_import_jobs.
msads_get_ad_extensions
ChatGPTList ad extensions (sitelinks, callouts, structured snippets, calls, prices, promotions). With no campaignId or adGroupId this is the account's whole extension library; with one, only the extensions attached to it (ad group attachments override campaign ones). Each extension is shown in one flat shape: id, type, status and its text. An extension in the library that is attached to nothing does not serve.
msads_get_ad_group_performance
ChatGPTAd group performance for a date range (optionally one campaign): impressions, clicks, CTR, average CPC, cost, conversions and cost per conversion, highest spend first.
msads_get_ad_groups
ChatGPTList a campaign's ad groups: id, name, status, default CPC bid, network and language. Structure only - use msads_get_ad_group_performance for results.
msads_get_ads
ChatGPTList an ad group's ads: id, type, status, final URLs and the ad text (headlines and descriptions for responsive search ads; title parts and text for expanded and text ads).
msads_get_budgets
ChatGPTList the account's SHARED budgets: id, name, daily amount, and how many campaigns draw on each. A campaign on a shared budget shows a budgetId in msads_get_campaigns and its own daily budget cannot be changed separately. Campaigns with their own budget are not listed here.
msads_get_campaign_performance
ChatGPTCampaign performance for a date range: impressions, clicks, CTR, average CPC, cost (in the account's currency), conversions, conversion value and cost per conversion, highest spend first. byDay: true returns one row per campaign per day instead of one per campaign. Microsoft generates this as an async report, which usually takes a few seconds.
msads_get_campaigns
ChatGPTList campaigns for an account: id, name, status, type, daily budget and bidding scheme. Structure only (no performance metrics) - use msads_get_campaign_performance for spend and results.
msads_get_conversion_tracking
ChatGPTList the conversion goals (what counts as a conversion: a page visit, an event, time on site, and so on, with its status, count type and value) and the UET tags that feed them, including each tag's tracking status. Use this to find out why conversions are missing: a goal that is paused, or a tag that is not recording, shows here. Conversion numbers themselves are in msads_get_campaign_performance.
msads_get_import_jobs
ChatGPTList the Google Ads import jobs set up on the account: name, status, schedule, last run, who created it, which Google account it reads, and which settings it syncs (campaign status, budgets, bids, locations, deletions), with a plain-English effects list. Use it when a campaign changed or was paused and nobody did it: a scheduled import that syncs status copies a Google Ads pause across at its next run. Only Google Ads imports are listed, not file imports.
msads_get_impression_share
ChatGPTSearch impression share per campaign for a date range, with the share lost to budget and the share lost to rank (bid and quality), all as percentages 0-100. Null where Microsoft reports no value (too little traffic). Low share lost to budget means raise budget; low share lost to rank means raise bids or improve quality score.
msads_get_keyword_ideas
ChatGPTKeyword ideas for up to 20 seed words or phrases, each with average monthly searches (and the 12 monthly counts), Microsoft's suggested bid, competition and relevance, highest volume first. Needs Microsoft's numeric locationIds (from its Geographical Location Codes list), because volumes are per location. Microsoft's docs list keyword ideas as available for the United States, United Kingdom, Canada, Australia, France and Germany. Volumes are estimates and lag by up to about three days.
msads_get_keyword_performance
ChatGPTKeyword performance for a date range (optionally one campaign): match type, quality score (1-10) with its expected CTR, ad relevance and landing page experience ratings, current max CPC bid, and impressions, clicks, CTR, average CPC, cost and conversions, highest spend first. Quality score is null for keywords with too little traffic to score.
msads_get_keywords
ChatGPTList an ad group's keywords: id, text, match type, status and the keyword's own bid (null = inherits the ad group's). Quality score is NOT part of the keyword record in Microsoft's API - use msads_get_keyword_performance, which reports quality score and its three components.
msads_get_location_performance
ChatGPTPerformance by the geographic location of the searcher (country and city) for a date range, optionally one campaign: impressions, clicks, CTR, average CPC, cost and conversions, highest spend first.
msads_get_negative_keywords
ChatGPTList the negative keywords on a campaign, or on one of its ad groups when adGroupId is given: id, text and match type. Negatives block searches; check these before adding more with msads_add_negative_keywords or when wondering why a search term gets no traffic. Shared negative keyword lists are not included.
msads_get_search_terms
ChatGPTThe search queries that triggered ads, for a date range (optionally one campaign): the query, the keyword and match type that matched it, and impressions, clicks, CTR, cost and conversions, highest spend first. Use it to find wasted spend (cost with no conversions) and new keyword ideas.
msads_get_targeting
ChatGPTList a campaign's targeting (locations, radius, device, day and time, age, gender), or an ad group's when adGroupId is given, with each criterion's bid adjustment in percent (+20 = bid 20% more, -100 on a device = excluded) and whether it is an exclusion. A type with nothing set has no restriction. Ad group targeting of a type overrides the campaign's.
msads_list_accounts
ChatGPTList the Microsoft Advertising accounts this connection can read: account id, name, account number, currency, time zone and status. Use the accountId with the other msads_ tools when there is more than one.
msads_remove_ad_group
ChatGPTPermanently delete an ad group, along with its keywords and ads. This cannot be undone and its history stays only in reports. Safety checks: the ad group must already be Paused (use msads_set_status first, so you never delete something that is serving), and confirmName must match the ad group's name exactly. To stop an ad group without losing it, pause it instead. Always run dryRun first: it shows what would be deleted (keyword and ad counts).
msads_remove_negative_keywords
ChatGPTRemove negative keywords from a campaign (or an ad group when adGroupId is given), so ads can show for those searches again. Match them by text; add matchType to remove only that match type. Removing negatives can increase traffic and spend. Returns exactly what was removed so it can be put back with msads_add_negative_keywords. Use dryRun first when unsure.
msads_set_ad_extension_attachment
ChatGPTAttach library extensions to a campaign or an ad group (they start serving there), or detach them (they stop serving there and stay in the library). Use ids from msads_get_ad_extensions. Attaching to an ad group overrides what the campaign has. Use dryRun first when unsure.
msads_set_ad_group_bid
ChatGPTSet an ad group's default max CPC bid, used by every keyword in it that has no bid of its own. A change that more than doubles the current bid is refused unless allowLargeChange is true. Returns the previous bid so it can be undone. Use dryRun first when unsure. Keyword and ad group bids steer delivery under Manual or Enhanced CPC bidding; under an automated bid strategy Microsoft may ignore them.
msads_set_bid_adjustment
ChatGPTSet a campaign's bid adjustment, in percent (20 = bid 20% more, -20 = 20% less, 0 = none), for a device, a location or a day/time slot. For devices this creates the adjustment if there is none. For a location or a day/time slot only an EXISTING one can be changed (see msads_get_targeting): adding one would also change where or when ads show, which this tool does not do. An adjustment above +100, or -100 on a device (which stops ads on it), needs allowLargeChange. Returns the previous adjustment so it can be restored. Use dryRun first when unsure.
msads_set_bidding_strategy
ChatGPTSwitch a campaign between MaxClicks, MaxConversions, EnhancedCpc and ManualCpc. This changes how every bid is set, so it affects spend and delivery, and Microsoft re-learns after a change. Read the campaign first (msads_get_campaigns shows the current strategy). MaxConversions needs an active conversion goal (refused without one) and about 15+ conversions in the last 30 days (refused below that unless acknowledgeLowConversionVolume is true, which should only be set when the user has seen the count and still wants it). Optional targetCpa applies to MaxConversions only (Microsoft no longer offers a separate Target CPA strategy). A campaign's existing max CPC cap is kept when moving between MaxClicks and MaxConversions; Microsoft cannot add a cap back once removed, so removing it needs removeMaxCpc. Returns the previous strategy so it can be undone. Use dryRun first.
msads_set_campaign_budget
ChatGPTSet a campaign's daily budget. This directly changes how much the campaign can spend per day. Only campaigns with their own standard daily budget can be changed here: a campaign on a shared budget, or a lifetime or accelerated budget, is refused with an explanation. A change that more than doubles the budget is refused unless allowLargeChange is true. Returns the previous budget so it can be undone. Use dryRun first when unsure. Microsoft treats a daily budget as a target: actual daily spend can run up to about 20% over it.
msads_set_campaign_budget_link
ChatGPTMove a campaign onto a shared budget (attach), or give it its own daily budget again (detach). Attaching makes the campaign spend from the shared amount, so if that is more than double its current budget it needs allowLargeChange. Detaching needs the campaign's new own dailyBudget. Returns the previous setup so it can be restored. Use dryRun first.
msads_set_conversion_goal_status
ChatGPTTurn a conversion goal on (Active) or off (Paused). A paused goal records no conversions, which changes what msads_get_campaign_performance reports and what automated bidding learns from. Returns the previous status. Use dryRun first.
msads_set_keyword_bid
ChatGPTSet one keyword's own max CPC bid. This changes what the keyword can spend per click. A change that more than doubles the current bid is refused unless allowLargeChange is true. Returns the previous bid so it can be undone. Use dryRun first when unsure. Keyword and ad group bids steer delivery under Manual or Enhanced CPC bidding; under an automated bid strategy Microsoft may ignore them.
msads_set_shared_budget_amount
ChatGPTChange a shared budget's daily amount. This changes the budget of EVERY campaign linked to it (the response says how many). A change that more than doubles it is refused unless allowLargeChange is true. Returns the previous amount so it can be restored. Use dryRun first when unsure.
msads_set_status
ChatGPTPause or resume one campaign, ad group, keyword or ad. Pausing stops it serving and spending; resuming lets it serve again, which can start spending. Only Active and Paused can be set, and an item whose status is something else (for example paused by the budget) is refused rather than overridden. Returns the previous status so the change can be undone. Use dryRun first when unsure. Needs campaignId for an ad group, and adGroupId for a keyword or ad.
msads_update_conversion_goal
ChatGPTChange an existing conversion goal: its name, conversion window, count type (All or Unique) and, depending on its type, the page it matches (Url goals: urlExpression/urlOperator) or the event action it matches (Event goals: actionExpression/actionOperator). Only the fields you pass change. Pause or resume a goal with msads_set_conversion_goal_status instead. Changing a live goal changes what msads_get_campaign_performance reports and what automated bidding learns from. Returns before and after values. Use dryRun first.
msads_update_responsive_search_ad
ChatGPTChange a responsive search ad's headlines, descriptions, final URL or display paths. Only what you pass is changed, but a list of headlines or descriptions REPLACES the whole existing list, so send the complete new set. Editing a live ad sends it back for Microsoft's review. Returns the previous text so it can be restored. Use dryRun first.
pagespeed_audit
ChatGPTRun Google PageSpeed Insights (Lighthouse) on one public page right now: performance, SEO, accessibility and best-practices scores (0-100), lab LCP / TBT / CLS, and the top fixes ranked by estimated time saved (e.g. 'Properly size images - save ~1.4 s'), plus the failed SEO and accessibility checks. Also includes the page's real-user field data when Google has it. Takes 10-30 seconds. Use it to explain WHY a page is slow; for whether it's slow for real users, or for many pages at once, use pagespeed_core_web_vitals.
pagespeed_core_web_vitals
ChatGPTReal-user Core Web Vitals from the Chrome UX Report: the 75th-percentile LCP, INP and CLS (plus FCP and TTFB) that Chrome users actually experienced over the last 28 days, each rated good / needs improvement / poor, and whether the page passes Google's Core Web Vitals assessment. This is the data Google uses in ranking. Fast (about a second) and works for ANY public site, including competitors. Pass up to 10 URLs to compare pages - for 'which of my busiest pages are slow?', first get top landing pages from Google Analytics (run_report with landingPage) or Search Console, then pass their full URLs here. A URL with too little traffic falls back to its whole site (origin) and says so. Use pagespeed_audit for the reasons a page is slow.
pagespeed_core_web_vitals_history
ChatGPTWeekly trend of real-user LCP, INP and CLS (75th percentile, each point a rolling 28-day window) for a page or a whole site, for up to about 9 months. Answers 'did our site get slower, and when?' - flags the week a metric crossed into a worse rating. Compare the date with GA4 conversions or a deploy to find the cause.
reddit_breakdown_report
ChatGPTWhere is the spend working? Performance for a date range split by one dimension: placement (feed vs conversation), country, region, device operating system, gender, interest, targeted keyword, language, or creative asset. Impressions, clicks, CTR, average CPC, spend and conversions for each value, highest spend first (add events ['sign_up'] for sign-ups and cost per sign-up). Reddit allows one breakdown at a time, so call it again for another question; optionally limit to one campaign. Days are UTC and the last day or two can still change for about 6 hours. For subreddits use reddit_community_report.
reddit_change_history
ChatGPTWho changed what on the Reddit ad account, newest first: the person (Reddit username or name), when, which campaign, ad group or ad, which field, and the value before and after. Defaults to the last 14 days; optionally limited to one campaign, ad group or ad (its children included). Use it to explain a sudden change in results or to see what a teammate or agency changed. Budgets and bids are shown in the account currency as well as Reddit's raw value.
reddit_conversion_health
ChatGPTIs Reddit receiving my conversion events? For each Reddit pixel on the ad account, when each standard event (PageVisit, SignUp, Purchase, Lead, ...) and each custom event last fired, flagged firing, stale (over 48 hours) or never fired, next to the conversions Reddit counted in the last 7 days and the spend. Use it when conversions drop to zero or after changing tracking. The times are when Reddit last received the event, whether it came from the pixel or the Conversions API.
reddit_create_ad
ChatGPTCreate an ad in an ad group from an existing post (reddit_create_post gives the postId), ALWAYS PAUSED. Previews by default (dryRun true). The ad can't run until its ad group and campaign are also started, and Reddit's ad review has approved it; use reddit_health_check to see what is blocking delivery, then reddit_set_status to start each level. Needs writes on for the ad account. Refuses a duplicate name in the ad group.
reddit_create_ad_group
ChatGPTCreate an ad group in a campaign, ALWAYS PAUSED, targeting the given communities (and optionally countries, interests and keywords). Previews by default (dryRun true). If the campaign has its own budget (campaign budget optimization) leave out dailyBudget and the ad group uses the campaign's budget and bidding; otherwise dailyBudget is required. Give bidValue (max cost per click) for manual bidding, or omit it to let Reddit maximize clicks. Check communities and reach first with reddit_find_communities and reddit_estimate_campaign. Needs writes on for the ad account. Refuses a duplicate name in the campaign.
reddit_create_campaign
ChatGPTCreate a Reddit campaign, ALWAYS PAUSED (starting it is a separate step: reddit_set_status). Previews by default (dryRun true) and shows the exact request; set dryRun false only after the user agrees. With dailyBudget the budget sits on the campaign and Reddit splits it across the campaign's ad groups (campaign budget optimization; it needs a pixel, which is used automatically if the account has one). Without it, each ad group gets its own budget. Needs writes switched on for the ad account. Refuses a duplicate name.
reddit_create_post
ChatGPTCreate the post (the creative) for a Reddit ad: an image with a headline, optional text, and a destination link with a call-to-action button, posted from a brand profile (see reddit_list_profiles). Give a public https imageUrl; Reddit downloads it itself. Previews by default (dryRun true). It creates the post only, not an ad, so nothing runs or spends; use the returned post id with reddit_create_ad. Reddit builds the post asynchronously, so this waits briefly and, if it is still processing, returns a jobId to check later by calling again with just jobId. Put UTM tags on destinationUrl (utm_campaign equal to the campaign name).
reddit_estimate_campaign
ChatGPTBefore spending anything: for one ad group's communities and a daily budget, Reddit's estimate of the targetable audience and the weekly impressions and clicks (as min-max ranges), plus the implied cost per click and Reddit's suggested bid range. Pass the community names from reddit_find_communities. Optionally add countries, interests and keywords (look them up with reddit_targeting_options). Estimates only; nothing is created or changed. Call it once per ad group. Devices and age aren't set here, so it estimates all of them.
reddit_find_communities
ChatGPTSearch Reddit communities (subreddits) that ads can target, with Reddit's own subscriber counts, largest first. Use query to search by name or topic (e.g. 'ppc', 'agency'), or keywords (comma-separated topics) and/or websiteUrl to get Reddit's suggested communities for a product or site. Only communities that can be targeted are listed, so one that doesn't appear can't be targeted with ads. Subscribers are not the same as people who would see an ad; use reddit_estimate_campaign for reach and clicks. Not specific to one ad account.
reddit_get_ad_groups
ChatGPTAd groups with their targeting (communities, interests, locations, devices), bid and budget, optionally for one campaign.
reddit_get_ads
ChatGPTAds with their headline, destination and status, optionally for one campaign or ad group.
reddit_get_campaigns
ChatGPTCampaigns in a Reddit ad account with objective, status, budget and schedule. Use status to show only ACTIVE or PAUSED ones. Pair with reddit_performance_report for numbers.
reddit_health_check
ChatGPTIs my Reddit campaign delivering, and if not, why? One call that checks: ads, ad groups and campaigns that are set to run but Reddit won't serve (rejected, in review, billing or identity holds, paused parent); the account's standing and funding (can it serve, near its credit limit); active ad groups with no impressions in the last 3 days; daily budgets going mostly unspent; and conversion tracking. Returns an overall verdict and a list of issues, each with what it means and what to do. Read-only. Run it after launching a campaign, and whenever results drop.
reddit_list_ad_accounts
ChatGPTThe Reddit ad accounts this connection can read (id, name, currency, time zone, business). Start here when the account is unknown: the other Reddit tools take its id as accountId and pick it automatically when there is only one.
reddit_list_profiles
ChatGPTThe Reddit profiles an ad account can post ads from (id and name). Needed to create the post for an ad (reddit_create_post). Use the brand profile; ads should not post from a person's own account.
reddit_performance_report
ChatGPTPerformance for a date range at account, campaign, ad group or ad level: impressions, clicks, CTR, average CPC, CPM, spend, conversions and cost per conversion, highest spend first, with names. Set byDay for one row per day. Days are UTC (not the account time zone), and the last day or two can still change for about 6 hours. Reach and frequency are not offered because they can't be added across days. Conversions count Reddit's key conversion event under Reddit's own attribution, so don't compare them directly with Google Ads or GA4.
reddit_set_status
ChatGPTPause or resume ONE Reddit campaign, ad group or ad (status PAUSED or ACTIVE). Previews by default (dryRun true) and shows before and after; set dryRun false only after the user agrees. Resuming can start spending money. Only works where the user has allowed changes for the ad account in the Caybl.ai dashboard. Nothing is ever archived or deleted. The result says whether the item will actually deliver (a resumed ad in a paused campaign still won't).
reddit_targeting_options
ChatGPTLook up what an ad group can be targeted by, beyond communities. kind 'geolocations': countries, regions or cities (give country as an ISO code like 'US', and optionally query to search city names), returning ids to use as countries. kind 'interests': Reddit's interest categories (optionally filtered by query). kind 'keywords': keyword ideas for one or more seed terms (comma-separated in query) with each keyword's monthly views on Reddit, highest first. Use the results in reddit_estimate_campaign. Not specific to one ad account.
reddit_vs_ga4_conversions
ChatGPTCompare what Reddit reports (clicks, spend, conversions, by campaign) with what Google Analytics 4 recorded from Reddit traffic (sessions and key events, matched by utm_campaign = campaign name). Shows the gap and likely reasons: campaigns with no UTM tags, GA seeing far fewer sessions than Reddit counts clicks, and untagged referral traffic from reddit.com. Needs Google Analytics connected for the GA side; without it only Reddit's side is returned. Reddit conversions use Reddit's attribution and the account's key conversion event, so the two will never match exactly.
remove_campaign_criterion
ChatGPTUndo one location, device exclusion, ad schedule block, or negative keyword set by set_campaign_targeting or add_negative_keywords - e.g. 'actually don't exclude mobile after all'. Criteria don't have a paused state like campaigns/ads do; this removes it outright.
run_funnel_report
ChatGPTRun a GA4 funnel report (Data API v1alpha). Provide ordered funnelSteps (simple form: {name, dimension, matchValue}) or a raw funnel object for advanced funnels. NOTE: funnels use the Exploration schema, which supports fewer dimensions than run_report - pagePath is NOT valid here and is mapped to unifiedPagePathScreen. Use eventName to match events.
run_gaql_report
ChatGPTRun an arbitrary read-only Google Ads Query Language (GAQL) SELECT against an account and return the raw rows. The power tool for anything the structured tools don't cover. Only SELECT is allowed.
run_realtime_report
ChatGPTRun a GA4 realtime report (active users right now, by dimension). The Realtime API only supports a small fixed schema - dimensions: appVersion, audienceId, audienceName, audienceResourceName, city, cityId, country, countryId, deviceCategory, eventName, minutesAgo, platform, streamId, streamName, unifiedScreenName, plus customUser:<parameter_name>; metrics: activeUsers, eventCount, keyEvents, screenPageViews. Most of run_report's ~150 dimensions/metrics (e.g. pagePath, sessionSource) aren't valid here - use run_report instead for anything outside this list.
run_report
ChatGPTRun a GA4 report via the Data API. Dimensions × metrics over a date range, with optional dimensionFilter/metricFilter (GA4 FilterExpression objects), orderBys, offset pagination, and multiple dateRanges. Example: device usage by page = dimensions [pagePath, deviceCategory], metric [screenPageViews]. GA4 allows at most 4 dateRanges per run_report call - split more into separate calls and combine the results. GA4 counts dimensions referenced in dimensionFilter toward the 9-dimension nested-request limit, on top of the dimensions array - reduce the dimensions requested or simplify the filter. A numericFilter needs its comparison value wrapped as { int64Value: '10' } (string) or { doubleValue: 10.5 }, not a bare number - e.g. { fieldName: 'sessions', numericFilter: { operation: 'GREATER_THAN', value: { int64Value: '10' } } }. A bare value: 10 passes schema validation here but GA4 rejects it at request time with "value is missing from NumericFilter" since it never finds anything under int64Value/doubleValue.
run_search_analytics_report
ChatGPTOrganic search performance for a property: clicks, impressions, CTR, and average position, broken down by the dimensions you choose (query, page, country, device, date, searchAppearance). Filter to a search type (web/image/video/news/discover/googleNews) - discover and googleNews cover Google's Discover feed and Google News; searchAppearance as a dimension is the closest proxy the API currently offers for isolating AI Overview / rich-result rows, since there is no dedicated AI Overview search type yet. Defaults to the last 28 days (Search Console's own default). Use pageFilters to narrow to (or exclude) a URL pattern server-side - e.g. notContains on /dashboard/ and /authenticate/ to drop internal traffic that would otherwise crowd out marketing pages - rather than requesting the maximum rowLimit and filtering client-side. For an exact-URL allowlist ("only these known-good pages"), use the in operator instead of a hand-written regex - it avoids the notContains-as-denylist mismatch and chunks itself automatically to stay under Google's undocumented filter-size ceiling (may take more than one upstream call for a large list). Large requests are paged internally in batches of up to 5000 rows and will stop early with nextStartRow set if they run long, rather than risk a request timeout - pass that back as startRow to continue. collapseVariants merges query-string/scheme duplicates of the same page; brandKeywords adds a derived branded/non-branded field per query row.
set_campaign_targeting
ChatGPTAdd location targeting, device exclusions, and/or an ad schedule (day-parting) to a Google Ads campaign. A campaign with no locations serves everywhere Google allows, so set locations before enabling a campaign meant for specific markets. Locations and schedule blocks are added alongside existing ones. Excluding a device sets that device's bid adjustment to -100%, which overwrites any adjustment already set for it. Undo any of these with remove_campaign_criterion.
submit_sitemap
ChatGPTTell Google to (re)fetch a sitemap - the natural next step after editing pages based on performance data, so the change is picked up rather than waiting for the next crawl. Requires write access on this property (auth/scopes.ts) - refuses cleanly if the connection or this specific property has changes switched off.
update_ad_group
ChatGPTChange an ad group's status and/or its default max CPC. Raising the bid raises what each click can cost. REMOVED is permanent.
update_ad_status
ChatGPTChange a single ad's status within its ad group. REMOVED is permanent.
update_campaign
ChatGPTChange a campaign's name, reassign it to a different budget, or switch its bidding strategy - everything about a campaign except status (use update_campaign_status for that). Useful for the common pattern of starting on MANUAL_CPC to see real auction behaviour, then moving to an automated strategy once there's data to bid on, without recreating the campaign.
update_campaign_budget
ChatGPTChange the daily amount on an existing campaign budget. This directly changes how much the campaigns on that budget can spend per day - dry-run it first if you are unsure.
update_campaign_status
ChatGPTChange a campaign's status. ENABLED starts it serving and spending; PAUSED stops delivery and is reversible; REMOVED is permanent and cannot be undone through the API or the Ads UI.
update_ga4_conversion_action
ChatGPTUpdate settings on a Google Ads conversion action that Google has already synced from a linked GA4 property's key event (see create_google_ads_link and mark_key_event in the Google Analytics connector - Google imports it automatically once both exist; there is no Ads API call to create or trigger that import). Use this to set primaryForGoal true, which is what actually makes it usable as a MAXIMIZE_CONVERSIONS bidding goal. Find the conversion action id first with run_gaql_report, e.g. "SELECT conversion_action.id, conversion_action.name, conversion_action.google_analytics_4_settings.event_name FROM conversion_action WHERE conversion_action.type IN ('GOOGLE_ANALYTICS_4_CUSTOM','GOOGLE_ANALYTICS_4_PURCHASE','GOOGLE_ANALYTICS_4_GENERATE_LEAD','GOOGLE_ANALYTICS_4_QUALIFY_LEAD','GOOGLE_ANALYTICS_4_CLOSE_CONVERT_LEAD')" (enum fields reject LIKE/wildcards - see run_gaql_report). Note: includeInConversionsMetric is immutable on a GA4-synced action once Google has set it - expect an IMMUTABLE_FIELD error if you try to change it; primaryForGoal and status remain changeable.
update_keyword
ChatGPTChange an existing keyword's status (PAUSED/ENABLED, or REMOVED to delete it permanently) and/or its max CPC bid. add_keywords can only add new keywords - this is how to act on one that's already there, e.g. pausing an underperformer found via get_search_terms.