adplane

Changes one existing Google Ads campaign, ad group, ad, or keyword. This is the ONLY tool that can start spending: setting status to ENABLED makes the object eligible to serve, so only do it when the user has explicitly asked to launch or resume, and say plainly that it will begin spending. PAUSED stops serving and is reversible. There is no REMOVED status here; nothing this tool does can delete. The changeable fields depend on object_type: a campaign takes name, status, daily_budget, bidding_strategy, target_cpa, and target_roas; an ad_group takes name, status, and cpc_bid; an ad takes status only; a keyword takes status and cpc_bid. Money is in the account currency (50 means 50.00, never micros). bidding_strategy is MAXIMIZE_CLICKS, MAXIMIZE_CONVERSIONS, MANUAL_CPC, or MAXIMIZE_CONVERSION_VALUE. target_cpa is the average cost-per-conversion target and applies only to MAXIMIZE_CONVERSIONS; target_roas is the target return on ad spend as a ratio of conversion value to cost (4 means 400 percent) and applies only to MAXIMIZE_CONVERSION_VALUE. Setting a target alone requires the campaign to already be on its strategy; to switch strategies at the same time, pass bidding_strategy explicitly. A target of 0 clears the stored target. A campaign attached to a shared portfolio bidding strategy is refused for these fields, because changing it here would detach the campaign from the strategy its sibling campaigns share. Changing the strategy or a target on a serving campaign restarts Google's bid-strategy learning phase, so mention that when you do it. A campaign on a shared budget is refused for daily_budget, because changing it would change every campaign on that budget. For ads and keywords, object_id can be the composite adGroupId~id form shown in report resource_names; a bare id also works when it is unambiguous. The response is Google's own view of the object after the change, read back from the API, so report those values rather than what was requested.

Checks whether one Meta ad account is actually ready to build and run ads: account status, payment method, accepted ad terms, available Facebook Pages, app publishability, pixel presence, and spend limits. Call this BEFORE creating campaigns on an account you have not built on in this conversation; the failures it detects (no payment method, missing certification, app not publishable) otherwise surface only midway through a build, after campaigns and ad sets already exist. Read-only and changes nothing. Each check reports ok, warning, action_needed, or unknown; action_needed items block building or delivery, and the response's ready flag is false while any remain. unknown means Meta's API cannot report that fact, so read the detail for what to watch for rather than treating it as a failure.

Creates an ad by attaching an existing creative to an existing ad set. ALWAYS PAUSED: this completes the campaign structure but nothing delivers until meta_update_object sets status to ACTIVE, which you should do only when the user explicitly asks to launch.

Creates an ad creative: the headline, body text, media, destination URL, and call-to-action button an ad shows. Requires a page_id from meta_list_accounts, because every Meta ad is published by a Facebook Page. message is the main body text; headline is the bold line by the media. By default this builds a single-image link creative. To build a single-video creative instead, pass video_id (from meta_upload_video) together with a thumbnail image (image_hash from meta_upload_image, or image_url) which Meta requires on a video creative; the destination link then rides in the call-to-action. If the video is still processing, this can fail until it is ready. A creative is not deliverable on its own, so this creates nothing that can spend; meta_create_ad attaches it to an ad set.

Creates an ad set inside an existing campaign, ALWAYS PAUSED. This is where budget, targeting, and optimization live. targeting must at minimum name geo_locations, e.g. {"geo_locations": {"countries": ["US"]}, "age_min": 25}. You do NOT need to set targeting_automation yourself; the advantage_audience parameter handles it (defaults to False = use your targeting as given, no automatic audience expansion). Budgets are in the account currency (50 means 50.00). If the campaign already has a budget, do not set one here. When optimization_goal is OFFSITE_CONVERSIONS you must pass promoted_object naming the pixel and event, e.g. {"pixel_id": "123", "custom_event_type": "LEAD"}; without it the ad set will not optimize for conversions. Times are ISO 8601 with an offset, e.g. "2026-08-01T09:00:00-0700".

Creates a new Meta campaign. It is ALWAYS created PAUSED and cannot spend money until meta_update_object activates it. objective is required and cannot be changed later, so confirm it with the user first. special_ad_categories is required by Meta: pass NONE unless the ads are about credit, employment, housing, social issues/elections/politics, gambling, or financial products, in which case ask the user rather than guessing. Leave both budget arguments unset to put budgets on the ad sets instead, which is the more predictable setup; setting a budget here turns on campaign budget optimization and its ad sets must then have none. With a campaign budget, bid_strategy defaults to LOWEST_COST_WITHOUT_CAP (automatic bidding, no per-ad-set bid needed); only set it if you specifically want a bid or cost cap, which then requires bid_amount on each ad set. A budgetless campaign takes its bid strategy per ad set instead, so none is sent here. Call meta_get_schema for valid values and the required/conditional-field list.

Permanently deletes ONE Meta campaign that has never spent money, for cleaning up a failed or abandoned campaign that was never launched. This is IRREVERSIBLE and is the only Meta tool that destroys anything, so use it only when the user explicitly asks to delete, and prefer archiving (meta_update_object with status ARCHIVED) whenever the campaign might be wanted again. Only campaigns can be deleted; archive ad sets, ads, and creatives instead. The campaign must have zero lifetime spend: if it has ever spent, or its spend cannot be read, the delete is refused and you are told to archive instead. Deleting a campaign also removes its ad sets and ads.

Returns Meta's own rendering of how an ad or creative appears in a given placement, as a ready-to-embed iframe. Read-only and changes nothing. Pass exactly one of creative_id or ad_id (from meta_list_objects); passing both or neither is an error. ad_format picks the placement (defaults to MOBILE_FEED_STANDARD); call meta_get_schema for the valid values. The response's preview_src URL carries a token that expires within minutes, so treat this as a short-lived rendering aid to check the ad, not a durable link to save or share.

Returns everything the other Meta tools will accept: insight levels, report fields, breakdowns, and the exact enum values for campaign objectives, optimization goals, billing events, bid strategies, statuses, and call-to-action types. You MUST call this before using a field or enum value you have not already used successfully in this conversation. Values not returned here are rejected.

Lists the Meta (Facebook/Instagram) ad accounts this user has connected, plus the Facebook Pages available for ad creatives. Call this first in a conversation to resolve which account_id to use; do not guess or reuse IDs from earlier conversations. All money values in other Meta tools are in each account's currency. Also reports when the Meta connection expires, which matters because Meta connections lapse after about 60 days and must be renewed by the user. Each account carries promotable_page_ids: the Pages configured for that account's Promote/boost flow. This is a NARROW set and is not the list of Pages usable in a creative: building a creative only needs a Page role on the connecting user, which every Page in the top-level pages list already has, so a Page absent from promotable_page_ids (even an empty list) can still be used as a creative's page_id. Treat promotable_page_ids as a hint about promote-flow setup, not a gate on creative building; for creatives, use any Page from the top-level pages list. A page in neither promotable_page_ids nor the top-level pages list is not visible to this login. promotable_page_ids of null means Meta could not report the promote-flow set for that account just now. Every Page in the top-level pages list is usable as a creative's page_id (being in that list means you have the Page role a creative needs), so that list is the set to choose a page_id from. Each such Page also carries business_id: the Business that owns it, or null when it has no owning Business. A null business_id is normal and does not affect usability: Pages you administer by role rather than by Business ownership are fully usable in creatives.

Lists the current configuration of campaigns, ad sets, ads, or ad creatives on one Meta ad account, including status and budgets. This is the structural view; use meta_run_report for performance. Narrow with campaign_id or adset_id. Budgets are returned in the account currency. effective_status is the one to read when asking why something is not delivering: it reflects the parent's state and any review outcome, while status only reflects this object's own setting.

Runs a read-only insights report against one Meta ad account. Money values are in the account currency. date_range accepts a preset like LAST_30_DAYS or an explicit "2026-06-01..2026-06-30"; the response echoes the exact dates used, so state them when presenting results. Set level to control aggregation (account, campaign, adset, ad). Meta reports rates like ctr and cpc per row; the response totals only make sense for additive metrics such as impressions, clicks, and spend. Use action_types (e.g. ["lead", "purchase"]) to pull specific conversion counts and costs into their own columns. Call meta_get_schema for valid fields; do not invent field names.

Searches Meta's ad targeting taxonomy (interests, behaviors, demographics, job titles, and similar) by free text and returns the IDs an ad set's targeting spec accepts. Use this BEFORE building targeting beyond geo and age: taxonomy IDs must come from here, never from memory, because an invented or stale ID is rejected or silently targets the wrong audience. Each result's type names the key it goes under in the targeting spec's flexible_spec, e.g. a result with type interests becomes {"flexible_spec": [{"interests": [{"id": "...", "name": "..."}]}]}. Results include Meta's estimated audience size bounds; prefer specific mid-sized entries over the broadest match.

Changes one existing campaign, ad set, or ad. This is the ONLY tool that can start spending: setting status to ACTIVE makes the object eligible to deliver, so only do it when the user has explicitly asked to launch or resume, and say plainly that it will begin spending. PAUSED stops delivery and is reversible; ARCHIVED hides it and is how you retire something. Budgets and bids are in the account currency. The response is Meta's own view of the object after the change, so report those values rather than what was requested.

Downloads an image from a public URL and uploads it to one Meta ad account's image library, returning the image_hash that meta_create_ad_creative accepts. Use this so the ad's image is a deliberate choice rather than whatever Meta scrapes off the landing page. The URL must serve the image file itself (JPEG, PNG, GIF, or WebP, up to 8 MB) over public http(s), not a page that contains it. Uploading the same image again returns the same hash, so repeating this call is safe. It adds a library asset only; nothing it does can spend money.

Adds a video to one Meta ad account's video library by giving Meta the video's public URL. Meta fetches the video from that URL itself; nothing is proxied through this server, so the URL must be a public http(s) link to the video file (mp4, mov, and similar), not a page that contains it. This server does a quick best-effort check that the URL looks like a video, but Meta is the final validator once it fetches the file, so a URL that passes the check can still be rejected by Meta, and a reachable-only-by-Meta URL is accepted and left for Meta to judge. Returns a video_id that meta_create_ad_creative accepts as its video_id parameter, along with the video's current processing status. Video processing is asynchronous and can take a while: a creative or ad built on a video that is still processing may fail until it is ready, and the response's notice says so. Read the returned status and, if it is still processing, wait before building the creative or retry if creation reports the video is not ready. It adds a library asset only; nothing it does can spend money.

Health check: confirms the OAuth connection works end to end.