Growomat
Server Details
Build, edit and sync Google, Microsoft, Reddit and Meta ad campaigns from your assistant.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-06-18
- URL
- ChatGPT
- –
- Claude
- Growomat
TDQS
Scored across 113 tools
Most tools target distinct resources, but several overlap: create_asset, upload_asset, start_asset_upload and complete_asset_upload are multiple doors to asset creation, while account_summary, get_performance_stats and get_conversion_report overlap on reporting. update_campaign also competes with dedicated front-door tools like set_ad_schedule and set_geo_targeting. Detailed descriptions help, but the large surface still creates real misselection risk.
The names are overwhelmingly snake_case and follow a predictable verb_noun pattern (list_campaigns, create_ad, delete_keyword). Minor deviations such as account_summary and some longer multi-part names like start_asset_upload are still readable. Not perfectly uniform, but consistent enough for an agent to infer actions.
113 tools is far beyond a well-scoped set and exceeds the 50+ threshold for extreme mismatch. Even for a broad ad-management platform, this volume makes discovery, selection, and maintenance unwieldy. Many specialized tools could likely be consolidated or moved behind fewer entry points.
The surface covers most lifecycle operations across businesses, campaigns, ad groups, ads, keywords, assets, angles, concepts, conversion actions, competitors, sync, budgets, schedules and geo-targeting. Minor gaps remain, such as no update/delete for conversion sources, but core workflows have CRUD and supporting preflight tools. Agents can work around the remaining gaps.
Available Tools
113 toolsaccount_summaryAccount summaryARead-onlyInspect
Return a single JSON document summarising the account: token info (including token.scheduling.timezones — the per-platform account timezone that ad schedules are interpreted in), visible Spaces, campaign list, per-resource counts, 30-day stats, and the most recent sync (last_sync) so you can tell whether the campaigns are actually live. Backed by parallel SDK calls — the cheapest way to ask 'what's going on with my account?' before deciding what else to do. The counts, campaigns/stats, and last_sync branches are Space-scoped; pass space_id to summarise a non-active Space without changing the session binding. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: space_id.
attach_asset_to_adAttach asset to adAInspect
Attach an existing asset to an ad (scope=AD, adId required) or an ad group (scope=AD_GROUP, adGroupId required) with a role (MARKETING_IMAGE, SQUARE_MARKETING_IMAGE, LOGO, LANDSCAPE_LOGO, PORTRAIT_MARKETING_IMAGE, YOUTUBE_VIDEO, VIDEO). This is the scope that actually serves images/video on Display, Performance Max and Video campaigns, and it puts the image on a single-image card (a chat card) that has none of its own. campaignId is derived from the ad/ad group when omitted. Returns the full updated/created object. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: body (required), space_id.
attach_asset_to_campaignAttach asset to campaignAInspect
Attach an existing asset to a campaign with a role (e.g. MARKETING_IMAGE, LOGO). Returns the full updated/created object. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: body (required), space_id.
cancel_syncCancel syncAInspect
Request cancellation of a running sync. Takes effect at the next campaign boundary; campaigns already pushed are not rolled back. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: sync_id (required), space_id.
check_competitor_similarityCheck copy against competitorsARead-onlyInspect
Run the similarity check every ad save runs: is this copy too close to a tracked competitor's ad, or does it name one? Use before creating or updating ads to avoid a 409 COMPETITOR_SIMILARITY. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: body (required), space_id.
complete_asset_uploadComplete asset uploadAInspect
Finish a two-step upload after the PUT: Growomat reads the stored file's real type, size, width and height and marks the asset READY. Fails with UPLOAD_MISSING if nothing has been uploaded yet, and marks the asset FAILED if the bytes are not an accepted image. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: asset_id (required), space_id.
confirm_campaignConfirm draft campaignAInspect
Confirm a DRAFT campaign: moves it to PAUSED. A draft is never synced and no other change can take a campaign out of DRAFT — this is the one way, with the app's own checks (refused while the campaign builder is still writing it, or while a required question is unanswered; answer those in the app). Nothing reaches a platform until trigger_sync, and it stays paused there until you set status ENABLED and sync again. Returns the campaign. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: campaign_id (required), space_id.
confirm_competitor_library_accountConfirm library accountAInspect
Confirm that a library account belongs to a competitor; Growomat starts reading its ads. Only call this once the user has agreed the match is right. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: body (required), competitor_id (required), space_id.
confirm_own_ad_readingConfirm what the business's ads argueAInspect
Turn readings into angle stamps the user agreed to: each item names an active ad and, to correct the reading, an angleType from the closed vocabulary. The ad is stamped with provenance user and counts in angle results from then on. Ask the user first; confirm only ads they agreed to. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: body (required), business_id (required), space_id.
copy_ad_groupCopy ad group to another platformAInspect
Copy an ad group to another platform its campaign runs on. The original is untouched; the copy has the same name, starts PAUSED, has no platform links and records copiedFrom. Ads of the same kind copy as they are (meta.overLimit lists text over the target's limits); ads of a different kind are rewritten as the target's format (meta.outcome rewrite); keywords on a platform without keywords become audienceSuggestion — a suggestion, not targeting. Returns the new ad group. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: platform (required), ad_group_id (required), space_id.
create_adCreate adAInspect
Create a new ad inside an ad group. A search ad reads headlinePart1–3 and description/description2. A single-image card (type OPENAI_CHAT_CARD, a chat card) reads headlinePart1 as its title (3–50 characters) and description as its body (up to 100) — or _native[platformId].postTitle / postBody when you want the card to read differently — finalUrl as its destination, and needs one image of at least 640 × 640: upload_asset, then attach_asset_to_ad with role MARKETING_IMAGE (or set creative.imageUrl). headlinePart2 is not needed for a card. validate_export names anything a platform would refuse; preview_campaign shows the card as it will be sent. Returns the full updated/created object. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: body (required), space_id.
create_ad_groupCreate ad groupAInspect
Create a new ad group under a campaign. Every ad group belongs to one platform (body.platform, a platform id such as google-ads): only that platform receives it, its ads and its keywords. Leave it out on a campaign that runs on one platform; name it on a campaign that runs on several (400 AD_GROUP_PLATFORM_REQUIRED lists them). It is fixed once created — use copy_ad_group to run the same ads elsewhere. Returns the full updated/created object. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: body (required), space_id.
create_angleCreate angleAInspect
Create an angle — a claim a set of ads argues, scoped to one business. angleType must be a registry id from get_creative_vocabulary. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: body (required), space_id.
create_assetCreate assetAInspect
Create an asset (image, logo, video). By reference: body.url is kept as a pointer and fetched when a sync needs the bytes, so it must stay reachable. By bytes: body.data (base64) — or body.url with body.store true — stores the file in Growomat; upload_asset is the simpler door for that. Every response carries previewUrl, a link you can open. Returns the full updated/created object. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: body (required), space_id.
create_businessCreate businessAInspect
Register a new business: its name and website, plus optional description, target groups, SEO keywords, key pages (sitelinks) and a brand voice profile. The optional brand object is the business's brand voice profile — tone dials (formality, energy), voiceNotes, promises and bannedPhrases — and governs all generated ad and social copy for this business. Returns the full created object. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: body (required), space_id.
create_campaignCreate campaignAInspect
Create a new campaign. It runs only on the platforms named in body._platformBudgets, which is required. budget is daily, in the platform account's currency (list_connections); some platforms set a per-currency daily minimum, which validate_export names. Platform-only settings go in body._native, keyed by platform id — the NativeExtensions schema in the OpenAPI spec lists each platform's keys: for example a lifetime budget (budgetKind LIFETIME, which can never become daily once pushed and needs a fixed bid: biddingStrategy MANUAL_CPC with biddingStrategy.cpcBid, or a cpcBid on each ad group), the bidding type, or the delivery surfaces. A campaign created as DRAFT is held back until confirm_campaign. Returns the full updated/created object. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: body (required), space_id.
create_conceptCreate conceptAInspect
Create a concept under an angle. attributes are registry ids from get_creative_vocabulary. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: body (required), space_id.
create_conversion_actionCreate conversion actionAInspect
Create a conversion action — the thing an uploaded conversion is counted against. Pass body with at least { name, type, category }. The action is created locally; exporting it to an ad platform (which assigns the remote id and the tag snippet) happens through campaign sync. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: body (required), space_id.
create_conversion_sourceConnect a conversion sourceAInspect
Connect a revenue/conversion source to the active Space so it feeds measured conversions back to your connected ad platforms. Pass body as { type: 'stripe'|'webhook'|'hubspot'|'salesforce'|'ga4', config?: {...}, accountRef? }. Idempotent per type by default. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: body (required), space_id.
create_keywordCreate keywordAInspect
Add a keyword to an ad group. On a platform without keywords (a chat platform), positive keywords are sent as plain-language context hints — write them as the questions people ask — and negatives are dropped; validate_export says so. Returns the full updated/created object. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: body (required), space_id.
delete_adDelete adADestructiveInspect
Delete an ad. Permanently deletes the resource. Irreversible. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: ad_id (required), space_id.
delete_ad_groupDelete ad groupADestructiveInspect
Delete an ad group. By default the call fails with a 409 when the ad group still has dependent ads or keywords — pass cascade=true to delete them in the same request. Permanently deletes the resource. Irreversible. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: ad_group_id (required), cascade, space_id.
delete_angleDelete angleADestructiveInspect
Delete an angle. Its concepts are deleted with it; ads keep their stamp (dangling but queryable). Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: angle_id (required), space_id.
delete_assetDelete assetADestructiveInspect
Delete an asset. Permanently deletes the resource. Irreversible. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: asset_id (required), space_id.
delete_businessDelete businessADestructiveInspect
Delete a business. Fails with 409 if any campaign still references it — delete or reassign those campaigns first; no cascade is offered. Permanently deletes the resource. Irreversible. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: business_id (required), space_id.
delete_campaignDelete campaignADestructiveInspect
Delete a campaign. Permanently deletes the resource. Irreversible. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: campaign_id (required), space_id.
delete_conceptDelete conceptADestructiveInspect
Delete a concept. Ads keep their stamp. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: concept_id (required), space_id.
delete_conversion_actionDelete conversion actionADestructiveInspect
Delete a conversion action. Permanently deletes the resource. Irreversible. Refuses with a conflict and names the campaigns when a campaign bids on this action — deleting it would change how that campaign spends. Pass force to delete anyway. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: conversion_action_id (required), force, space_id.
delete_keywordDelete keywordADestructiveInspect
Delete a keyword. Permanently deletes the resource. Irreversible. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: keyword_id (required), space_id.
detach_asset_from_adDetach asset from adBInspect
Detach an asset from an ad / ad group. Permanently deletes the resource. Irreversible. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: ad_asset_id (required), space_id.
detach_asset_from_campaignDetach asset from campaignCInspect
Detach an asset from a campaign. Permanently deletes the resource. Irreversible. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: campaign_asset_id (required), space_id.
find_competitor_library_accountsFind library accountsAInspect
Search each public ad library for the accounts that match a competitor, with evidence (do their ads point at the competitor's website, does the name match, is it verified). Nothing is read until one is confirmed. Uses one monthly library lookup unless today's result is cached. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: competitor_id (required), force, space_id.
get_active_spaceGet active spaceARead-onlyInspect
Report the MCP server's current active Space binding. Returns { active_space_id, source, name?, role?, type?, campaign_count? }. source is 'env' (set at start-up via GROWOMAT_SPACE_ID), 'set_active_space' (changed at runtime), or 'default' (unbound — the BE falls back to the caller's Personal Space). No API round-trip when nothing is bound.
Inputs: no named parameters.
get_adGet adARead-onlyInspect
Fetch one ad by id. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: ad_id (required), space_id.
get_ad_assetGet ad assetARead-onlyInspect
Fetch one ad-asset binding by id. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: ad_asset_id (required), space_id.
get_ad_groupGet ad groupARead-onlyInspect
Fetch one ad group by id. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: ad_group_id (required), space_id.
get_angleGet angleARead-onlyInspect
Fetch one angle by id. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: angle_id (required), space_id.
get_angle_gapGet angle gapARead-onlyInspect
Which claims the tracked competitors lead with compared with the business's own active ads, as counts of ads (never spend): their ads shown in the last days days against the business's ads active now. coverage says how many of the business's active ads are confirmed (stamped), read (a provisional reading of the copy) or unknown. The verdict names the angle most competitors lead with that none of the business's known ads argue; it is null when withheld says the comparison cannot be made yet (own_ads_unread: call get_own_ad_reading and offer to confirm it; too_few_competitors: fewer than two competitors have classified ads; no_active_ads). When verdict.basis is mixed, say 'as far as we can read them'. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: business_id (required), days, space_id.
get_angle_preflightGet angle pre-flightARead-onlyInspect
BEFORE spending: what can this account's budget actually resolve? Simulates the real stopping rule on the account's own observed spend, CPC and CVR and returns a P20-P80 weeks-to-verdict RANGE for the candidate angle count — never a single week. An unresolvable plan comes back as advice (fewer angles, the clicks-basis alternative with its caveat, or conversion tracking as the real fix), not refusal. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: count (required), space_id.
get_angle_readoutGet angle read-outARead-onlyInspect
Results read at the ANGLE level — the unit where enough money flowed to teach anything. Per business, each angle's plain decision state (collecting | ahead | decided | no_difference), P(best), expected monthly loss of promoting the leader, delivery flags (skewed/starved and divergent platform mix — part of a lead can be delivery, not merit), the last recorded state transition, and estimator provenance. Never shows confidence that does not exist. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: window, space_id, business_id, platform_id.
get_answer_briefGet answer briefARead-onlyInspect
A structured brief for writing ORIGINAL copy that argues a competitor's angle: angle type, the shape of their offer, the hook pattern. It never contains the competitor's words; write the copy in the business's own voice. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: body (required), space_id.
get_assetGet assetARead-onlyInspect
Fetch one asset by id. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: asset_id (required), space_id.
get_authenticated_token_infoGet authenticated token infoARead-onlyInspect
Return the owner, plan, and scope set of the API token currently in use, plus scheduling.timezones — the per-platform connected-account timezone, keyed by platform id, that ad-schedule hours are interpreted in. Cheap, no side effects — useful as a connection check and to learn your scheduling timezone before setting ad schedules.
Inputs: no named parameters.
get_brake_statusGet Emergency Brake statusARead-onlyInspect
Read the Emergency Brake state on its own: whether it is armed, whether it is engaged right now, the events it has recorded (each with the budget crossed, the spend measured, and the exact campaigns paused), and which levels the user has overruled for the current month. Cheap to poll, no side effects.
Inputs: no named parameters.
get_budgetGet budgetARead-onlyInspect
Read the account's budget and the state of its Emergency Brake: the configured amount and period, the derived daily/monthly caps, the currency, whether the brake is armed, and whether it is currently engaged (and which campaigns it paused). Read-only. Scoped to the active Space.
Inputs: no named parameters.
get_businessGet businessARead-onlyInspect
Fetch one business by id, including its brand voice profile (tone dials, promises, banned phrases) when set. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: business_id (required), space_id.
get_campaignGet campaignARead-onlyInspect
Fetch one campaign by id. Returns the full campaign object. adScheduleStructured is the canonical weekly schedule (always present when a schedule is set) and adScheduleStructured.timezone is the effective IANA zone; adSchedule echoes the legacy enum when one was used. adScheduleUseSearcherTimeZone (Microsoft only) indicates the schedule is interpreted in the searcher's local time. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: campaign_id (required), space_id.
get_campaign_assetGet campaign assetARead-onlyInspect
Fetch one campaign-asset link. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: campaign_asset_id (required), space_id.
get_competitorGet competitorARead-onlyInspect
One competitor with its confirmed ad library accounts and summary. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: competitor_id (required), space_id.
get_competitor_allowanceGet competitor allowanceARead-onlyInspect
How many competitors the plan tracks per business, how many are tracked, and the monthly ad library lookup allowance. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: space_id, business_id.
get_competitor_auctionGet competitor auction dataARead-onlyInspect
Where a competitor meets the business in its OWN auctions, per connected platform: overlap rate, how often they rank above, outranking share, top-of-page rates, a 13-week trend, and the business's impression share lost to rank. A platform with no auction data says why instead of returning zeros. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: competitor_id (required), space_id.
get_competitor_coverageGet competitor coverageARead-onlyInspect
Which public ad library covers each connected ad platform and for which regions, which platforms have no public library at all, and where auction data comes from. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: business_id (required), space_id.
get_competitor_offersGet competitor offersARead-onlyInspect
Prices, discounts, trials, guarantees and deadlines in a competitor's active ads, each quoted, plus the headline offer and how it changed. Library data shows what a competitor published, never what worked. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: competitor_id (required), space_id.
get_conceptGet conceptARead-onlyInspect
Fetch one concept by id. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: concept_id (required), space_id.
get_conversion_actionGet conversion actionARead-onlyInspect
Fetch one conversion action by id. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: conversion_action_id (required), space_id.
get_conversion_healthGet conversion loop healthARead-onlyInspect
Return conversion-loop health for the active Space — per-source match rate, uploads accepted vs partial-failure, last-event age, and issue codes (NO_SOURCE_CONNECTED, LOW_MATCH_RATE, CLICK_ID_LOOP_BROKEN, CONSENT_MISSING_EEA, ACTION_NOT_PRIMARY, DEV_TOKEN_NOT_ENABLED), plus the trust line (how many real customers worth how much, matched at what rate). The 'is the loop working / how confident' check. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: space_id.
get_conversion_reportGet conversion value reportARead-onlyInspect
Return a value-aware conversion report over the configured window — conversions, conversion value, and ROAS (online + offline), so bidding toward Target ROAS can be verified. Pass query-param filters (period, platformId, dates) as keyword arguments — see /api/v1/reports/stats in the OpenAPI spec. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: space_id.
get_conversion_statusGet offline-conversion statusARead-onlyInspect
Return offline-conversion upload status for the active Space — total count, last upload time, total value, and the most recent uploads — optionally filtered to a single campaign's conversion actions via campaign_id. The cheapest way to verify that the offline conversions you report are actually landing. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: space_id, action_ids, campaign_id.
get_creative_vocabularyGet creative vocabularyARead-onlyInspect
The closed creative vocabulary the angle plane runs on: angle types (the claims ads argue), concept attributes (wording mechanisms) and business categories. Versioned and append-only — tag with these exact ids; free text is never accepted.
Inputs: space_id.
get_keywordGet keywordARead-onlyInspect
Fetch one keyword by id. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: keyword_id (required), space_id.
get_latest_briefingGet the latest noteARead-onlyInspect
What the growth manager last wrote in a note for the active Space: the period it covers, its words as the Space's members read them, and the changes it recommended with their status. Returns 404 NO_BRIEFING when none has been written yet. Read-only. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: space_id.
get_own_ad_readingGet what the business's ads argueARead-onlyInspect
The business's active ads grouped by the angle each argues: confirmed stamps, provisional readings of the copy (never written to the ad, never counted in angle results until a person confirms them) and ads that could not be read yet. Show the readings to the user before confirming any. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: business_id (required), space_id.
get_performance_statsGet performance statsARead-onlyInspect
Return aggregated performance stats (impressions, clicks, conversions, spend) over the configured window. Pass query-param filters as keyword arguments — see /api/v1/reports/stats in the OpenAPI spec for the full filter set. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: space_id.
get_sync_statusGet sync statusARead-onlyInspect
Return a sync's status, per-campaign progress, totals, and structured errors. Use effectiveStatus: queued/in_progress (keep polling), stalled (no activity for over ten minutes; it is closed automatically, and a new sync is blocked until then), completed, partial (some campaigns failed), failed, cancelled — the last four are terminal. Failed/partial campaigns carry structured detail in progress.campaignDetails[].errorDetails (Google policyName/fieldPath/trigger, Microsoft PartialErrors) plus a string in .error, and every failure counted in totals.errors is listed in errors. An ad the platform is still reviewing is NOT a failure: it appears in warnings with code PLATFORM_REVIEW_PENDING, the sync stays completed, and the next sync after the review sends it — do not edit or recreate the ad. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: sync_id (required), space_id.
list_ad_assetsList ad assetsARead-onlyInspect
List asset-to-ad / ad-group attachments. Exactly one of ad_id / ad_group_id / campaign_id is required (campaign_id returns every ad-level binding in the campaign). Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: role, ad_id, limit, cursor, +3 more.
list_ad_groupsList ad groupsARead-onlyInspect
List ad groups across visible campaigns, or in one campaign with campaign_id. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: limit, cursor, platform, space_id, +1 more.
list_adsList adsARead-onlyInspect
List ads across visible campaigns. Pass campaign_id or ad_group_id to scope the result server-side (recommended — otherwise the whole Space is returned and can overflow the response budget). Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: limit, cursor, platform, space_id, +2 more.
list_anglesList anglesARead-onlyInspect
List the angles (claims your ads argue) in the active Space. An angle is business-scoped and is the unit results are decided at. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: limit, cursor, space_id, angle_type, +1 more.
list_assetsList assetsARead-onlyInspect
List assets owned by this token's user. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: limit, cursor, space_id.
list_businessesList businessesARead-onlyInspect
List the businesses in this account. A business is what the user is growing (a school, a course, a SaaS product, a local service) — its name, website, what it does, who it is for, and its key pages. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: limit, cursor, space_id.
list_campaign_assetsList campaign assetsARead-onlyInspect
List asset-to-campaign attachments. At least one of campaign_id / asset_id is required. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: limit, cursor, asset_id, space_id, +1 more.
list_campaignsList campaignsARead-onlyInspect
List campaigns visible to this token. Returns an array of campaign objects with fields like id, name, type, budget, status, languages, locations. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: limit, cursor, space_id.
list_competitor_adsList competitor adsARead-onlyInspect
The ads a competitor published in the public ad libraries, active first, each with its library, dates, angle type and the offers in its copy. Library data shows what a competitor published, never what worked. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: competitor_id (required), limit, status, space_id, +2 more.
list_competitorsList competitorsARead-onlyInspect
The competitors of one business: tracked, suggested (with the evidence for each suggestion) and dismissed. A tracked competitor carries a summary: matched ad libraries, active ads, the angle it leads with, and its auction overlap where the user's own ad account reports one. Library data shows what a competitor published, never what worked. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: business_id (required), status, space_id.
list_conceptsList conceptsARead-onlyInspect
List concepts (ways of making an angle's claim) in the active Space. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: limit, cursor, angle_id, space_id.
list_connectionsList ad platform connectionsARead-onlyInspect
List the ad platforms Growomat delivers to and whether this account has connected each one: connected, ready (connected AND an ad account chosen — what trigger_sync needs), the ad account's id, name, currency and time zone, and connection health. Call it before building a campaign: a platform that is not ready cannot be synced to, and budgets are judged in the account's currency (some platforms set a per-currency daily minimum). Connecting a platform happens in the app. Connections belong to the account, not the Space.
Inputs: no named parameters.
list_conversion_actionsList conversion actionsARead-onlyInspect
List the conversion actions in the active Space — what this account counts as a conversion, and how each one is configured (type, category, value settings, lookback windows). Use before uploading a conversion so it lands on the right action. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: limit, cursor, space_id.
list_conversion_sourcesList conversion sourcesARead-onlyInspect
List the revenue/conversion sources connected to the active Space (Stripe, HubSpot, Salesforce, GA4, generic webhook) with their type, status, and config. Use to see which sources are feeding real conversions into Smart Bidding. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: space_id.
list_disapprovalsList disapprovalsARead-onlyInspect
List every ad and keyword your connected ad platforms are NOT serving — disapproved, limited, or area-of-interest-only — for the active Space, each with its review status and the structured reasons / affected markets behind the decision. The cheapest way to answer "why isn't this ad running?" without paging through every ad and keyword. An empty list means nothing is disapproved, not that the tool failed. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: platform, space_id.
list_keywordsList keywordsARead-onlyInspect
List keywords across visible campaigns. Pass ad_group_id or campaign_id to scope the result server-side (recommended — otherwise the whole Space is returned and can overflow the response budget). Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: limit, cursor, platform, space_id, +2 more.
list_open_loopsList the open loopsARead-onlyInspect
The promises the growth manager still has to keep for the active Space, soonest first: each change it will report back on, and when. A loop leaves the list once the manager has reported on it. Read-only. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: space_id.
list_spacesList spacesARead-onlyInspect
List the Spaces (collaboration workspaces) the API token owner is a member of. A Space holds campaigns; most other tools are Space-scoped. Use a returned id with set_active_space to switch the active Space for subsequent calls, or pass it as space_id on individual calls.
Inputs: no named parameters.
list_syncsList syncsARead-onlyInspect
List recent syncs for the active Space (most recent first), with their status and totals. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: limit, cursor, space_id.
preview_campaignPreview campaign adsARead-onlyInspect
Preview how each ad of a campaign will render on every platform, compiled exactly as a sync would send it, plus whether each platform has the media it needs (byPlatform[platformId].ready and .missing). A search ad comes back as text; a post as post; a single-image card (a chat card, type OPENAI_CHAT_CARD) as card — title, body, destinationUrl and imageUrl, with a signed previewUrl you can open. A card format is ready once every ad has an image, its own or one attached with attach_asset_to_ad. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: campaign_id (required), space_id.
preview_sync_planPreview sync planARead-onlyInspect
Dry run: compute what a sync would import / export / remove for the active Space, without executing. Use before trigger_sync to see the blast radius. Honours the same campaign_ids hard scope and force as trigger_sync, and returns a planHash you can pass to trigger_sync (plan_hash) to execute exactly this plan or fail on drift. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: force, space_id, platforms, campaign_ids.
refresh_competitorRefresh competitorAInspect
Read a competitor's ad libraries now instead of at the next daily refresh. Uses one monthly library lookup. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: competitor_id (required), space_id.
reject_competitor_library_accountReject library accountAInspect
Say a library account is not this competitor. It stops being read and is never proposed again. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: body (required), competitor_id (required), space_id.
release_brakeRelease the Emergency BrakeADestructiveInspect
Release an engaged Emergency Brake, re-enabling exactly the campaigns it paused (and only those still paused — a campaign the user changed since is left alone). mode='raise' re-arms the brake against the budget's current amount for the rest of the month; mode='resume' means the user knowingly overrules the budget, so that level stays disarmed until next month. Re-enables live campaigns and therefore resumes real ad spend — confirm intent first.
Inputs: mode, scope, event_id, campaign_id.
set_active_spaceSet active spaceAInspect
Switch the MCP server's active Space. Subsequent tool calls (list_campaigns, create_ad, get_performance_stats, etc.) are scoped to the chosen Space. Validates membership against the token owner's Spaces list and surfaces NOT_A_MEMBER / SPACE_NOT_FOUND as isError results. Idempotent — re-setting to the current Space is a no-op.
Inputs: space_id (required).
set_ad_scheduleSet ad scheduleAInspect
Set a campaign's weekly ad schedule with friendly input and correct, platform-aware timezone handling — the easy front door over update_campaign's adSchedule. Pass HH:MM times, day shorthands (MON…SUN, WEEKDAYS, WEEKEND) and/or a preset. Windows may cross midnight (19:00->07:00) and are auto-split. timezone:'local' uses the searcher's local time on Microsoft (AdScheduleUseSearcherTimeZone); Google cannot localize per searcher, so pass an explicit IANA zone (e.g. 'Europe/Istanbul') to offset-bake the hours to that location relative to the account timezone. Use dry_run:true to preview the exact expanded schedule and any warnings WITHOUT mutating the campaign. Scoped to the active Space.
Inputs: campaign_id (required), preset, dry_run, windows, +3 more.
set_budgetSet budgetAInspect
Set the account budget amount/period and arm or disarm the account-level Emergency Brake. The Emergency Brake is ON by default: when real month-to-date spend passes the budget, Growomat automatically pauses the affected campaigns and notifies the owner. Pass emergency_brake=false to disarm it (spending past the budget will then pause nothing). Raising global_budget re-arms a previously-spent brake for the rest of the month. Writes real configuration that can stop live campaigns — confirm intent before disarming.
Inputs: period, currency, global_budget, emergency_brake, +1 more.
set_geo_targetingSet geo targetingAInspect
Set a campaign's WHOLE geo-targeting set in one call — named areas and radius circles in a single include/exclude list, plus the campaign-level presence-vs-interest choice — the easy front door over update_campaign's geoTargets. Place names in include/exclude are resolved server-side (countries → geo registry → Google suggest); radius entries take lat/lng or an around place name (geocoded). Radius rows can only be INCLUDED (neither platform supports negative proximity — carve out places with an excluded area instead), and a set where every row is negative is rejected (ONLY_EXCLUSIONS). An empty set is legal: no geo criteria = ads can serve anywhere. locationIntent defaults to PRESENCE (people actually in the locations) — deliberately NOT the platforms' wider search-interest default. Use dry_run:true to get the resolved rows + the plain-language effective-targeting sentence (exactly what the UI shows) WITHOUT mutating the campaign. Scoped to the active Space.
Inputs: campaign_id (required), radii, dry_run, exclude, +4 more.
start_asset_uploadStart asset uploadAInspect
Start a two-step upload for a file you can PUT yourself (a script with the file on disk). Returns asset_id, upload_url, and the method and headers to PUT the bytes with; the asset is PROCESSING until complete_asset_upload. In a conversation, use upload_asset instead. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: file_name (required), size_bytes (required), content_type (required), name, +2 more.
suggest_competitorsSuggest competitorsAInspect
Build competitor suggestions from evidence Growomat already holds (auction data, an upload, search terms). Nothing is tracked until someone confirms it. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: business_id (required), space_id.
track_competitorTrack competitorAInspect
Track a competitor of a business by website, ad library page link or name. Adding one IS the person's confirmation, so only call this when the user has chosen this competitor. Refused with 402 LIMIT_REACHED at the plan's per-business cap. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: body (required), space_id.
trigger_syncTrigger syncADestructiveInspect
Push the active Space's campaigns to your connected ad platforms and import remote changes. ASYNCHRONOUS: returns a syncId immediately with status 'started' (or 'nothing_to_sync'); the sync runs in the background. Poll get_sync_status with the syncId until its status is terminal (completed, partial, failed, or cancelled). Spends real ad budget and mutates external platforms. The platform connection is account-wide; the campaigns synced are the active Space's. Fails if a sync is already running in this Space. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: force, options, space_id, plan_hash, +3 more.
unlink_campaignsUnlink campaignsADestructiveInspect
Clear a platform link from the active Space's campaigns, keeping the local campaigns. With delete_remote=true, also removes the campaign on the ad platform (already-gone counts as success). Returns a per-id result map (already-unlinked ids report 'not_linked'). Unlink then trigger_sync to re-create campaigns cleanly on the platform. Mutates external platforms when delete_remote is set. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: platform (required), space_id, campaign_ids, delete_remote.
untrack_competitorUntrack competitorADestructiveInspect
Stop tracking a competitor and remove it from the business. Its library history leaves the account immediately. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: competitor_id (required), space_id.
update_adUpdate adBInspect
Partial update of an ad. Returns the full updated/created object. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: body (required), ad_id (required), space_id.
update_ad_groupUpdate ad groupBInspect
Partial update of an ad group. Returns the full updated/created object. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: body (required), ad_group_id (required), space_id.
update_angleUpdate angleAInspect
Partially update an angle (name, status, angleType — registry ids only). Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: body (required), angle_id (required), space_id.
update_assetUpdate assetAInspect
Partial update of an asset (name, altText, tags, metadata, status, width, height). Identity-like fields (url, contentType, sizeBytes, source) are immutable post-creation. Returns the full updated/created object. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: body (required), asset_id (required), space_id.
update_businessUpdate businessAInspect
Partial update of a business. The optional brand object is the business's brand voice profile — tone dials (formality, energy), voiceNotes, promises and bannedPhrases — and governs all generated ad and social copy for this business. Returns the full updated object. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: body (required), business_id (required), space_id.
update_campaignUpdate campaignAInspect
Partial update of a campaign — body fields are merged into the existing record. Returns the full updated/created object. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: body (required), campaign_id (required), space_id.
update_competitorUpdate competitorAInspect
Rename a competitor, change its domains, move it between tracked, dismissed and suggested, or change its brand terms (the words the copy check will not let generated copy use). Dismissing stops tracking and keeps it from being suggested again. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: body (required), competitor_id (required), space_id.
update_conceptUpdate conceptAInspect
Partially update a concept (name, attributes — registry ids only). Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: body (required), concept_id (required), space_id.
update_conversion_actionUpdate conversion actionAInspect
Partial update of a conversion action (e.g. status, value settings, lookback window). Returns the full updated object. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: body (required), conversion_action_id (required), space_id.
update_keywordUpdate keywordAInspect
Partial update of a keyword (e.g. matchType, status). Returns the full updated/created object. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: body (required), keyword_id (required), space_id.
upload_assetUpload assetAInspect
Upload an image into the asset library so it can go on ads. Send the bytes base64-encoded in data (with an optional file_name), or a url to copy from — fetched once and stored, so a link that expires keeps working. JPEG, PNG, WebP or GIF up to 10 MB; Growomat reads the type, width and height from the file itself and counts it against the plan's storage. Returns the asset: url is its stable address (bind that), previewUrl a short-lived link you can open. Then attach it with attach_asset_to_ad (role MARKETING_IMAGE puts it on a card) or attach_asset_to_campaign. A chat card needs one image of at least 640 × 640. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: url, data, name, tags, +4 more.
upload_auction_insightsUpload auction insightsAInspect
Upload an Auction insights report exported from a platform's own interface, for a platform whose API does not share per-competitor auction data. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: body (required), business_id (required), space_id.
upload_conversion_adjustmentUpload conversion adjustmentAInspect
Upload one or more conversion adjustments — RETRACTION (refund/churn/disqualified lead), RESTATEMENT (value correction: trial→paid, partial refund, downgrade), or ENHANCEMENT (attach hashed identifiers) — so a refunded/churned/upgraded deal stops teaching Smart Bidding the wrong lesson. Pass body as a single adjustment or { adjustments: [ { orderId, adjustmentType, conversionAction, value?, currency?, occurredAt } ] }. Identified by orderId. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: body (required), space_id.
upload_offline_conversionUpload offline conversionAInspect
Upload one or more offline conversions (e.g. a booked call from your CRM) to the ad platform, closing the click-id attribution loop so the platform can credit the originating ad click. Pass body as a single conversion or { conversions: [ { gclid | msclkid, conversionAction (the conversion-action name, e.g. "Booked call"), occurredAt (ISO 8601), value?, currency?, orderId? } ] }. A gclid routes to Google Ads, an msclkid to Microsoft Advertising. Idempotent on orderId — re-uploading the same orderId is a no-op. Scoped to the active Space — see set_active_space to switch, or pass space_id to override for this one call.
Inputs: body (required), space_id.
validate_exportValidate campaign for exportARead-onlyInspect
Pre-flight a campaign before syncing: evaluates it against each connected platform's capability rules with zero platform calls and returns structured findings (blocked / unsupported / degraded / ok). valid: false means at least one platform will REFUSE this campaign — fix the named findings before trigger_sync instead of discovering the refusal in a failed sync. Pass platforms to check specific ones (a named platform is validated even when unconnected).
Inputs: campaign_id (required), platforms.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Run ad campaigns on Meta, Google Ads and LinkedIn from your assistant. Spend waits for your OK.
Manage and optimize your ads on Meta, Google, TikTok, X, ChatGPT Ads, Reddit and LinkedIn from chat.
Run Google Ads and Meta Ads from ChatGPT or Claude: audit wasted spend, create and manage campaigns.
Create, launch, and manage Meta + Google ads from Claude and ChatGPT.
Related MCP Servers
AlicenseNot gradedqualityFmaintenanceConnects Google Ads, Meta Ads, and LinkedIn Ads to AI assistants, enabling natural language ad campaign management, reporting, and optimization across platforms.MIT- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to create, analyze, and optimize ad campaigns across Google Ads, Meta Ads, TikTok Ads, LinkedIn Ads, Amazon Ads, and ChatGPT Ads through natural language using 400+ tools.107MIT
- FlicenseNot gradedqualityCmaintenanceEnables users to build, edit, transfer, report on, and monitor ad campaigns across Meta, Google, TikTok, Snapchat, and other connected ad platforms from Claude, ChatGPT, and other MCP clients.-
- AlicenseNot gradedqualityDmaintenanceEnables full Google Ads management through natural language, including reading campaigns, performance, ROAS, keywords, and search terms, as well as pausing, enabling, removing, and creating campaigns, ad groups, ads, keywords, budgets, and responsive search ads.MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.