Inloggen Gratis starten

Tool reference — Ads

General tools

Account status, campaign summary, reports, approval queue, brand profile and channel-independent change tools.

Tool names and descriptions are generated straight from the server code; the descriptions are the original English text the assistant sees.

Read tools10 tools

get_status

Lezen1 credits

Account overview: brand, plan, connected platforms, campaigns (7 days), pending approvals, open customer chats, spend guard. Call first when context is unknown.

This tool takes no parameters.

list_accounts

Lezen1 credits

Connected ad and data accounts (google, meta, microsoft, tiktok, linkedin, ga4, search-console, gbp, whatsapp) with status. 'sample' connections are demo data, not live.

This tool takes no parameters.

list_campaigns

Lezen1 credits

Campaigns with the last N days of spend, clicks, orders and revenue. Use the returned campaign ids for update_campaign / add_negative_keywords.

Parameter	Type	Description
`days`Optional	integer (1–90)	—

get_report

Lezen1 credits

Period report: spend, orders, revenue, ROAS, change versus the previous period, suggestions. Read only.

Parameter	Type	Description
`period`Optional	day \| week \| month	—

search_terms_report

Lezen2 credits

Google Ads search terms with spend, clicks and conversions for the last N days, plus the wasted (zero-conversion) terms. Requires a connected Google Ads account; otherwise returns a note, never invented numbers.

Parameter	Type	Description
`days`Optional	integer (1–90)	—
`campaign_id`Optional	string	—

account_audit

Lezen3 credits

Account hygiene audit as prioritised findings: spend without results, missing budgets, no spend cap, wasted search terms, pending approvals. Read only.

This tool takes no parameters.

list_pending_approvals

Lezen1 credits

Changes waiting for the user's approval (id, kind, title).

This tool takes no parameters.

get_brand_profile

Lezen1 credits

Brand knowledge base: sector, location, products, audience, goals, tone, competitors.

This tool takes no parameters.

research

Lezen2 credits

Web research (competitor, price, sector rule). If no research provider is configured, returns a note; never invent results.

Parameter	Type	Description
`query`Required	string	—

list_customers

Lezen1 credits

Customer conversations in the inbox (WhatsApp, Messenger, Instagram): who wrote, last message, waiting for reply.

Parameter	Type	Description
`state`Optional	needs_you \| waiting \| auto \| done	—
`limit`Optional	integer	—

Write tools13 tools

connect_account

Schrijven0 credits

Start connecting a platform account. Returns an authorisation link the user must open (OAuth); nothing is connected without the user signing in.

Parameter	Type	Description
`provider`Required	google \| meta \| microsoft \| tiktok \| linkedin \| ga4 \| search-console \| gbp \| whatsapp \| shopify \| youtube	—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

create_campaign

Schrijven2 credits

Create a campaign DRAFT (paused). Going live is a separate step: update_campaign(op=publish) which passes the approval gate. Platforms without a live adapter return can_go_live=false with steps.

Parameter	Type	Description
`name`Required	string	—
`platform`Required	google \| meta \| microsoft \| tiktok \| linkedin	—
`kind`Optional	string	search \| pmax \| display \| message \| traffic \| conversion
`daily_budget`Optional	number	—
`goal`Optional	string	—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

update_campaign

Schrijven2 credits

Pause / resume / change daily budget / publish a campaign. Returns a preview and status: applied, pending approval, or dry run. Nothing is applied without the user's approval policy allowing it.

Parameter	Type	Description
`campaign_id`Required	string	—
`op`Required	pause \| resume \| budget \| publish	—
`amount`Optional	number	daily budget for op=budget

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

set_budget

Schrijven2 credits

Set a platform-level budget (no campaign id needed). Goes through preview and approval; increases above 50% per change are blocked.

Parameter	Type	Description
`platform`Required	string	—
`amount`Required	number	—
`currency`Optional	TRY \| USD \| EUR	—
`period`Optional	day \| week \| month	—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

add_negative_keywords

Schrijven2 credits

Add negative keywords to a Google Ads campaign. Creates an approval item with a preview; applied to Google only after approval and only with a connected account.

Parameter	Type	Description
`campaign_id`Required	string	—
`keywords`Required	array<string>	—
`match_type`Optional	BROAD \| PHRASE \| EXACT	—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

create_rule

Schrijven2 credits

Turn an 'if … then …' sentence into an automation rule (mode=ask puts each trigger into approval, auto applies within the spend guard).

Parameter	Type	Description
`sentence`Required	string	—
`mode`Optional	ask \| auto	—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

set_spend_guard

Schrijven1 credits

Profit guard: daily/monthly spend caps, target CPA, margin, average order value, autopilot.

Parameter	Type	Description
`daily_cap_try`Optional	number	—
`monthly_cap_try`Optional	number	—
`target_cpa_try`Optional	number	—
`margin_pct`Optional	number	—
`aov_try`Optional	number	—
`autopilot`Optional	boolean	—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

approve_action

SchrijvenIrreversible5 credits

Apply a pending change. Only call after the user explicitly said to approve it; pass confirm=true. Returns applied / dry run / failed.

Parameter	Type	Description
`action_id`Required	string	—
`confirm`Required	boolean	must be true; only after the user explicitly approved

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

reject_action

Schrijven0 credits

Reject a pending change.

Parameter	Type	Description
`action_id`Required	string	—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

set_brand_profile

Schrijven1 credits

Write brand profile fields when the user describes the business.

Parameter	Type	Description
`fields`Required	object	business.sector, business.location, goals.target, products.list, audience.primary, competitors.list, brand.tone …

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

draft_ad_copy

Schrijven2 credits

Ad copy drafts (headlines, descriptions, call to action) from the brand profile.

Parameter	Type	Description
`platform`Optional	google \| meta \| instagram	—
`kind`Optional	string	—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

reply_customer

Schrijven2 credits

Reply to a customer thread on the user's behalf (only when the user dictated or approved the text).

Parameter	Type	Description
`thread_id`Required	string	—
`text`Required	string	—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

generate_content

Schrijven3 credits

Studio: generate an image, short video, UGC video, voice-over or script from a brief. The script is immediate; files take minutes and need an AI route.

Parameter	Type	Description
`kind`Required	string	image \| short_video \| ugc_video \| voice \| script
`brief`Optional	string	—
`campaign_id`Optional	string	—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.