Every Camberstack tool
These are the 39 tools your AI assistant gets when you connect Camberstack. This page is built from the same definitions the server uses, so it always matches what's live, and the descriptions are the ones your AI reads. The code is open source: read it on GitHub.
Read-only tools never change anything. Changes nothing in Google
tools prepare or manage proposals. Only apply_changes changes anything in Google Ads, Search Console, Google Analytics, Merchant Center or Tag Manager, and only after you approve a specific proposal.
disconnect asks you to confirm before it revokes access.
list_accounts List Google Ads accounts
Read-onlyLists every Google Ads account this login can reach, including client accounts under a manager (MCC). Start here. spentLast30Days says whether an account had ad spend in the last 30 days (show it when the user picks one). When the user's plan is at its limit, each account also says whether the plan covers it (plan_status: active or locked).
account_overview Account overview
Read-onlySpend, clicks, conversions and cost per conversion per campaign over a window, plus `attention` when something needs a look: disapproved ads, Google's recommendations, conversions that stopped or went quiet, short calls not counted, keyword URLs overriding the ad's, recent bid strategy changes, and wording attorney advertising rules restrict.
| Parameter | What it is |
|---|---|
customer_id | Google Ads customer ID, with or without dashes (from list_accounts) Required. |
days | Look-back window in days, ending yesterday Default 30. |
local_services_report Local Services ads report
Read-onlyLocal Services ads (read-only): spend per Local Services campaign, leads by type, status, charge and credit, and Google's verification checks on the business. No lead contact details.
| Parameter | What it is |
|---|---|
customer_id | Google Ads customer ID, with or without dashes (from list_accounts) Required. |
days | Look-back window in days Default 30. |
run_gaql Run a read-only GAQL query
Read-onlyRuns any read-only Google Ads Query Language SELECT for questions the other tools don't cover. Returns up to 500 rows. Google rejects queries that break these rules: selecting or segmenting by segments.date needs a finite range in WHERE (segments.date DURING LAST_30_DAYS, or BETWEEN 'YYYY-MM-DD' AND 'YYYY-MM-DD'); click_view needs a single day (segments.date = 'YYYY-MM-DD'); every field used in WHERE or ORDER BY must also be in SELECT. Maximize clicks is target_spend in the API: campaign.target_spend.cpc_bid_ceiling_micros (there is no campaign.maximize_clicks). Unsure of a field's name or whether it fits this FROM? Look it up first with a query that has no FROM, which reads Google's field catalog instead of the account (any customer_id): SELECT name, category, selectable WHERE name LIKE '%search_term%', or SELECT attribute_resources, metrics, segments WHERE name = 'campaign' for what can be used FROM campaign.
| Parameter | What it is |
|---|---|
customer_id | Google Ads customer ID, with or without dashes (from list_accounts) Required. |
query | A GAQL SELECT statement Required. |
keyword_ideas Keyword ideas (Keyword Planner)
Read-onlyGoogle Keyword Planner ideas from seed keywords, a landing-page URL or a whole site: average and monthly searches, competition and the top-of-page bid range in the account's currency, biggest first. Ideas the account already targets, or already blocks as negatives, are marked in_account. Changes nothing.
| Parameter | What it is |
|---|---|
customer_id | Google Ads customer ID, with or without dashes (from list_accounts) Required. |
keywords | Up to 20 seed keywords Optional. |
url | A page to pull ideas from, such as the ad's landing page Optional. |
site | A whole site's domain, yours or a competitor's (example.com), on its own Optional. |
location_ids | Where to count searches; leave out for where the account's campaigns target. Each a geo target id (2840 United States, 2040 Austria), a country or its code ("Austria", "AT"), or a place ("Springfield, Illinois") Optional. |
language_id | Language id (1000 English, 1001 German), name or code ("de"). Leave out for the campaigns' language, or every language when you name locations Optional. |
months | Months of history to last month: 12 if left out, 48 most Optional. |
min_searches | Drop ideas below this many average monthly searches Default 0. |
limit | Most ideas to return Default 50. |
keyword_metrics Keyword volume and bids (Keyword Planner)
Read-onlyGoogle Keyword Planner numbers for an exact list of keywords: average and monthly searches, competition and the top-of-page bid range in the account's currency. Use it to size keywords before adding them or to check a trend. Send the whole list in one call, not one per keyword: Keyword Planner rate-limits bursts. Over 100 come back as a compact table (columns, months, rows). Changes nothing.
| Parameter | What it is |
|---|---|
customer_id | Google Ads customer ID, with or without dashes (from list_accounts) Required. |
keywords | Keywords to look up, up to 500 Required. |
location_ids | Where to count searches; leave out for where the account's campaigns target. Each a geo target id (2840 United States, 2040 Austria), a country or its code ("Austria", "AT"), or a place ("Springfield, Illinois") Optional. |
language_id | Language id (1000 English, 1001 German), name or code ("de"). Leave out for the campaigns' language, or every language when you name locations Optional. |
months | Months of history to last month: 12 if left out, 48 most Optional. |
by_location | Also count each location alone, to compare markets (up to 100 keywords) Optional. |
search_console_sites List Search Console sites
Read-onlyLists the websites (Search Console properties) this Google login can read. Use a site_url from here in the other Search Console tools.
search_console_summary Search Console summary
Read-onlyA website's total organic Google Search clicks, impressions, CTR and average position over a window, next to the same number of days before it, with the change. Site-wide totals, more complete than adding up per-query rows. Changes nothing.
| Parameter | What it is |
|---|---|
site_url | Search Console property exactly as search_console_sites lists it, e.g. sc-domain:example.com or https://www.example.com/ Required. |
days | Look-back window in days, ending 3 days ago (yesterday with fresh) Default 28. |
start_date | Exact first day, YYYY-MM-DD. Pass with end_date to use exact dates instead of days Optional. |
end_date | Exact last day, YYYY-MM-DD Optional. |
fresh | Include the last 2-3 days, which Google is still filling in (they read low). Use to check something from the last few days Default false. |
search_console_performance Search Console performance
Read-onlyOrganic Google Search clicks, impressions, CTR and average position for a website, grouped by query, page, country, device or date, most clicks first. Search Console's last 2-3 days are incomplete, so the window ends 3 days ago unless fresh is set. Group by query and page together to see whether several pages compete for the same search; by page and date to see when a page's impressions or position changed. Changes nothing.
| Parameter | What it is |
|---|---|
site_url | Search Console property exactly as search_console_sites lists it, e.g. sc-domain:example.com or https://www.example.com/ Required. |
days | Look-back window in days, ending 3 days ago (yesterday with fresh) Default 28. |
start_date | Exact first day, YYYY-MM-DD. Pass with end_date to use exact dates instead of days Optional. |
end_date | Exact last day, YYYY-MM-DD Optional. |
fresh | Include the last 2-3 days, which Google is still filling in (they read low). Use to check something from the last few days Default false. |
dimensions | What to group by Default ["query"]. |
query_contains | Only queries containing this text Optional. |
page_contains | Only pages whose URL contains this text Optional. |
query_regex | Only queries matching this RE2 regex Optional. |
exclude_query_regex | Leave out queries matching this RE2 regex, typically the brand name, e.g. (?i)acme|ac me Optional. |
page_regex | Only pages whose URL matches this RE2 regex Optional. |
limit | Most rows to return Default 50. |
search_console_trend Search Console trend
Read-onlyCompares a window with the same number of days right before it, query by query and page by page: rising, falling, new and lost queries, rising searches the site is losing position on, and rising and falling pages. Totals are the site's true totals. Changes nothing.
| Parameter | What it is |
|---|---|
site_url | Search Console property exactly as search_console_sites lists it, e.g. sc-domain:example.com or https://www.example.com/ Required. |
days | Look-back window in days, ending 3 days ago (yesterday with fresh) Default 28. |
start_date | Exact first day, YYYY-MM-DD. Pass with end_date to use exact dates instead of days Optional. |
end_date | Exact last day, YYYY-MM-DD Optional. |
fresh | Include the last 2-3 days, which Google is still filling in (they read low). Use to check something from the last few days Default false. |
exclude_query_regex | Leave out queries matching this RE2 regex, typically the brand name, e.g. (?i)acme|ac me Optional. |
min_impressions | Skip queries and pages under this many impressions in both windows Default 10. |
limit | Most rows in each list Default 25. |
search_console_opportunities Search Console opportunities
Read-onlyFinds where more organic clicks are within reach: queries on positions 4-20 with the clicks a realistic climb would add, top-5 queries with an unusually low click-through rate (a title or description to fix), and question-shaped queries. Changes nothing.
| Parameter | What it is |
|---|---|
site_url | Search Console property exactly as search_console_sites lists it, e.g. sc-domain:example.com or https://www.example.com/ Required. |
days | Look-back window in days, ending 3 days ago (yesterday with fresh) Default 90. |
start_date | Exact first day, YYYY-MM-DD. Pass with end_date to use exact dates instead of days Optional. |
end_date | Exact last day, YYYY-MM-DD Optional. |
fresh | Include the last 2-3 days, which Google is still filling in (they read low). Use to check something from the last few days Default false. |
exclude_query_regex | Leave out queries matching this RE2 regex, typically the brand name, e.g. (?i)acme|ac me Optional. |
limit | Most rows in each list Default 25. |
search_console_inspect_urls Inspect URLs in Google's index
Read-onlyGoogle's index record for each page: indexed or not and the reason (for example "Discovered - currently not indexed"), last crawl, robots.txt and fetch result, the canonical Google chose against the one the page declares, and structured-data items with their errors. Use it when a page gets no impressions, or seems to have dropped, before assuming a ranking problem. Changes nothing.
| Parameter | What it is |
|---|---|
site_url | Search Console property exactly as search_console_sites lists it, e.g. sc-domain:example.com or https://www.example.com/ Required. |
urls | Full page URLs inside the property, up to 20 per call (Google allows 2,000 a day per site) Required. |
search_console_sitemaps Search Console sitemaps
Read-onlyThe sitemaps submitted for a website: when Google last downloaded each one, how many URLs it lists, and its error and warning counts. Changes nothing: propose_search_console_changes submits one.
| Parameter | What it is |
|---|---|
site_url | Search Console property exactly as search_console_sites lists it, e.g. sc-domain:example.com or https://www.example.com/ Required. |
propose_search_console_changes Propose Search Console changes (applies nothing)
Changes nothing in GoogleChecks Search Console changes against the live property and stores them as a proposal with a plain-English summary; nothing is changed. Show the summary to the user and apply only after they approve, with apply_changes (undo_changes reverses it, except where a ⚠ line says it can't). Supported: submit_sitemap (also resubmits, so Google reads it again), delete_sitemap, add_site (unless the login already owns the domain, it stays unverified until the user verifies ownership in Search Console), remove_site. Requesting indexing isn't possible through Google's API. A connection made before editing existed answers with a link that adds it. Point out any ⚠ line before they approve.
| Parameter | What it is |
|---|---|
changes | Changes to propose; several can go in one proposal Required. |
paid_organic_overlap Paid vs organic overlap
Read-onlyJoins a Google Ads account's search terms with a website's Search Console queries over the same days. Returns paid_and_ranking (searches you pay for where the site already ranks near the top organically, with ad spend) and organic_gaps (searches the site shows up for on page 2 or lower with no ad or keyword). Changes nothing; follow up with propose_changes.
| Parameter | What it is |
|---|---|
customer_id | Google Ads customer ID, with or without dashes (from list_accounts) Required. |
site_url | Search Console property exactly as search_console_sites lists it, e.g. sc-domain:example.com or https://www.example.com/ Required. |
days | Look-back window in days, ending 3 days ago Default 90. |
max_position | paid_and_ranking: average organic position at or better than this Default 3. |
min_impressions | organic_gaps: only queries with at least this many impressions Default 100. |
limit | Most rows in each list Default 25. |
analytics_properties List Google Analytics properties
Read-onlyLists the Google Analytics 4 properties this Google login can read. Use a property_id from here in the other Google Analytics tools. If Google Analytics isn't part of the connection yet, says so and returns grant_url, a personal link the user opens to add it.
analytics_setup Google Analytics setup
Read-onlyHow a GA4 property is set up: its web streams with their measurement IDs (what the site's tag must use), which events are key events (GA4's conversions), which Google Ads accounts it's linked to, and its custom dimensions and metrics with the name analytics_report takes. Check this before proposing setup changes. Changes nothing.
| Parameter | What it is |
|---|---|
property_id | GA4 property id, digits only (from analytics_properties) Required. |
propose_analytics_changes Propose Google Analytics changes (applies nothing)
Changes nothing in GoogleChecks Google Analytics setup changes against the live property and stores them as a proposal with a plain-English summary; nothing is changed. Show the summary to the user and apply only after they approve, with apply_changes (undo_changes reverses it). Supported: create_ga4_property (a property plus a web stream; the applied result gives the measurement ID and the tag the site needs), mark_key_event / unmark_key_event (GA4's conversions), set_key_event_counting (also recounts a Google Ads import of it), link_google_ads / unlink_google_ads, register_custom_dimension / register_custom_metric (make a parameter reportable), set_custom_metric_unit, archive_custom_dimension / archive_custom_metric. Point out any ⚠ line before they approve.
| Parameter | What it is |
|---|---|
changes | Changes to propose; several can go in one proposal Required. |
analytics_landing_pages Google Analytics landing pages
Read-onlyWhere visitors land and whether it works: sessions, users, engagement rate, key events (GA4's conversions) and key event rate per landing page, most sessions first. Pass channel to see one source, e.g. "Paid Search" for Google Ads traffic or "Organic Search". Changes nothing.
| Parameter | What it is |
|---|---|
property_id | GA4 property id, digits only (from analytics_properties) Required. |
days | Look-back window in days, ending yesterday Default 28. |
start_date | Exact first day, YYYY-MM-DD. Pass with end_date to use exact dates instead of days Optional. |
end_date | Exact last day, YYYY-MM-DD Optional. |
channel | Only sessions whose default channel group contains this, e.g. Paid Search, Organic Search, Direct Optional. |
limit | Most landing pages to return Default 25. |
analytics_report Run a Google Analytics report
Read-onlyAny GA4 report: dimensions and metrics by their GA4 API names, highest first. Common dimensions: date, landingPage, pagePath, sessionDefaultChannelGroup, sessionSourceMedium, sessionCampaignName, sessionGoogleAdsCampaignName, deviceCategory, country, eventName. Common metrics: sessions, totalUsers, engagedSessions, engagementRate, keyEvents, sessionKeyEventRate, screenPageViews, ecommercePurchases, purchaseRevenue. For Google search queries, clicks and positions use search_console_performance: GA4's organicGoogleSearch* fields need Search Console linked in GA4 and combine with few dimensions. Changes nothing.
| Parameter | What it is |
|---|---|
property_id | GA4 property id, digits only (from analytics_properties) Required. |
days | Look-back window in days, ending yesterday Default 28. |
start_date | Exact first day, YYYY-MM-DD. Pass with end_date to use exact dates instead of days Optional. |
end_date | Exact last day, YYYY-MM-DD Optional. |
dimensions | GA4 dimension names; none gives totals Default []. |
metrics | GA4 metric names Required. |
filter | Only rows whose dimension contains this text (case-insensitive) Optional. |
order_by | A requested metric (highest first) or dimension (A to Z, dates oldest first); defaults to the first metric Optional. |
limit | Most rows to return Default 50. |
landing_page_speed Landing page speed (PageSpeed Insights)
Read-onlyGoogle PageSpeed Insights: whether real visitors get a fast page (Core Web Vitals from Chrome, last 28 days), a Lighthouse score, and the fixes worth most. Use it on ad landing pages (from landing_page_view or analytics_landing_pages) when clicks don't convert; landing-page experience is part of Quality Score. Any public URL. Takes 10-40s. Changes nothing.
| Parameter | What it is |
|---|---|
urls | Page URLs, up to 5 Required. |
strategy | Device to test as Default "mobile". |
fixes | Fixes per page Default 5. |
tag_manager_containers List Tag Manager containers
Read-onlyLists the Google Tag Manager web containers this Google login can read. Use a container from here in the other Tag Manager tools, and an account_id to create a container in (create_container). If Tag Manager isn't part of the connection yet, says so and returns grant_url, a personal link the user opens to add it.
tag_manager_setup Tag Manager setup and tracking check
Read-onlyA container's tags (what each sends where, and when it fires), its triggers, what isn't published yet, and `issues`: tracking problems worth fixing, such as a Google Ads conversion tag with no Conversion Linker or firing on every page, a tag that never fires, or retired Universal Analytics. Use it when conversions are missing or look wrong. Changes nothing.
| Parameter | What it is |
|---|---|
container | The container, as tag_manager_containers lists it, e.g. accounts/123/containers/456 Required. |
propose_tag_manager_changes Propose Tag Manager changes (applies nothing)
Changes nothing in GoogleChecks Tag Manager changes against the container's workspace and stores them as a proposal with a plain-English summary; nothing is changed. Show the summary to the user and apply only after they approve, with apply_changes (undo_changes reverses it). Supported: create_container, delete_container, add_google_tag, add_ads_conversion_tag, add_ga4_event_tag, add_conversion_linker, pause_tag, unpause_tag, delete_tag, and publish_container. Tag changes stay in the workspace until publish_container makes them live: include it to put them on the site (it runs last). Point out any ⚠ line before they approve.
| Parameter | What it is |
|---|---|
changes | Changes to propose; several can go in one proposal Required. |
merchant_accounts List Merchant Center accounts
Read-onlyLists the Google Merchant Center accounts this Google login can read, including sub-accounts of an advanced (multi-client) account. Use an account_id from here in the other Merchant Center tools. If Merchant Center isn't part of the connection yet, says so and returns grant_url, a personal link the user opens to add it.
merchant_product_issues Merchant Center product issues
Read-onlyWhy products aren't showing on Google (Shopping ads and free listings): the account's own issues, how many products are eligible, limited, pending or disapproved, and every product issue (such as a price mismatch or a missing GTIN) with how many products it affects, worst first, and a few example products. With offer_id, that one product's issues in full. Use it when Shopping or Performance Max spend or clicks drop, or products are missing. Changes nothing.
| Parameter | What it is |
|---|---|
account_id | Merchant Center account ID, digits only (from merchant_accounts) Required. |
offer_id | One product's ID as in the feed (offer_id), to see its issues in full Optional. |
examples | Example products listed per issue Default 5. |
merchant_report Run a Merchant Center report
Read-onlyRuns a read-only Merchant Center Query Language (MCQL) query on one account and returns up to `limit` rows. One view per query. product_performance_view: segments date, week, offer_id, title, brand, marketing_method (ADS or ORGANIC), customer_country_code, category_l1…l5, product_type_l1…l5, custom_label0…4; metrics clicks, impressions, click_through_rate (conversions, conversion_value and conversion_rate count free listings only). It needs a date range and at least one metric, e.g. SELECT offer_id, title, clicks, impressions FROM product_performance_view WHERE date DURING LAST_30_DAYS AND marketing_method = 'ADS' ORDER BY clicks DESC LIMIT 50. product_view (current status): id, offer_id, title, brand, price, availability, gtin, feed_label, aggregated_reporting_context_status (ELIGIBLE, ELIGIBLE_LIMITED, PENDING, NOT_ELIGIBLE_OR_DISAPPROVED), item_issues, click_potential (LOW, MEDIUM, HIGH); id must be selected. Also price_competitiveness_product_view, price_insights_product_view and best_sellers_product_cluster_view. WHERE joins conditions with AND only (no OR); dates as date BETWEEN 'YYYY-MM-DD' AND 'YYYY-MM-DD' or date DURING LAST_7_DAYS / LAST_30_DAYS. Reports work on standalone accounts and sub-accounts, not on an advanced account itself. Changes nothing.
| Parameter | What it is |
|---|---|
account_id | Merchant Center account ID, digits only (from merchant_accounts) Required. |
query | An MCQL SELECT statement Required. |
limit | Most rows to return Default 500. |
merchant_ad_spend Merchant Center issues by ad spend
Read-onlyWhich Merchant Center problems cost money: products that are disapproved, limited or pending, joined with what they earned in Shopping and Performance Max ads (cost, clicks, conversions, conversion value) over the window, most value first, and whether each has stopped spending in the last 7 days. Use it when Shopping or Performance Max results drop, before fixing issues one by one. Changes nothing.
| Parameter | What it is |
|---|---|
customer_id | Google Ads customer ID, with or without dashes (from list_accounts) Required. |
account_id | Merchant Center account ID, digits only (from merchant_accounts) Required. |
days | Look-back window in days, ending yesterday; reach back before a drop Default 30. |
limit | Most products to return Default 25. |
propose_merchant_changes Propose Merchant Center changes (applies nothing)
Changes nothing in GoogleChecks Merchant Center product changes against the live account and stores them as a proposal with a plain-English summary; nothing is changed. Show the summary to the user and apply only after they approve, with apply_changes (undo_changes reverses it). Supported: set_product_attributes (override a product's price, sale price, GTIN, brand, title, availability, …, e.g. to fix a price mismatch or a missing GTIN), exclude_products / include_products (from Shopping ads or free listings), clear_product_overrides; and add_product / update_product / delete_product for products Camberstack creates in its own data source. Changes to products from the merchant's feed are overrides in Camberstack's own supplemental data source, layered on top: the feed itself is never edited. Point out any ⚠ line before they approve. A fix in the feed or the store (Shopify, …) lasts longer: suggest it too.
| Parameter | What it is |
|---|---|
account_id | Merchant Center account ID, digits only (from merchant_accounts) Required. |
changes | Changes to propose; several can go in one proposal Required. |
propose_changes Propose Google Ads changes (applies nothing)
Changes nothing in GoogleChecks a set of changes against the live account and dry-runs them with Google, then stores them as a proposal and returns a plain-English summary. Nothing is changed. Show the summary to the user and apply only after they approve. Supported: add_negative_keywords, pause_campaign, enable_campaign, pause_keyword, enable_keyword, pause_ad_group, enable_ad_group, set_daily_budget, set_end_date, and building: create_campaign (Search), create_display_campaign, create_demand_gen_campaign (YouTube), create_performance_max_campaign, all created paused; add_ad_group, add_keywords, add_responsive_search_ad, add_sitelinks, set_conversion_goal; and tuning: set_keyword_bid, set_product_group_bid (Shopping), set_ad_group_bid, pause_ad, enable_ad (to replace an ad rather than edit it: add the new one and pause the old in one proposal), add_campaign_targeting, remove_campaign_targeting, set_location_mode, set_bidding_strategy, set_shared_bid_strategy, create_shared_bid_strategy, set_url_suffix, set_eu_political_advertising (Google refuses every change to an account until each campaign has declared this), create_conversion_action, set_conversion_counting, import_ga4_key_event, remove_conversion_action; and deleting: delete_keyword, delete_ad, delete_ad_group, delete_campaign (ads, ad groups and campaigns can't be undone), delete_negative_keywords, delete_sitelinks; and negatives: add_ad_group_negatives, delete_ad_group_negatives, create_negative_list, edit_negative_list, apply_negative_list, delete_negative_list; and edit_responsive_search_ad, which keeps the ad instead of replacing it; and set_ad_schedule, set_device_bid, add_campaign_assets, delete_campaign_assets, set_ai_max, set_conversion_settings; and create_remarketing_list, set_campaign_audience, act_on_recommendation; and link_merchant_center / unlink_merchant_center (Shopping and Performance Max need the link). Point out any ⚠ line in the summary to the user before they approve. At most 50 changes per proposal, counting each keyword in add_keywords and add_negative_keywords as one (a create_campaign or add_ad_group counts as one however much it holds); for more, split them into several proposals up front and show the user all the summaries together.
| Parameter | What it is |
|---|---|
customer_id | Google Ads customer ID, with or without dashes (from list_accounts) Required. |
changes | Changes to propose; several can go in one proposal, up to 50 (each keyword counts as one) Required. |
apply_changes Apply an approved proposal
Needs your go-aheadApplies a proposal from propose_changes to the account. Only call this after the user has explicitly approved that proposal. All or nothing: every change is checked with Google first, and if one still fails the ones before it are rolled back. Each change is logged and, unless its summary says otherwise, can be reversed with undo_changes. If the account changed since the proposal, nothing is applied and the result (status "needs approval") is a new proposal with the updated summary: show it to the user and apply it only after they approve. When one request took several proposals (e.g. add exact negatives, delete the broad ones they replace), show the summaries together and, once approved, pass them all in proposal_ids: one apply, all or nothing, counted as one approved change.
| Parameter | What it is |
|---|---|
proposal_id | The proposal_id a propose tool returned Optional. |
proposal_ids | Instead of proposal_id: several proposals for the same account that the user approved together, applied as one Optional. |
undo_changes Propose reversing an applied proposal
Changes nothing in GoogleBuilds a new proposal that would reverse an applied one (removes the negatives it added, restores statuses and budgets). Changes nothing by itself: like any proposal, it must be approved and then applied with apply_changes.
| Parameter | What it is |
|---|---|
proposal_id | The id of an applied proposal, from change_history or apply_changes Required. |
discard_proposal Discard a proposal
Needs your go-aheadMarks an open proposal as discarded so it can never be applied; this can't be reversed (propose again instead). Changes nothing in the Google Ads account.
| Parameter | What it is |
|---|---|
proposal_id | The proposal_id a propose tool returned Required. |
change_history Change history
Read-onlyEvery proposal made through Camberstack, with what was applied, what failed, and what was undone. Applied Google Ads changes that can be measured carry change_results: ready, or the date their results start.
| Parameter | What it is |
|---|---|
customer_id | Google Ads customer ID, with or without dashes (from list_accounts) Optional. |
limit | Most proposals to return, newest first Default 20. |
change_results Results of applied changes
Read-onlyWhat applied Google Ads changes did, before vs after, from Google's numbers: negatives (what the searches they block cost), pauses (what it spent; the rest of its campaign), budgets, bidding and enabling (the campaign), and new campaigns, ad groups and keywords (since added). Ready 7 days after applying (change_history says when). Offer it when the user returns to an account with results ready, and give each reading with the caveats.
| Parameter | What it is |
|---|---|
customer_id | Google Ads customer ID, with or without dashes (from list_accounts) Required. |
proposal_id | One applied proposal; omit for the latest Optional. |
limit | Most proposals to measure Default 10. |
switch_account Pick the plan's account
Needs your go-aheadTakes customer_id as one of the plan's accounts. Call it after a tool answered "Account choice:" and the user picked this account. Once the plan's accounts are taken there is no switching: another account answers "Plan limit:" with when it opens and the upgrade options. Changes nothing in Google Ads; a no-op for an account that is already active. Merchant Center accounts are a separate allowance: pass mc:<account_id>, as the notice gives it.
| Parameter | What it is |
|---|---|
customer_id | Google Ads customer ID, with or without dashes (from list_accounts) Required. |
billing Plan and billing
Read-onlyShows the user's Camberstack plan: the Google Ads accounts used in the last 30 days against the number the plan covers (Free 1, Plus 1, Pro 5, Agency 25), and on Free the applied changes used of those included. Returns personal links to upgrade (Free to Plus or Pro, Plus to Pro, Pro to Agency) or to change card and cancel (paid plans). This is the Camberstack subscription only, not a Google Ads account's own billing, invoices or ad spend.
send_feedback Send feedback to Camberstack
Changes nothing in GoogleSends the user's message to Camberstack's maintainer, who reads every one and can reply to the user's Google email. Use it when the user wants to report a bug or ask for something Camberstack doesn't do. Show them the exact message first and send it only after they agree. Put in only what they want said: no account IDs, campaign data or conversation history.
| Parameter | What it is |
|---|---|
kind | bug, idea (a request), or other Default "idea". |
message | The message, as the user approved it Required. |
disconnect Disconnect Google Ads
Needs your go-aheadRevokes Camberstack's Google access and deletes the stored credentials. The user must confirm.
| Parameter | What it is |
|---|---|
confirm | Must be true; ask the user first Required. |
You don't call these yourself: ask your AI in plain English and it picks the tools. Connect Camberstack.