General tools

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.

Connected ad and data accounts (google, meta, microsoft, tiktok, linkedin, ga4, search-console, gbp, whatsapp) with status. A platform can have several connections (logins): each row has connection_id, account_key (login), is_default and the ad accounts known for it; pass one of them to a platform tool via per_call_argument (customer_id / account_id / advertiser_id) to run that call in it. 'sample' connections are demo data, not live.

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

One report tool for every connected platform. Without platform: the period report (period) or, with days/start_date, ledger numbers per channel and campaign. With platform: that platform's own live report at the given level/breakdown/date range (the result names the source tool). Read only.

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.

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.

Changes waiting for the user's approval — only those the user did not ask for themselves (automation rules in ask mode, proactive suggestions): id, kind, title.

This tool takes no parameters.

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

This tool takes no parameters.

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

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

List the campaigns, ad groups / ad sets, ads or keywords of any connected ad platform with their ids, paginated — instead of looking for the platform-specific list tool (the result names the source tool). Read only.

One-call picture of an ad account (or all): connections, live/paused campaign counts, recent spend, orders, revenue, ROAS per platform and campaign, pending approvals and the latest applied changes. Use before any review. Read only, no external calls.

Current plan, account status, trial end date and the credit balance (period, limit, used, remaining, seats).

This tool takes no parameters.

Give the user the dashboard link where they choose a paid plan, accept the legal terms and pay on the secure payment page themselves. Nothing is charged from chat and no card details are asked.

Status of a reported problem: open/answered/closed, when it was reported and the support team's answer once there is one.

Find tools and read their full input schema. With name/names: description, schema, credits, read-only/destructive flags. With query/platform: a ranked short list. Use it to reach tools that are not in the visible list.

List the account's projects (brands): id, name, default flag, how many ad/analytics accounts each one uses, and which project the tools currently work with. Every tool also accepts an optional `brand` argument (project id or name) to run once in another project.

This tool takes no parameters.

Studio outputs: the images, videos, voice-overs and scripts requested with generate_content — status (queued, rendering, ready, needs_provider, failed), the openable file URL when ready, the hook/CTA and why a file is waiting. Use it to share a finished file or check one that is still rendering. Read-only, free.

Automation rules set up with create_rule: id, condition (if) and action (then), mode (ask = asks first, auto = applies itself, off = only watches), on/off, how often and when it last fired, plus the latest rule runs and their outcome. Read-only, free.

This tool takes no parameters.

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

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

Create a campaign DRAFT (paused). Going live is a separate step: update_campaign(op=publish) when the user asks. Platforms without a live adapter return can_go_live=false with steps.

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

Pause / resume / change daily budget / publish a campaign. The user's request is the consent: the change is applied at once (applied: true, undo: action_id for undo_action) unless a guard refuses it (plan limit, +50% per change, daily spend cap → status not applied with the reason); without a connected account it is a dry run. op=budget amount is in the ad account currency; a different currency is rejected (currency_mismatch).

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

Set ONE campaign's daily budget (campaign_id). A platform-wide amount without campaign_id is rejected with campaign_required and the campaign list — one amount is never copied to every campaign. Amount is in the ad account currency; a different currency is rejected (currency_mismatch). Applied at once when the user asks (applied: true, undo: action_id); increases above 50% per change or above the daily spend cap are refused with the reason.

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

Add negative keywords to a Google Ads campaign. Applied directly when the user asks (the result shows the preview); applied to Google only with a connected account.

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

Turn an 'if … then …' sentence into an automation rule (the rule did not come from the user's own request each time, so mode=ask puts each trigger into approval; auto applies within the spend guard). See or switch off rules later with list_rules and set_rule_status.

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

Change the profit guard: daily/monthly spend caps, target CPA, margin, average order value, autopilot. Applied at once when the user asks (the result shows old → new and undo: action_id); raise a cap here when a change was refused by it.

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

Apply a pending change from a rule or a proactive suggestion (changes the user asks for are applied by their own tool; never needed for those). Two steps: without confirm it applies NOTHING and returns the preview to show the user. Only call with confirm=true after the user explicitly approved that preview. A change proposed through this same connection can't be approved here: the result gives approve_url, where the user approves it on the dashboard. Returns applied / dry run / failed.

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

Reject a pending change (from list_pending_approvals) so it is never applied. Use it when the user declines a preview; nothing is sent to any platform and the change disappears from the approval queue.

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

Write brand profile fields when the user describes the business.

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

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

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

Send a reply to a customer thread on the user's behalf — only when the user dictated or explicitly chose the text. It is sent at once and a sent message can't be taken back.

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

Open a support ticket for a problem the user hits (a tool error, wrong data, a missing feature). It lands in the support inbox; the answer shows in the dashboard. Returns issue_id for issue_status.

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

Turn an image (base64 or a public URL) into a signed, time-limited public image URL that tools needing an image_url accept. Stored in the account's private file area; PNG, JPEG, WEBP or GIF up to 5 MB.

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

Run any tool by name — the gateway to capabilities not shown in a reduced tool list. The named tool keeps its own rules: changes are applied at once when the user asks (guards still refuse unsafe ones), read-only connections cannot write, and the named tool's credits apply (the gateway itself is free).

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

Studio: generate an image, short video, UGC video, voice-over or script from a brief. The script is immediate; files take minutes — check them and get the file URL with list_productions.

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

Choose the project (brand) the tools work with from now on — reports, changes and drafts then use that project's own Google/Meta accounts, site and counters. The choice is kept for your next sessions; 'default' goes back to the default project. Use list_brands to see the names.

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

Switch an automation rule on or off, or change its mode (ask first / apply automatically / only watch). Use it when a rule fires wrongly or the member wants to pause it. Free.

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