Tool Reference

Tool Reference

The agent has 21 tools available during conversations. These tools are called by the AI model via the ReAct loop pattern (tool_use → execute → result → next turn).

Google Ads Tools

pull_google_ads_data

Pull live data from the Google Ads API using 47 different GAQL queries.

Parameters:

• action (required) — One of 47 query types (see Read Tools)
• params (optional) — dateRange, campaignId, adGroupId, limit, sortBy, status, costMin, etc.

execute_google_ads_action

Execute a single write operation. Requires explicit confirmation.

Parameters:

• action (required) — One of 62 mutation types (see Write Tools)
• params (required) — Action-specific parameters
• preview (required) — Human-readable description of what will change
• risk_level — low, medium, high
• confirmed — Must be true to execute (agent asks user first)

execute_google_ads_batch

Execute multiple write operations in phases.

Parameters:

• operations — Array of {action, params, preview} objects

compare_performance

Compare Google Ads performance across two time periods.

Parameters:

• metric_type — Type of comparison
• period — wow (week over week), mom, yoy, or custom
• custom_current / custom_previous — Custom date ranges

generate_keyword_ideas

Google Keyword Planner API integration.

Parameters:

• keywords — Seed keywords
• url — Landing page URL for contextual ideas
• language, geoTargets, limit

upload_offline_conversions

Import CRM conversions via GCLID.

Parameters:

• conversionActionId — Conversion action to attribute to
• conversions — Array of {gclid, conversionDateTime, conversionValue}

upload_customer_match

Upload email/phone lists as Customer Match audiences.

Parameters:

• userListId — Target user list
• members — Array of {email, phone}

undo_last_write

Retrieve rollback information for the last write operation.

---

Research Tools

search_web

Search Google, Google Trends, or Google Ads Transparency Center via SearchAPI.

Parameters:

• query — Search query
• engine — google, google_trends, google_ads_transparency, google_trends_trending
• num_results, location, gl, data_type, geo, date

analyze_keywords

Keyword research using live SERP data.

Parameters:

• seed_keywords — Starting keywords
• mode — expand, competitor, serp_analysis

scan_url

Fetch and analyze a URL for tracking tags, SEO, consent mode, and data layer.

Parameters:

• url — URL to scan

Detects: GA4, GTM, Meta Pixel, Google Ads, TikTok, LinkedIn, SEO issues, consent mode, data layer

fetch_pagespeed

Run PageSpeed Insights for Core Web Vitals.

Parameters:

• url — URL to test
• strategy — mobile or desktop

---

Creative & Planning Tools

build_creative

Generate ad copy for various formats.

Parameters:

• ad_type — RSA, PMax, Display, Social, etc.
• business_context — Business/product description
• url — Landing page URL
• variations — Number of variations to generate

review_image

AI vision analysis of creative assets.

Parameters:

• image_url — Image to analyze
• task — Analysis task description

propose_action_plan

Present a structured action plan with risk assessment.

create_plan

Create a multi-step execution plan with phases and dependencies.

---

Utility Tools

calculate

Deterministic ad math calculations.

Calculation types: budget_projection, roas_target, bid_recommendation, cpa_target, conversion_forecast, impression_share_opportunity

verify_output

Self-verify output for character limits, math accuracy, and data consistency.

export_file

Export data as CSV for download.

save_document / load_document

Persistent document storage for audits, strategies, reports, and notes.

manage_tasks

Create and update a visible task list.

search_memory (Buddy only)

Semantic search over past conversations using vector embeddings.