How Intelligency works

Sign-in, connections and assistants

• Sign-in: sign in with Google. Signing in only identifies you.
• Google Ads connection: a separate consent, personal to each operator. Intelligency discovers the accessible accounts, including the clients under your MCC.
• Google Analytics 4 and Search Console connections: a separate consent for each, read-only (analytics.readonly, webmasters.readonly). Intelligency discovers the properties your Google account can access and cannot change them.
• MCP server: https://srv1800511.hstgr.cloud/mcp, with OAuth 2.1. The assistant acts as you, on the accounts of your connections.

Preview and approval

Write tools never change an account. They build the change, have Google validate it without applying it (validate-only) and save it as a preview, which the assistant presents to you in the chat in its own words. No cards or widgets: the chat answers.

• when you say “approve”, the assistant calls apply_change, the change reaches Google Ads and it tells you it's done;
• or you approve it in the web app, on the Previews page. The agency can require this mode only, from Settings.

Changes that can raise spend or cannot be undone (enabling anything, higher budgets or bids, bidding, location, language or schedule changes, removals) are approved only in the web app: the assistant gives you the link and cannot apply them for you, even if some text read in the accounts asked it to.

Previews expire after 24 hours. New campaigns, ads and assets are created paused. Every action goes into the log.

Read tools

• list_accounts: Manager accounts (MCC) and client accounts reachable through your connections
• get_account_overview: KPIs for the last N days vs the previous ones, daily trend, alerts
• get_campaign_performance: Per-campaign metrics, with a compact mode for large accounts
• list_ad_groups: Ad groups with ID, status and metrics
• get_ad_performance / get_keyword_performance / get_search_terms: Ads, keywords with quality score, search terms and negative candidates
• get_negative_keywords / get_recommendations: Negative keywords and Google recommendations with estimated impact
• lookup_geo_targets / lookup_languages: Location and language IDs for targeting
• get_campaign_settings: A campaign's settings and targeting: dates, tracking, locations, languages, schedule, devices, exclusions
• list_assets: The account's images (with format and fitting slot) and YouTube videos, texts, sitelinks and callouts
• research_keywords: Keyword Planner ideas: monthly searches, competition, top-of-page bids
• get_placement_performance: Where Display, Video, Demand Gen and Performance Max ads ran
• get_product_performance: Results by product, brand, product type or custom label (Shopping and Performance Max)
• get_geo_performance: Results by country, region, province or city, with people outside the targeted locations
• get_pmax_overview: Performance Max asset groups: status, ad strength, results, assets, products and signals
• get_change_history: Who changed what and when, with before and after values (last 30 days)
• get_ad_policy_issues: Disapproved or limited ads, with the policies involved
• list_conversion_actions: Conversion actions with type, category, primary/secondary and volumes
• search_audiences / get_negative_keyword_lists: Audience segments and shared negative keyword lists
• run_gaql: Advanced GAQL query, read-only, at most 1000 rows
• list_pending_changes / get_change_status: Status of previews

Tools that prepare previews

• draft_campaign: Paused Search campaign, with budget, bidding, first ad group, keywords, locations and languages
• duplicate_campaign: Paused copy of a Search campaign with ad groups, keywords, ads, negatives, assets and targeting
• draft_demand_gen_campaign: Paused Demand Gen campaign with a YouTube video ad; also rebuilds an existing Video campaign (Google does not allow creating or copying those through the API)
• draft_performance_max_campaign: Paused Performance Max campaign with logo, images, texts and videos
• draft_pmax_asset_group: New paused asset group in an existing Performance Max campaign, optionally reusing another group's assets
• update_pmax_asset_group: Edit an existing asset group: add or remove texts, images and videos, rename it or change its final URL
• set_pmax_product_filter: Which products an asset group serves: all, some item IDs, brands, product types or custom labels, with exclusions
• exclude_pmax_products: Exclusion of single products (Merchant Center item IDs) from a Performance Max campaign
• set_ad_schedule / set_device_bid_adjustments: Ad schedule and device bid adjustments
• add_audiences / add_placement_exclusions: Audience segments on ad groups and exclusion of websites, YouTube channels and videos
• draft_negative_keyword_list: Shared negative keyword lists, linked to campaigns
• draft_structured_snippets / draft_call_asset: Structured snippets and phone number
• draft_ad_group / draft_keywords: New ad groups and keywords (BROAD only with Smart Bidding)
• draft_responsive_search_ad / update_responsive_search_ad: RSA ads (paused), with a landing page URL check
• add_negative_keywords / add_negative_locations: Exclusions, without duplicates
• update_campaign / update_ad_group: Budget (within the agency cap), strategy, locations, languages, networks, name, CPC
• pause_entity / enable_entity / remove_entity: Status of campaigns, ad groups, ads and keywords. Removal asks for a double confirmation
• draft_sitelinks / draft_callouts: Campaign assets
• apply_change: Applies a preview, only after you approved it in the chat (not those that can raise spend)
• discard_change: Discards a preview

Google Analytics 4 (read-only)

• ga_list_properties: GA4 properties (with their account) reachable through your Google Analytics connections
• ga_get_property: Time zone, currency, industry and data streams (website URL, measurement ID)
• ga_get_overview: Sessions, users, engagement, key events and revenue for the last N days vs the previous ones, trend, channels
• ga_run_report: Free-form Data API report: dimensions, metrics, filters, ordering, several periods, pagination
• ga_run_realtime_report: Activity of the last 30 minutes
• ga_get_metadata: Custom dimensions and metrics, or a search across all the available ones
• ga_list_key_events / ga_list_google_ads_links: Key events (conversions) and Google Ads accounts linked to the property

Google Search Console (read-only)

• gsc_list_properties: Search Console properties (domain or URL prefix) verified by your connections
• gsc_get_overview: Clicks, impressions, CTR and position for the last N days vs the previous ones, trend, top queries and pages
• gsc_search_analytics: Performance by query, page, country, device, search appearance or date, with filters and pagination
• gsc_compare_periods: Two periods compared: the queries or pages that gained or lost the most
• gsc_inspect_urls: URL inspection (up to 10): indexing, coverage, last crawl, canonical, rich results
• gsc_list_sitemaps: Submitted sitemaps, with errors and warnings

Assistants connected before Analytics and Search Console arrived don't have these permissions: to use them, reconnect the assistant and approve the new permissions.

Managing and deleting your data

• Disconnect Google Ads, Analytics or Search Console: Connections → Disconnect. We revoke access with Google and delete tokens, account and property data.
• Revoke an AI assistant: AI assistants → Revoke.
• Delete your account: Settings → Your data.
• Advertisers: to dissociate your Google Ads accounts from Intelligency, ask your agency to disconnect them or write to us. We do so within 3 business days.

Details in the privacy policy.