AdsAgent — Meta Ads MCP
Server Details
Hosted Meta ads MCP with OAuth, bounded reads, and prepare/confirm writes.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- OAuth
- Works in Glama
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 172 tools
There are multiple parallel workflow families that do the same thing: ads_replace_creative_confirm vs operations_confirm_ad_creative_replace, ads_update_copy_confirm vs operations_confirm_ad_copy_update, launch_confirm vs overview_update_confirm vs operations_confirm_* — literal duplicates with different entry points. Prepare paths overlap heavily too (adsets_prepare_budget_change, campaigns_prepare_budget_change, entities_prepare_update, overview_update_ad_statuses, console_prepare_change), and the descriptions have to spend whole sentences telling the agent which one to prefer. Also near-identical pairs like creatives_refresh_cloud / creatives_cloud_refresh and setup_begin_channel_connect / connections_create_intent / setup_begin_facebook_connect create real misselection risk.
Everything is snake_case with a domain prefix, which is readable and broadly consistent. However verb position varies across the set (ads_get_copy vs account_media_get vs creatives_get; creatives_cloud_refresh vs creatives_refresh_cloud), and confirm/deny/prepare suffixes are applied inconsistently — some flows use _prepare/_confirm/_deny on the domain tool, others route confirm through operations_*.
172 tools is far beyond a well-scoped surface for one agent, and the count is inflated by duplicated confirm/deny endpoints and multiple competing mutation paths rather than distinct capabilities. Even with strong domain breadth, this many tools guarantees that many will never be selected correctly.
Coverage of the Meta ads domain is genuinely broad: accounts, assets, campaigns/adsets/ads lifecycle, creatives and Drive ingestion, insights and breakdowns, targeting, templates, products/funnels, MMP, setup, tasks, notifications and rendering are all represented. Gaps are minor — no hard delete for campaigns/ads or ad sets, and reporting is largely limited to CSV export and a single report renderer.
Available Tools
172 toolsaccount_get_profileARead-onlyInspect
Login identity only. For channel setup: setup_get_status
Inputs: no named parameters. Returns: id, name, email, nickname, +1 more
account_media_getARead-onlyInspect
Read one account media reference; prefer account_media_get_batch for multiple selections
Inputs: media_ref (required). Returns: message, retryable, support_ref
account_media_get_batchARead-onlyInspect
Fetch up to 50 selected account media previews in a batch after listing the index; avoid serial item probes
Inputs: media_refs (required), ad_account_id (required), cursor. Returns: message, retryable, support_ref
account_media_listBRead-onlyInspect
List 50 account media index entries; select candidates, then use account_media_get_batch. Check setup_get_status policy
Inputs: media_type (required), ad_account_id (required), limit, cursor. Returns: message, retryable, support_ref
accounts_find_ownerCRead-onlyInspect
Find account owner and token provenance
Inputs: ad_account_id (required), operation. Returns: message, retryable, support_ref
accounts_get_account_detailARead-onlyInspect
Read live Meta details for one ad account authorized in your workspace; app bindings are cached, no BM links. BM topology: assets_lookup_business_links
Inputs: ad_account_id (required). Returns: message, retryable, support_ref
accounts_list_eligible_pagesARead-onlyInspect
List pages eligible for ad creation on one ad account (snapshot read)
Inputs: ad_account_id (required). Returns: message, retryable, support_ref
accounts_list_instagram_accountsDRead-onlyInspect
List IG IDs
Inputs: page_id (required), ad_account_id (required), limit, cursor. Returns: message, retryable, support_ref
accounts_list_linked_accountsARead-onlyInspect
Read linked Meta ad accounts and their Facebook connection labels from stored workspace routing. Filter then paginate. refresh rereads stored rows; this tool does not sync Meta, queue work, or save snapshots. BM links: assets_lookup_business_links
Inputs: limit, cursor, search, refresh, +1 more. Returns: message, retryable, support_ref
adsets_prepare_bid_changeAInspect
Prepare one ad set bid-amount change: read current Meta settings in your authorized account and save an approval draft. Returns approval_ref and plan_digest; apply only after approval with operations_confirm_adset_bid. This call does not change delivery. Prefer entities_prepare_update for new work
Inputs: adset_id (required), bid_amount (required), ad_account_id (required). Returns: message, retryable, support_ref
adsets_prepare_budget_changeAInspect
Prepare one ad set daily-budget change: read current Meta settings in your authorized account and save an approval draft. Returns approval_ref and plan_digest; apply only after approval with operations_confirm_adset_budget. This call does not change delivery. Prefer entities_prepare_update for new work
Inputs: adset_id (required), daily_budget (required), ad_account_id (required). Returns: message, retryable, support_ref
adsets_prepare_status_changeAInspect
Prepare one ad set status change: read current Meta settings in your authorized account and save an approval draft. Returns approval_ref and plan_digest; apply only after approval with operations_confirm_adset_status. This call does not change delivery. Prefer entities_prepare_update for new work
Inputs: adset_id (required), ad_account_id (required), target_configured_status (required). Returns: message, retryable, support_ref
ads_get_copyBRead-onlyInspect
Read stored copy of 1-50 ads: texts, links, button, Page, preview, type
Inputs: ad_ids (required). Returns: message, retryable, support_ref
ads_prepare_status_changeAInspect
Prepare one ad status change: read current Meta settings in your authorized account and save an approval draft. Returns approval_ref and plan_digest; apply only after approval with operations_confirm_ad_status. This call does not change delivery. Prefer entities_prepare_update for new work
Inputs: ad_id (required), ad_account_id (required), target_configured_status (required). Returns: message, retryable, support_ref
ads_replace_creative_confirmBDestructiveIdempotentInspect
Run the change the user just confirmed: set the reviewed media field of one Meta ad from current to approved value
Inputs: confirm_token (required), new_value, old_value, entity_name. Returns: message, retryable, support_ref
ads_replace_creative_denyBDestructiveInspect
Deny a prepared in-place creative swap
Inputs: confirm_token (required). Returns: message, retryable, support_ref
ads_replace_creative_prepareCInspect
Prepare in-place library-creative swap on an existing ad
Inputs: ad_id (required), ad_account_id (required), ad_name, account_id, +4 more. Returns: message, retryable, support_ref
ads_replace_page_confirmBDestructiveIdempotentInspect
Run the change the user just confirmed: set the reviewed identity field of one Meta ad from current to approved value
Inputs: confirm_token (required), new_value, old_value, entity_name. Returns: message, retryable, support_ref
ads_replace_page_denyCDestructiveInspect
Deny a prepared in-place page swap
Inputs: confirm_token (required). Returns: message, retryable, support_ref
ads_replace_page_prepareBInspect
Prepare page swap; may upload media to Meta. Confirm separately to apply
Inputs: ad_id (required), ad_account_id (required), ad_name, page_id, +4 more. Returns: message, retryable, support_ref
ads_update_copy_confirmBDestructiveIdempotentInspect
Run the change the user just confirmed: set the reviewed text fields of one Meta ad from current to approved values
Inputs: confirm_token (required), new_value, old_value, entity_name. Returns: message, retryable, support_ref
ads_update_copy_denyBDestructiveInspect
Discard prepared copy edits without changing the ad
Inputs: confirm_token (required). Returns: message, retryable, support_ref
ads_update_copy_prepareBInspect
Prepare body/title/description edits on the same Ad ID, preserving media and Page
Inputs: ad_id (required), ad_account_id (required), body, title, +1 more. Returns: message, retryable, support_ref
ads_update_url_prepareBInspect
Prepare a destination URL change on the same Ad ID; confirm/deny via operations
Inputs: ad_id (required), ad_account_id (required), destination_url (required). Returns: message, retryable, support_ref
assets_list_ad_accountsAInspect
List Meta ad accounts this workspace can use, with routing flags. Cache miss/authorized refresh may queue private work; filter then paginate; assets_lookup_business_links
Inputs: limit, cursor, search, refresh, +1 more. Returns: message, retryable, support_ref
assets_list_businessesBInspect
List Meta Business Managers visible to this workspace. Cache miss/authorized refresh may queue private work; filter then paginate; assets_lookup_business_links
Inputs: limit, cursor, search, refresh, +1 more. Returns: message, retryable, support_ref
assets_list_instagram_accountsCRead-onlyInspect
List cached Instagram IDs and names from Auto Pull Assets
Inputs: limit, cursor, search, ad_account_id. Returns: message, retryable, support_ref
assets_list_pagesBInspect
List Facebook Pages this workspace can advertise with, with health. Cache miss/authorized refresh may queue private work; filter then paginate; assets_lookup_business_links
Inputs: limit, cursor, search, refresh, +1 more. Returns: message, retryable, support_ref
assets_lookup_business_linksARead-onlyInspect
Read cached BM links. Choose exactly one: business_id, ad_account_id, page_id, or FB-user identity such as fb_user_label; never combine an asset ID with an FB user. Snapshot edges may be incomplete; no match does not prove no relationship or ownership. OAuth-safe
Inputs: page_id, business_id, ad_account_id, fb_user_label. Returns: message, retryable, support_ref
assets_pickCRead-onlyInspect
Choose one cached ad account, Facebook Page or Instagram account
Inputs: kind (required), search, ad_account_id. Returns: message, retryable, support_ref
assets_refresh_ad_accountBInspect
Refresh one account and its connection Page cache
Inputs: ad_account_id (required), page_id. Returns: message, retryable, support_ref
assets_refresh_allBInspect
Queue an asset snapshot refresh
Inputs: no named parameters. Returns: message, retryable, support_ref
assets_search_mentionsBRead-onlyInspect
Search the caller's ad accounts, products and campaigns for composer @-mentions
Inputs: query. Returns: items, support_ref
assets_update_account_permissionsCDestructiveInspect
Update allow_create, allow_pull, and allow_decision routing flags
Inputs: ad_account_id (required), allow_pull, allow_create, allow_decision. Returns: message, retryable, support_ref
billing_get_usageCRead-onlyInspect
Read plan and measured usage (free during the public beta)
Inputs: meter, period, channel. Returns: message, retryable, support_ref
campaigns_prepare_budget_changeAInspect
Prepare one campaign daily-budget change: read current Meta settings in your authorized account and save an approval draft. Returns approval_ref and plan_digest; apply only after approval with operations_confirm_campaign_budget. This call does not change delivery. Prefer entities_prepare_update for new work
Inputs: campaign_id (required), daily_budget (required), ad_account_id (required). Returns: message, retryable, support_ref
campaigns_prepare_budget_changesAInspect
Prepare 1-10 campaign daily-budget changes: read current Meta budgets and save one approval draft. Returns approval_ref and plan_digest; apply only after approval with operations_confirm_campaign_budgets. This call does not change delivery. Prefer entities_prepare_update for new work
Inputs: items (required). Returns: message, retryable, support_ref
campaigns_prepare_status_changeAInspect
Prepare one campaign status change: read current Meta settings in your authorized account and save an approval draft. Returns approval_ref and plan_digest; apply only after approval with operations_confirm_campaign_status. This call does not change delivery. Prefer entities_prepare_update for new work
Inputs: campaign_id (required), ad_account_id (required), target_configured_status (required). Returns: message, retryable, support_ref
campaigns_quick_createCInspect
Use ad_account_id, template_id or template_name, and either creative_source or nonempty groups. Append: append_mode + target. Copy: copy_ad_quick_copy. If truncated, read the same approval with operations_get_approval. Confirm with operations_confirm_campaign_create after user approval. ABO groups:[{"key":"g1","creatives":["id"],"budget":10}]. Budget each group. Omit shared amounts. Pause: activation:{"requested":"paused"}. execution.adset_count: omit or match. Ask on CBO/lifetime. Use the workflow's original link_id when exposed.
Inputs: request (required). Returns: message, retryable, support_ref
campaigns_quick_create_reviseCDestructiveInspect
Revise QuickCreate. If truncated, read the same approval with operations_get_approval.
Inputs: patch (required), approval_ref (required), expected_plan_digest (required). Returns: message, retryable, support_ref
campaigns_reconcile_campaign_planCRead-onlyInspect
Reconcile fixed existing-Ad campaign plans before prepare
Inputs: request (required). Returns: message, retryable, support_ref
campaigns_recreate_from_taskCInspect
Prepare recreate from a prior create task Use the workflow's original link_id when exposed.
Inputs: task_ref (required), failed_items_only. Returns: message, retryable, support_ref
connections_check_intentARead-onlyInspect
Check one existing authorization handle after the user finishes: intent_id accepts ci_*, Meta connect_id or fbconn_live_* handles. Returns status/channel or not_found_or_expired. Reuse the link while valid; do not start automatic polling. For setup connect_id use setup_check_channel_connect
Inputs: intent_id (required). Returns: message, retryable, support_ref
connections_create_intentAInspect
Create a single-use browser authorization link for channel=meta|google_ads|tiktok and mode=add_connection; returns connect_url for human authorization. Prefer setup_begin_channel_connect when you need its explicit connect_id/check workflow
Inputs: channel (required), mode. Returns: message, retryable, support_ref
connections_disconnect_guideBRead-onlyInspect
Facebook link and steps for the user to remove AdsAgent's access
Inputs: no named parameters. Returns: message, retryable, support_ref
connections_listCRead-onlyInspect
List redacted platform connections
Inputs: limit, cursor, channel. Returns: message, retryable, support_ref
console_export_csvCInspect
Export stored Console metrics as CSV
Inputs: scope (required), date_to (required), group_by (required), date_from (required), +5 more. Returns: message, retryable, support_ref
console_get_stored_entity_evidenceCRead-onlyInspect
Read stored entity configuration evidence
Inputs: entity_ids (required), entity_type (required), ad_account_id, result_cursor. Returns: message, retryable, support_ref
console_prepare_changeCInspect
Prepare a Console delivery change for approval
Inputs: action (required), entity_id (required), new_value (required), entity_type (required), +2 more. Returns: message, retryable, support_ref
console_query_overviewCRead-onlyInspect
Read a stored dashboard page in USD
Inputs: scope (required), date_to (required), group_by (required), date_from (required), +13 more. Returns: message, retryable, support_ref
copy_ad_clone_structureAInspect
Prepare a same-account 1:1 campaign/ad-set tree clone, keeping each ad's creative. Pass ad_account_id and exactly one source_campaign_id or source_adset_id; copies=1-10. paused is default; inherit may resume spend. Use copy_ad_quick_copy to expand selected ads. Review exclusions, then launch_confirm after approval Use the workflow's original link_id when exposed.
Inputs: ad_account_id (required), copies, targeting, start_time, +5 more. Returns: message, retryable, support_ref
copy_ad_quick_copyAInspect
Prepare copies of live ads: request_mode=single uses ad_id, source_ad_account_id and target_ad_account_id; grouped uses grouped_plan.campaigns. v3 requires explicit statuses. Choose preserve_post/new_creatives; partnership preserves the post. For a whole tree use copy_ad_clone_structure. Review, then launch_confirm Use the workflow's original link_id when exposed.
Inputs: request (required). Returns: message, retryable, support_ref
creatives_abandon_uploadBDestructiveInspect
Reconcile and explicitly abandon one failed creative upload generation
Inputs: file_hash (required), upload_attempt (required), idempotency_key (required), folder_name. Returns: message, retryable, support_ref
creatives_cloud_bindAInspect
Get a one-time link that connects a Google Drive folder as a read-only cloud folder. Give invite_url to the user or their designer; files appear in creatives_list after they finish. Max 10 cloud folders
Inputs: no named parameters. Returns: message, retryable, support_ref
creatives_cloud_refreshAInspect
Queue a background refresh after files are added to connected Drive folders. Reuses running work and respects cooldown and quota limits. Read progress with creatives_cloud_status
Inputs: no named parameters. Returns: message, retryable, support_ref
creatives_cloud_statusARead-onlyInspect
List connected Google Drive cloud folders with sync progress, last sync and errors. Their files already appear in creatives_list. Connect another with creatives_cloud_bind (max 10). No remaining quota is reported; over-cap downloads return cloud_daily_egress_exceeded
Inputs: no named parameters. Returns: message, retryable, support_ref
creatives_confirm_uploadCIdempotentInspect
Confirm a prepared creative upload using its selection key and file hash
Inputs: file_hash (required), selection_key (required), folder_name. Returns: message, retryable, support_ref
creatives_create_folderCInspect
Create a creative folder for the current workspace
Inputs: folder_name (required). Returns: message, retryable, support_ref
creatives_deleteBDestructiveInspect
Delete one owned creative by selection key or creative reference
Inputs: selection_key. Returns: message, retryable, support_ref
creatives_getARead-onlyInspect
Get one owned creative by selection_key: details plus signed download and thumbnail links
Inputs: selection_key. Returns: message, retryable, support_ref
creatives_get_batchBRead-onlyInspect
Get 1-50 owned creatives by selection_key: per-item status, details and signed links
Inputs: selection_keys (required), cursor. Returns: message, retryable, support_ref
creatives_listCRead-onlyInspect
Uploads plus bound Drive. library_source=all (default) or cloud. Materials/videos/months include cloud. Dates need a timezone offset; cloud uses Drive modified_time. Follow next_cursor, same filters; uploads page first. names<=50 exact filenames. Upload: Creative library. No list call is needed just for instructions
Inputs: q, sort, limit, names, +7 more. Returns: message, retryable, support_ref
creatives_list_cloudARead-onlyInspect
Deprecated until 2026-11-18. Use creatives_list(library_source='cloud'); it returns the same cloud files with folder_path
Inputs: q, limit, parent_id. Returns: message, retryable, support_ref
creatives_list_foldersBRead-onlyInspect
Uploaded folders plus read-only Drive cloud folders (library_source='cloud'). Browse one with creatives_list(folder_name=...)
Inputs: limit, cursor. Returns: message, retryable, support_ref
creatives_pickCRead-onlyInspect
Choose creatives from the caller's library, newest first
Inputs: q, limit, max_select, folder_name. Returns: message, retryable, support_ref
creatives_refresh_cloudAInspect
Queue a background refresh of this tenant's connected cloud (Drive) folders
Inputs: no named parameters. Returns: message, retryable, support_ref
creatives_request_uploadCInspect
Prepare a creative upload and return bounded upload metadata
Inputs: filename (required), file_hash (required), file_size (required), content_type (required), +3 more. Returns: message, retryable, support_ref
creatives_topCRead-onlyInspect
Rank reusable media by cached ad performance
Inputs: limit, metric, window, min_spend, +4 more. Returns: message, retryable, support_ref
entities_lookup_by_nameARead-onlyInspect
Find ads, ad groups, and campaigns by name, and find which ad groups use a creative or file name. Use this tool when the user asks to find an ad, an ad group, or a campaign by name, or asks where a creative or file is used. Do not use insight search or a creative library for that question. Exact matching ignores case and preserves spelling. Substring matching ignores case, media extensions, and separator differences such as spaces, underscores, dots, and hyphens. Separators do not match arbitrary letters. A name matches as a substring when its folded form has at least 8 characters, or at least 2 characters when that form contains Han, Hiragana, Katakana, or Hangul. Accepts 1-50 names of 1-255 characters each. ad_account_ids is optional; on Meta pass act_ followed by digits, or digits only. Returns delivery status, the parent campaign status, the parent ad group status, the budget owner, today's spend, last-7-day spend, and prepare_groups. status=delivering omits rows that are not delivering. Reads cached data only and does not change anything. When next_cursor is set, pass it as result_cursor to read the next page. A result without next_cursor has no further page.
Inputs: names (required), levels, status, group_by, +2 more. Returns: rows, as_of, limits, channel, +8 more
entities_prepare_updateAInspect
Prepare one AdsAgent approval to change status, budget, bid, targeting or other fields of 1-10 campaigns, ad sets or ads
Inputs: ids (required), level (required), changes (required), ad_account_id (required). Returns: message, retryable, support_ref
fb_users_listARead-onlyInspect
Read stored FB labels/status/expiry/routing, never credentials; filter then paginate. refresh rereads rows; no Meta sync, token refresh, queued work or snapshot writes. BM: assets_lookup_business_links. Access is not full Settings. Use the same AdsAgent account
Inputs: limit, cursor, search, refresh, +1 more. Returns: message, retryable, support_ref
fb_users_refresh_routingCInspect
Queue an ad-account routing refresh for one FB user
Inputs: fb_user_label. Returns: message, retryable, support_ref
fb_users_update_labelCDestructiveInspect
Set the display label for one FB user connection
Inputs: label (required), owner_ref, fb_user_label. Returns: message, retryable, support_ref
fb_users_update_permissionsCDestructiveInspect
Update one FB user's allow_create, allow_pull, and allow_decision flags
Inputs: allow_pull, allow_create, fb_user_label, allow_decision. Returns: message, retryable, support_ref
insights_export_csvCInspect
Export or queue CSV for one bounded scope
Inputs: group_by (required), search, date_to, filters, +7 more. Returns: message, retryable, support_ref
insights_get_date_rangeBRead-onlyInspect
Read stored Insights date coverage
Inputs: no named parameters. Returns: message, retryable, support_ref
insights_pull_insightsCInspect
Queue a fresh pull of standard Meta insight rows
Inputs: days. Returns: message, retryable, support_ref
insights_pull_product_breakdownsAInspect
Fetch country, placement, age, gender, OS, or hourly Meta metrics for selected products and dates. Uses stored coverage or queues a bounded pull and returns task_ref; poll tasks_get_status, then read each dimension with insights_read_breakdowns. New pulls consume the existing daily quota without changing ad delivery
Inputs: level (required), date_to (required), date_from (required), ad_ids, +5 more. Returns: message, retryable, support_ref
insights_query_batch_overviewBRead-onlyInspect
Cached batch: each needs product_ref/product_name/ad_account_id; group_by, YYYY-MM-DD date_from/date_to; page for all. Partial=unknown, never zero. Use advertised insights_query_consistent
Inputs: scopes (required), group_by (required), page, search, +10 more. Returns: message, retryable, support_ref
insights_query_consistentAInspect
Read Meta ad metrics for authorized products/accounts and dates by account/campaign/adset/ad. query_contract_version=1 needs group_by, YYYY-MM-DD date_from/date_to, exactly one scope/scopes via request OR direct fields. cached and fresh_if_available read stored data with as-of time; live refresh is temporarily unavailable. Check complete and coverage for gaps; partial is unknown, never zero. If has_more, increment page; keep filters. Find names with entities_lookup_by_name.
Inputs: page, scope, fields, scopes, +17 more. Returns: message, retryable, support_ref, data_observed_at, +4 more
insights_query_overviewARead-onlyInspect
Find names with entities_lookup_by_name, not this search. Read stored aggregated insights for one product/account and YYYY-MM-DD date_from/date_to; group_by=account/campaign/adset/ad. No refresh. Paginate while has_more. Use insights_query_batch_overview for many scopes, or insights_query_consistent
Inputs: group_by (required), page, search, date_to, +12 more. Returns: message, retryable, support_ref, data_observed_at, +4 more
insights_read_breakdownsAInspect
Read country, placement, age, gender, OS, or hourly Meta metrics for one product_ref or product_name and date window. Returns stored rows and full-scope totals; a cache miss may queue a bounded pull and return task_ref. Poll tasks_get_status, then repeat the read with identical filters. Automatic pulls use the existing daily quota; ad delivery is unchanged
Inputs: level, limit, ad_ids, cursor, +7 more. Returns: message, retryable, support_ref
interests_archiveBDestructiveInspect
Archive one saved audience pack by its exact public name
Inputs: interest_pack_name. Returns: message, retryable, support_ref
interests_fetch_from_adsetBRead-onlyInspect
Preview a reusable audience pack from one live Meta ad set
Inputs: adset_id (required), ad_account_id (required). Returns: message, retryable, support_ref
interests_getARead-onlyInspect
Read an audience pack by exact name
Inputs: interest_pack_name. Returns: message, retryable, support_ref
interests_keep_draftCInspect
Keep a launch draft as an audience pack
Inputs: draft_name (required), interest_pack_name. Returns: message, retryable, support_ref
interests_listCRead-onlyInspect
List saved audience packs
Inputs: limit, cursor, search, include_archived. Returns: message, retryable, support_ref
interests_save_fetched_packBInspect
Read targeting from one Ad Set in your authorized Meta accounts and save a reusable audience pack in your private AdsAgent workspace
Inputs: adset_id (required), ad_account_id (required), interest_pack_name (required), tags, +1 more. Returns: message, retryable, support_ref
interests_save_targetsCInspect
Save targeting_search picks as an audience pack
Inputs: targets (required), interest_pack_name (required), tags, notes. Returns: message, retryable, support_ref
interests_searchARead-onlyInspect
Search Meta interest IDs by keyword; limit up to 25
Inputs: query (required), limit. Returns: message, retryable, support_ref
interests_use_targetsADestructiveInspect
Create or reuse a temporary audience-targeting draft in AdsAgent from targeting_search picks and return its interest_pack_name. Does not create, publish, or modify Meta ads. Unkept drafts expire after 7 days; this call may delete expired drafts
Inputs: targets (required). Returns: message, retryable, support_ref
launch_confirmBDestructiveIdempotentInspect
Run the change the user just confirmed in this conversation: build the approved campaign structure as a queued task. Requires the exact single-use confirm_token from its prepare, once. Lost token: operations_get_approval; follow its next_action. Replies: results, not approval handles/JSON/debug.
Inputs: confirm_token (required), copies, ad_count, currency, +4 more. Returns: message, retryable, support_ref
launch_denyADestructiveInspect
Discard a prepared QuickCreate, recreate, ad-copy or structural-clone draft using its exact confirm_token. No Meta write. For a lost token, use operations_get_approval then operations_deny_approval with approval_ref and expected_plan_digest
Inputs: confirm_token (required). Returns: message, retryable, support_ref
mmp_get_stateBRead-onlyInspect
Read MMP mapping, cohort, and funnel state
Inputs: no named parameters. Returns: message, retryable, support_ref
mmp_insights_get_product_event_todayCRead-onlyInspect
Read today's events; channel_pid required
Inputs: event_name (required), channel_pid (required), today, breakdown, +2 more. Returns: message, retryable, support_ref
mmp_insights_get_product_todayCRead-onlyInspect
Read today's D0 cohort; channel_pid required
Inputs: channel_pid (required), today, event_keys, product_ref, +1 more. Returns: message, retryable, support_ref
mmp_insights_query_product_cohortCRead-onlyInspect
Read cohorts; channel_pid required
Inputs: date_to (required), date_from (required), channel_pid (required), cursor, +4 more. Returns: message, retryable, support_ref
mmp_insights_query_product_event_summaryCRead-onlyInspect
Read event totals; channel_pid required
Inputs: date_to (required), date_from (required), event_name (required), channel_pid (required), +4 more. Returns: message, retryable, support_ref
notifications_ackCDestructiveInspect
Acknowledge one TaskTools notification
Inputs: notification_id (required). Returns: message, retryable, support_ref
notifications_listCRead-onlyInspect
List TaskTools notifications
Inputs: limit, cursor, status, severity. Returns: message, retryable, support_ref
notifications_resolveCDestructiveInspect
Resolve one TaskTools notification
Inputs: notification_id (required). Returns: message, retryable, support_ref
notifications_scanCDestructiveInspect
Refresh alerts; may notify configured channels
Inputs: no named parameters. Returns: message, retryable, support_ref
notifications_summaryARead-onlyInspect
Read notification lifecycle counts and the push events a client can subscribe to (events/subscribe)
Inputs: no named parameters. Returns: message, retryable, support_ref
open_ads_consoleAds ConsoleCRead-onlyInspect
Open Insights; expect_account_label checks the intended OAuth account, never switches connections
Inputs: date_to, date_from, product_ref, expect_account_label. Returns: message, retryable, support_ref
operations_confirm_ad_copyBDestructiveIdempotentInspect
Run the change the user just confirmed in this conversation: copy the approved Meta ad as a queued task. Requires approval_ref and expected_plan_digest
Inputs: approval_ref (required), expected_plan_digest (required), ad_count, currency, +2 more. Returns: message, retryable, support_ref
operations_confirm_ad_copy_updateADestructiveIdempotentInspect
Run the change the user just confirmed in this conversation: set the reviewed text fields of one Meta ad from current to approved values. Requires approval_ref and expected_plan_digest
Inputs: approval_ref (required), expected_plan_digest (required), new_value, old_value, +1 more. Returns: message, retryable, support_ref
operations_confirm_ad_creative_replaceBDestructiveIdempotentInspect
Run the change the user just confirmed in this conversation: set the reviewed media field of one Meta ad from current to approved value. Requires approval_ref and expected_plan_digest
Inputs: approval_ref (required), expected_plan_digest (required), new_value, old_value, +1 more. Returns: message, retryable, support_ref
operations_confirm_ad_grouped_copyBDestructiveIdempotentInspect
Run the change the user just confirmed in this conversation: copy the approved group of Meta ads as a queued task. Requires approval_ref and expected_plan_digest
Inputs: approval_ref (required), expected_plan_digest (required), ad_count, adset_count, +1 more. Returns: message, retryable, support_ref
operations_confirm_ad_page_replaceBDestructiveIdempotentInspect
Run the change the user just confirmed in this conversation: set the reviewed identity field of one Meta ad from current to approved value. Requires approval_ref and expected_plan_digest
Inputs: approval_ref (required), expected_plan_digest (required), new_value, old_value, +1 more. Returns: message, retryable, support_ref
operations_confirm_adset_bidADestructiveIdempotentInspect
Run the change the user just confirmed in this conversation: set the bid amount of one Meta ad set from the current amount to the approved amount. Requires approval_ref and expected_plan_digest
Inputs: approval_ref (required), expected_plan_digest (required), currency, new_value, +2 more. Returns: message, retryable, support_ref
operations_confirm_adset_budgetADestructiveIdempotentInspect
Run the change the user just confirmed in this conversation: set the daily budget of one Meta ad set from the current amount to the approved amount. Requires approval_ref and expected_plan_digest
Inputs: approval_ref (required), expected_plan_digest (required), currency, new_value, +2 more. Returns: message, retryable, support_ref
operations_confirm_adset_statusADestructiveIdempotentInspect
Run the change the user just confirmed in this conversation: set the reviewed status field of one Meta ad set from current to approved value. Requires approval_ref and expected_plan_digest
Inputs: approval_ref (required), expected_plan_digest (required), new_value, old_value, +1 more. Returns: message, retryable, support_ref
operations_confirm_ad_statusBDestructiveIdempotentInspect
Run the change the user just confirmed in this conversation: set the reviewed status field of one Meta ad from current to approved value. Requires approval_ref and expected_plan_digest
Inputs: approval_ref (required), expected_plan_digest (required), new_value, old_value, +1 more. Returns: message, retryable, support_ref
operations_confirm_ad_statusesADestructiveIdempotentInspect
Run the change the user just confirmed in this conversation: set the reviewed status field of the approved Meta ads from current to approved values. Confirm with approval_ref and expected_plan_digest only
Inputs: approval_ref (required), expected_plan_digest (required), currency, new_value, +5 more. Returns: message, retryable, support_ref
operations_confirm_ad_url_updateADestructiveIdempotentInspect
Run the change the user just confirmed in this conversation: set the reviewed link field of one Meta ad from current to approved value. Requires approval_ref and expected_plan_digest
Inputs: approval_ref (required), expected_plan_digest (required), new_value, old_value, +1 more. Returns: message, retryable, support_ref
operations_confirm_campaign_budgetADestructiveIdempotentInspect
Run the change the user just confirmed in this conversation: set the daily budget of one Meta campaign from the current amount to the approved amount. Requires approval_ref and expected_plan_digest
Inputs: approval_ref (required), expected_plan_digest (required), currency, campaign_name, +2 more. Returns: message, retryable, support_ref
operations_confirm_campaign_budgetsADestructiveIdempotentInspect
Run the change the user just confirmed in this conversation: set the daily budgets of the approved Meta campaigns from the current amounts to the approved amounts. Confirm with approval_ref and expected_plan_digest only
Inputs: approval_ref (required), expected_plan_digest (required), currency, new_value, +5 more. Returns: message, retryable, support_ref
operations_confirm_campaign_createBDestructiveIdempotentInspect
Run the change the user just confirmed in this conversation: build the approved Meta campaign structure as a queued task. Requires approval_ref and expected_plan_digest
Inputs: approval_ref (required), expected_plan_digest (required), ad_count, currency, +3 more. Returns: message, retryable, support_ref
operations_confirm_campaign_recreateBDestructiveIdempotentInspect
Run the change the user just confirmed in this conversation: recreate the approved Meta campaign structure from a prior task as a queued task. Requires approval_ref and expected_plan_digest
Inputs: approval_ref (required), expected_plan_digest (required), ad_count, adset_count, +2 more. Returns: message, retryable, support_ref
operations_confirm_campaign_statusBDestructiveIdempotentInspect
Run the change the user just confirmed in this conversation: set the reviewed status field of one Meta campaign from current to approved value. Requires approval_ref and expected_plan_digest
Inputs: approval_ref (required), expected_plan_digest (required), new_value, old_value, +1 more. Returns: message, retryable, support_ref
operations_confirm_entity_updateADestructiveIdempotentInspect
Run the change the user just confirmed in this conversation: set the reviewed Meta entity fields from current to approved values. Confirm with approval_ref and expected_plan_digest only
Inputs: approval_ref (required), expected_plan_digest (required), currency, new_value, +5 more. Returns: message, retryable, support_ref
operations_confirm_product_delivery_pauseADestructiveIdempotentInspect
Run the change the user just confirmed in this conversation: set the approved product family campaigns in Meta from active to paused. Requires approval_ref and expected_plan_digest
Inputs: approval_ref (required), expected_plan_digest (required), entity_count. Returns: message, retryable, support_ref
operations_confirm_structure_cloneBDestructiveIdempotentInspect
Run the change the user just confirmed in this conversation: clone the approved Meta campaign or ad set structure as a queued task. Requires approval_ref and expected_plan_digest
Inputs: approval_ref (required), expected_plan_digest (required), copies, ad_count, +2 more. Returns: message, retryable, support_ref
operations_deny_approvalADestructiveInspect
Deny a prepared operation by approval_ref and expected_plan_digest from operations_get_approval. Invalidates that draft without applying it; rejects a stale digest. No Meta write. Works across supported approval types
Inputs: approval_ref (required), expected_plan_digest (required). Returns: message, retryable, support_ref
operations_getBRead-onlyInspect
Read a mutation receipt by mutation_ref or creative upload receipt by upload_ref
Inputs: upload_ref, mutation_ref, response_mode. Returns: message, retryable, support_ref
operations_get_approvalARead-onlyInspect
Read single/batch approval pages: same approval_ref+next_cursor; review all, then confirm once after user agreement Use the workflow's original link_id when exposed.
Inputs: approval_ref (required), cursor. Returns: message, retryable, support_ref
operations_get_contextDRead-onlyInspect
Recover mutation, task, approval, and policy context Use the workflow's original link_id when exposed.
Inputs: limit, since, cursor, task_ref, +5 more. Returns: message, retryable, support_ref
overview_get_live_configsAInspect
Read current Meta status, budget, bid, and other settings for up to 50 known campaigns, ad sets, or ads in your authorized accounts. With mutation_ref, also save verification of that operation in AdsAgent using its original writer. Does not change ads or delivery
Inputs: entities (required), mutation_ref, response_mode, metadata_contract_version. Returns: message, retryable, support_ref
overview_update_ad_statusesAInspect
Prepare 1-10 ad configured-status changes in OAuth Safe Mode. Each item needs ad_id, ad_account_id and target_configured_status=ACTIVE|PAUSED. Configured ACTIVE does not prove delivery: a parent may be paused. Review current/new values, then overview_update_confirm after approval
Inputs: items (required). Returns: message, retryable, support_ref
overview_update_confirmADestructiveIdempotentInspect
Run the change the user just confirmed in chat: set the reviewed Meta entity fields from current to approved values; exact single-use confirm_token from prepare, once; stops at first failed or uncertain item. Replies: results, not approval handles/JSON/debug.
Inputs: currency, new_value, old_value, entity_name, +10 more. Returns: message, retryable, support_ref
overview_update_denyADestructiveInspect
Discard a prepared status, campaign/ad-set budget or bid update with its exact single-use confirm_token. No Meta write. Use launch_deny for creation/copy drafts and products_delivery_pause_deny for product-family pauses
Inputs: approval_ref, confirm_token, expected_plan_digest. Returns: message, retryable, support_ref
products_delivery_pause_confirmADestructiveIdempotentInspect
Run the pause the user just confirmed in chat: product-family campaigns active to paused, with the exact pd_confirm_* from its prepare, once. Replies: results, not approval handles/JSON/debug.
Inputs: confirm_token (required), entity_count. Returns: message, retryable, support_ref
products_delivery_pause_denyADestructiveInspect
Discard a product-family pause draft using the exact pd_confirm_* token from products_delivery_pause_prepare. No Meta write. Use overview_update_deny for individual status/budget/bid drafts and launch_deny for creation/copy drafts
Inputs: confirm_token (required). Returns: message, retryable, support_ref
products_delivery_pause_prepareAInspect
Prepare a pause of live-verifiable ACTIVE campaigns for 1-20 owned product_refs in your authorized Meta accounts; expected_scope=all_live_active_campaigns. Saves an approval draft. Review excluded inventory and budget drift. Prepare does not pause Meta. After approval pass its pd_confirm_* token to products_delivery_pause_confirm
Inputs: product_refs (required), expected_scope. Returns: message, retryable, support_ref
products_funnel_confirmBDestructiveIdempotentInspect
Apply a prepared funnel with its one-time confirm token
Inputs: confirm_token (required), product_ref, product_name, allow_zero_volume. Returns: message, retryable, support_ref
products_funnel_prepareCInspect
Validate a proposed funnel and preview its diff without writing
Inputs: steps, restore_to, product_ref, product_name, +1 more. Returns: message, retryable, support_ref
products_get_actionsCRead-onlyInspect
Read Meta actions for funnel setup
Inputs: limit, cursor. Returns: message, retryable, support_ref
products_get_funnel_candidatesCRead-onlyInspect
List ordered funnel-step candidates with 7-day and 30-day counts
Inputs: limit, cursor, product_ref, product_name, +1 more. Returns: message, retryable, support_ref
products_get_funnel_valuesCRead-onlyInspect
Read per-ad funnel values
Inputs: date_to, date_from, attribution, product_ref, +1 more. Returns: message, retryable, support_ref
products_get_healthBRead-onlyInspect
Read cached product delivery and connection status
Inputs: product_ref (required). Returns: message, retryable, support_ref
products_get_top_campaignsCRead-onlyInspect
Read top campaigns by spend
Inputs: product_ref, product_name. Returns: message, retryable, support_ref
products_listCRead-onlyInspect
List products and funnel/MMP event sources
Inputs: view, limit, cursor, channel_pid. Returns: message, retryable, support_ref
products_save_funnel_eventsCDestructiveInspect
Save the ordered funnel-event choices for one product
Inputs: funnel_events (required), product_name. Returns: message, retryable, support_ref
products_save_timezone_offsetCDestructiveInspect
Save one product's POSIX timezone offset
Inputs: timezone_offset (required), product_name. Returns: message, retryable, support_ref
render_ad_previewsCRead-onlyInspect
Show ads as preview cards
Inputs: items (required), title, currency. Returns: message, retryable, support_ref
render_ads_consoleAd Account ConsoleDRead-onlyInspect
Show an interactive ads console
Inputs: since, until, date_preset, campaign_ids, +2 more. Returns: message, retryable, support_ref
render_performance_reportCRead-onlyInspect
Show fetched performance rows as a report
Inputs: rows (required), title (required), level, notes, +3 more. Returns: message, retryable, support_ref
setup_analyze_productsAInspect
Prepare initial product groups from stored insights when the workspace has none; preserve existing groups. No arguments. May save product setup and returns readiness only. Use setup_get_status for status checks; operator_review_required needs operator diagnosis
Inputs: no named parameters. Returns: message, retryable, support_ref
setup_begin_channel_connectAInspect
Create a private expiring authorization ticket/receipt. User consents in browser at authorize_url; no binding, replacement or ad changes. After user confirmation, setup_check_channel_connect once with connect_id; no auto-poll
Inputs: channel (required). Returns: message, retryable, support_ref
setup_begin_facebook_connectBInspect
Create a Facebook authorization link
Inputs: no named parameters. Returns: message, retryable, support_ref
setup_check_channel_connectARead-onlyInspect
After the user confirms authorization is finished, check once using channel=meta|google_ads|tiktok and the exact connect_id from setup_begin_channel_connect. Do not poll automatically while the link remains valid; use setup_get_status for workspace readiness
Inputs: channel (required), connect_id (required). Returns: message, retryable, support_ref
setup_check_facebook_connectBRead-onlyInspect
Check Facebook auth and first sync
Inputs: connect_id (required). Returns: message, retryable, support_ref
setup_ensure_baseline_templatesCInspect
Run AdsAgent-managed baseline-template preparation
Inputs: no named parameters. Returns: message, retryable, support_ref
setup_get_settingsBRead-onlyInspect
Read background refresh settings with their schema and layout
Inputs: no named parameters. Returns: layout, schema, values, support_ref
setup_get_statusARead-onlyInspect
Read readiness for user-requested ad setup or explicit connection/readiness diagnosis. For unrelated tasks, skip AdsAgent tools. For requests to reveal/export private credentials (passwords, bearer tokens, MFA codes), refuse without tools. Do not run setup to offer alternatives. Connection-health, expiry and reauthorization checks remain supported
Inputs: no named parameters. Returns: message, retryable, support_ref
setup_readiness_checkCRead-onlyInspect
Read minimal launch readiness
Inputs: no named parameters. Returns: message, retryable, support_ref
setup_update_settingsADestructiveInspect
Change background refresh settings; pass only changed values in set
Inputs: set (required). Returns: values, support_ref, result_truncated, tool_call_completed, +1 more
support_get_report_statusCRead-onlyInspect
Read a support report status
Inputs: request (required). Returns: message, retryable, support_ref
support_report_errorAInspect
Save a report for your owned support_ref in the private AdsAgent support queue. Accepts bounded error classifications, no external recipient. Does not retry or change an advertising operation
Inputs: request (required). Returns: message, retryable, support_ref
targeting_searchBRead-onlyInspect
Search Meta targeting IDs by type and keyword
Inputs: query (required), targeting_type (required), limit. Returns: message, retryable, support_ref
tasks_cancelBDestructiveInspect
Cancel a pending tenant-owned task or stop its remaining ordinary Insights recovery while preserving terminal history
Inputs: task_ref. Returns: message, retryable, support_ref
tasks_get_create_detailBRead-onlyInspect
Read your create/copy task's saved ad copy and failures. include_live also reads targeting for that task's ad sets in your authorized Meta accounts; it does not rerun the task or change ads
Inputs: task_ref, copy_offset, include_live, result_cursor, +1 more. Returns: message, retryable, support_ref
tasks_get_statusCRead-onlyInspect
Poll task_ref; never retry unchanged writes Use the workflow's original link_id when exposed.
Inputs: task_ref, response_mode. Returns: message, retryable, support_ref
tasks_latestBRead-onlyInspect
Read latest completed task summary
Inputs: task_type (required). Returns: message, retryable, support_ref
tasks_listCRead-onlyInspect
List recent task summaries
Inputs: days, slim, limit, cursor, +2 more. Returns: message, retryable, support_ref
tasks_list_create_historyCRead-onlyInspect
List recent create/copy history
Inputs: days, limit, cursor, search, +1 more. Returns: message, retryable, support_ref
templates_createCDestructiveInspect
Create a saved launch template
Inputs: request (required). Returns: message, retryable, support_ref
templates_deleteCDestructiveInspect
Delete a template by name or public reference
Inputs: template_name. Returns: message, retryable, support_ref
templates_getBRead-onlyInspect
Read a template by exact name
Inputs: cursor, section, template_name. Returns: message, retryable, support_ref
templates_listDRead-onlyInspect
List saved templates
Inputs: limit, cursor, search, created_after, +3 more. Returns: message, retryable, support_ref
templates_reverse_engineerBRead-onlyInspect
Read one Ad or Ad Set in your authorized Meta accounts and return an unsaved template preview. Does not save templates or change ads
Inputs: ad_account_id (required), adset_id, source_ad_id, source_campaign_id. Returns: message, retryable, support_ref
templates_updateADestructiveInspect
Update an owned saved template immediately using request.template_name and flat update fields. Use new_template_name to rename or creative_distribution to change creative allocation. With no configuration maps, one source_ad_id or source_adset_id imports a fresh snapshot. Read back by exact template_name; this does not update running ads
Inputs: request (required). Returns: message, retryable, support_ref
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Hosted TikTok ads MCP with OAuth, bounded reads, and prepare/confirm writes.
Hosted Google Ads MCP with OAuth, bounded reads, and prepare/confirm writes.
Google Ads MCP with 20,000+ account peer context and staged approve-then-execute writes.
Meta Ads MCP: read ad accounts and signal health; propose governed changes under Ask or Full.
Related MCP Servers
- AlicenseNot gradedqualityAmaintenanceEnables connecting to the Meta Marketing API through a Streamable HTTP MCP endpoint for managing ad accounts, campaigns, ad sets, creatives, audiences, reporting, and batch workflows. Supports multi-tenant OAuth and JWT-protected access for secure workspace-specific Meta Ads operations.39 npmMIT
- AlicenseNot gradedqualityAmaintenanceEnables managing Meta advertising accounts, campaigns, ad sets, creatives, audiences, reporting, and batch workflows through an authenticated MCP endpoint with per-workspace OAuth connections.39 npmMIT
- AlicenseNot gradedqualityAmaintenanceEnables users to connect to the Meta Marketing API to manage ad accounts, campaigns, ad sets, creatives, audiences, reporting, and batch workflows through a secure multi-tenant Streamable HTTP MCP endpoint.39 npmMIT
- AlicenseNot gradedqualityAmaintenanceEnables multi-tenant setup and management of Meta advertising accounts, campaigns, ad sets, creatives, audiences, reporting, and batch workflows through the Meta Marketing API, with OAuth and JWT-protected MCP access.39 npmMIT
Glama MCP Gateway
Add one secure layer between your agents and this server.