Skip to main content
Glama

AdsAgent — Meta Ads MCP

Server Details

Hosted Meta ads MCP with OAuth, bounded reads, and prepare/confirm writes.

Ownership verified
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

C2.6/5.0

Scored across 172 tools

Disambiguation2/5

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.

Naming Consistency3/5

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_*.

Tool Count1/5

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.

Completeness4/5

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 tools
account_get_profileA
Read-only
Inspect

Login identity only. For channel setup: setup_get_status

Inputs: no named parameters. Returns: id, name, email, nickname, +1 more

account_media_getA
Read-only
Inspect

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_batchA
Read-only
Inspect

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_listB
Read-only
Inspect

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_ownerC
Read-only
Inspect

Find account owner and token provenance

Inputs: ad_account_id (required), operation. Returns: message, retryable, support_ref

accounts_get_account_detailA
Read-only
Inspect

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_pagesA
Read-only
Inspect

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_accountsD
Read-only
Inspect

List IG IDs

Inputs: page_id (required), ad_account_id (required), limit, cursor. Returns: message, retryable, support_ref

accounts_list_linked_accountsA
Read-only
Inspect

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_copyB
Read-only
Inspect

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_confirmB
DestructiveIdempotent
Inspect

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_denyB
Destructive
Inspect

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_confirmB
DestructiveIdempotent
Inspect

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_denyC
Destructive
Inspect

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_confirmB
DestructiveIdempotent
Inspect

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_denyB
Destructive
Inspect

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_accountsC
Read-only
Inspect

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_pickC
Read-only
Inspect

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_mentionsB
Read-only
Inspect

Search the caller's ad accounts, products and campaigns for composer @-mentions

Inputs: query. Returns: items, support_ref

assets_update_account_permissionsC
Destructive
Inspect

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_usageC
Read-only
Inspect

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_reviseC
Destructive
Inspect

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_planC
Read-only
Inspect

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_intentA
Read-only
Inspect

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_guideB
Read-only
Inspect

Facebook link and steps for the user to remove AdsAgent's access

Inputs: no named parameters. Returns: message, retryable, support_ref

connections_listC
Read-only
Inspect

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_evidenceC
Read-only
Inspect

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_overviewC
Read-only
Inspect

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_uploadB
Destructive
Inspect

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_statusA
Read-only
Inspect

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_uploadC
Idempotent
Inspect

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_deleteB
Destructive
Inspect

Delete one owned creative by selection key or creative reference

Inputs: selection_key. Returns: message, retryable, support_ref

creatives_getA
Read-only
Inspect

Get one owned creative by selection_key: details plus signed download and thumbnail links

Inputs: selection_key. Returns: message, retryable, support_ref

creatives_get_batchB
Read-only
Inspect

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_listC
Read-only
Inspect

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_cloudA
Read-only
Inspect

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_foldersB
Read-only
Inspect

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_pickC
Read-only
Inspect

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_topC
Read-only
Inspect

Rank reusable media by cached ad performance

Inputs: limit, metric, window, min_spend, +4 more. Returns: message, retryable, support_ref

entities_lookup_by_nameA
Read-only
Inspect

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_listA
Read-only
Inspect

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_labelC
Destructive
Inspect

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_permissionsC
Destructive
Inspect

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_rangeB
Read-only
Inspect

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_overviewB
Read-only
Inspect

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_overviewA
Read-only
Inspect

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_archiveB
Destructive
Inspect

Archive one saved audience pack by its exact public name

Inputs: interest_pack_name. Returns: message, retryable, support_ref

interests_fetch_from_adsetB
Read-only
Inspect

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_getA
Read-only
Inspect

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_listC
Read-only
Inspect

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_use_targetsA
Destructive
Inspect

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_confirmB
DestructiveIdempotent
Inspect

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_denyA
Destructive
Inspect

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_stateB
Read-only
Inspect

Read MMP mapping, cohort, and funnel state

Inputs: no named parameters. Returns: message, retryable, support_ref

mmp_insights_get_product_event_todayC
Read-only
Inspect

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_todayC
Read-only
Inspect

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_cohortC
Read-only
Inspect

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_summaryC
Read-only
Inspect

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_ackC
Destructive
Inspect

Acknowledge one TaskTools notification

Inputs: notification_id (required). Returns: message, retryable, support_ref

notifications_listC
Read-only
Inspect

List TaskTools notifications

Inputs: limit, cursor, status, severity. Returns: message, retryable, support_ref

notifications_resolveC
Destructive
Inspect

Resolve one TaskTools notification

Inputs: notification_id (required). Returns: message, retryable, support_ref

notifications_scanC
Destructive
Inspect

Refresh alerts; may notify configured channels

Inputs: no named parameters. Returns: message, retryable, support_ref

notifications_summaryA
Read-only
Inspect

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 ConsoleC
Read-only
Inspect

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_copyB
DestructiveIdempotent
Inspect

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_updateA
DestructiveIdempotent
Inspect

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_replaceB
DestructiveIdempotent
Inspect

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_copyB
DestructiveIdempotent
Inspect

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_replaceB
DestructiveIdempotent
Inspect

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_bidA
DestructiveIdempotent
Inspect

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_budgetA
DestructiveIdempotent
Inspect

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_statusA
DestructiveIdempotent
Inspect

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_statusB
DestructiveIdempotent
Inspect

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_statusesA
DestructiveIdempotent
Inspect

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_updateA
DestructiveIdempotent
Inspect

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_budgetA
DestructiveIdempotent
Inspect

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_budgetsA
DestructiveIdempotent
Inspect

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_createB
DestructiveIdempotent
Inspect

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_recreateB
DestructiveIdempotent
Inspect

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_statusB
DestructiveIdempotent
Inspect

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_updateA
DestructiveIdempotent
Inspect

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_pauseA
DestructiveIdempotent
Inspect

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_cloneB
DestructiveIdempotent
Inspect

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_approvalA
Destructive
Inspect

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_getB
Read-only
Inspect

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_approvalA
Read-only
Inspect

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_contextD
Read-only
Inspect

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_confirmA
DestructiveIdempotent
Inspect

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_denyA
Destructive
Inspect

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_confirmA
DestructiveIdempotent
Inspect

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_denyA
Destructive
Inspect

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_confirmB
DestructiveIdempotent
Inspect

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_actionsC
Read-only
Inspect

Read Meta actions for funnel setup

Inputs: limit, cursor. Returns: message, retryable, support_ref

products_get_funnel_candidatesC
Read-only
Inspect

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_valuesC
Read-only
Inspect

Read per-ad funnel values

Inputs: date_to, date_from, attribution, product_ref, +1 more. Returns: message, retryable, support_ref

products_get_healthB
Read-only
Inspect

Read cached product delivery and connection status

Inputs: product_ref (required). Returns: message, retryable, support_ref

products_get_top_campaignsC
Read-only
Inspect

Read top campaigns by spend

Inputs: product_ref, product_name. Returns: message, retryable, support_ref

products_listC
Read-only
Inspect

List products and funnel/MMP event sources

Inputs: view, limit, cursor, channel_pid. Returns: message, retryable, support_ref

products_save_funnel_eventsC
Destructive
Inspect

Save the ordered funnel-event choices for one product

Inputs: funnel_events (required), product_name. Returns: message, retryable, support_ref

products_save_timezone_offsetC
Destructive
Inspect

Save one product's POSIX timezone offset

Inputs: timezone_offset (required), product_name. Returns: message, retryable, support_ref

render_ad_previewsC
Read-only
Inspect

Show ads as preview cards

Inputs: items (required), title, currency. Returns: message, retryable, support_ref

render_ads_consoleAd Account ConsoleD
Read-only
Inspect

Show an interactive ads console

Inputs: since, until, date_preset, campaign_ids, +2 more. Returns: message, retryable, support_ref

render_performance_reportC
Read-only
Inspect

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_connectA
Read-only
Inspect

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_connectB
Read-only
Inspect

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_settingsB
Read-only
Inspect

Read background refresh settings with their schema and layout

Inputs: no named parameters. Returns: layout, schema, values, support_ref

setup_get_statusA
Read-only
Inspect

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_checkC
Read-only
Inspect

Read minimal launch readiness

Inputs: no named parameters. Returns: message, retryable, support_ref

setup_update_settingsA
Destructive
Inspect

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_statusC
Read-only
Inspect

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

tasks_cancelB
Destructive
Inspect

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_detailB
Read-only
Inspect

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_statusC
Read-only
Inspect

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_latestB
Read-only
Inspect

Read latest completed task summary

Inputs: task_type (required). Returns: message, retryable, support_ref

tasks_listC
Read-only
Inspect

List recent task summaries

Inputs: days, slim, limit, cursor, +2 more. Returns: message, retryable, support_ref

tasks_list_create_historyC
Read-only
Inspect

List recent create/copy history

Inputs: days, limit, cursor, search, +1 more. Returns: message, retryable, support_ref

templates_createC
Destructive
Inspect

Create a saved launch template

Inputs: request (required). Returns: message, retryable, support_ref

templates_deleteC
Destructive
Inspect

Delete a template by name or public reference

Inputs: template_name. Returns: message, retryable, support_ref

templates_getB
Read-only
Inspect

Read a template by exact name

Inputs: cursor, section, template_name. Returns: message, retryable, support_ref

templates_listD
Read-only
Inspect

List saved templates

Inputs: limit, cursor, search, created_after, +3 more. Returns: message, retryable, support_ref

templates_reverse_engineerB
Read-only
Inspect

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_updateA
Destructive
Inspect

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

    Related MCP Servers

    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables 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 npm
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables managing Meta advertising accounts, campaigns, ad sets, creatives, audiences, reporting, and batch workflows through an authenticated MCP endpoint with per-workspace OAuth connections.
      39 npm
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables 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 npm
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables 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 npm
      MIT
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.

    Resources