MCP

Ads Editor MCP: 212 tools for Claude, ChatGPT, Codex and Cursor

The Ads Editor MCP is a Model Context Protocol server that lets your AI assistant read and run your Meta Ads and Google Ads accounts from a plain-language request. It has 212 tools: 102 read tools and 110 action tools (counted on September 23, 2026, straight from the product code).

  1. 1

    Generate the token

    Go to app.adseditor.com.br/mcp and generate your access token.

  2. 2

    Add it to your client

    Add the MCP connector in Claude, ChatGPT, Codex or Cursor with the address and token shown on that page.

  3. 3

    Ask in plain English

    For example: "pause the ads with a CPA above $40 in the last 7 days" or "how much did I spend on Google Ads this month?".

tools
212
read
102
action
110
groups
25

Tool catalog

Each item is a tool the assistant can call. Read tools only query data; actiontools change something in the account. Access follows each team member's permissions and the accounts included in your plan.

Showing 212 of 212 tools.

Meta Ads

Accounts and metrics

8 tools

Read (8)

Read data. They change nothing in the account.

  • list_meta_accounts

    Lists the Meta (Facebook/Instagram) ad accounts connected to the user.

  • get_meta_connection_status

    Checks whether a valid Meta token is connected for the user (without token details).

  • get_account_dashboard

    Executive dashboard for a Meta ad account with campaigns, budgets, account status and health indicators (billing_error, account_status).

  • get_account_insights

    Account-level Meta insights with metrics aggregated across all campaigns in the period (spend, clicks, impressions, conversions, ROAS and more).

  • get_insights_breakdown

    Meta insights SEGMENTED by breakdown: age, gender, country, region, publisher_platform, platform_position, device_platform, impression_device or hourly stats in the advertiser time zone (up to 2 combined…

  • get_account_summary

    Aggregated summary of a Meta ad account in the period (unique totals: spend, impressions, clicks, conversions).

  • get_account_resources

    Resources available in a Meta ad account for cross-account cloning: Facebook Pages, Instagram accounts, WhatsApp numbers and pixels.

  • get_account_info

    Administrative details of a Meta ad account: name, currency, time zone, linked Business Manager, status and the disable reason when there is one.

Meta Ads

Campaigns

14 tools

Read (6)

Read data. They change nothing in the account.

  • list_campaigns

    Lists the campaigns, ad sets or ads of a Meta ad account.

  • get_campaign_details

    Full details of a Meta campaign: name, objective, status, bid_strategy, budget mode, dates, special_ad_categories.

  • get_campaign_metrics

    Metrics (spend, impressions, clicks, CTR, CPM, CPC, ROAS, conversions) for a campaign, ad set or ad in the period.

  • get_campaigns_budgets

    Fetches daily and lifetime budgets of many campaigns in one batch, including the budgets of their ad sets.

  • list_pixel_custom_events

    Lists the CUSTOM events of a Meta ad account's pixel (for example DEPOSIT_3, SIGNUP) with the recent count of each.

  • get_objective_catalog

    Returns Meta's catalog of valid objective → destination → optimization combinations (with PT/EN labels, the required inputs of each combination and conversion events).

Action (8)

Create, edit, pause or delete something in the ad account or in Ads Editor.

  • pause_campaign

    Pauses a Meta campaign, ad set or ad (works on any object_id).

  • activate_campaign

    Activates a Meta campaign, ad set or ad (works on any object_id).

  • toggle_campaign

    Pauses or activates a Meta campaign specifically (status=ACTIVE|PAUSED).

  • update_campaign

    Renames a Meta campaign. Other fields (objective, bid_strategy) cannot be changed after creation.

  • update_budget

    Updates the daily budget (daily_budget) of a campaign (CBO) or ad set (ABO).

  • delete_campaign

    Permanently deletes a Meta campaign (irreversible: its ad sets and ads are deleted too).

  • create_campaign

    Creates a Meta campaign from scratch, ALWAYS PAUSED.

  • clone_campaign

    Clones a Meta campaign (same account or cross-account) with its ad sets and ads.

Meta Ads

Ad sets

10 tools

Read (4)

Read data. They change nothing in the account.

  • list_adsets

    Lists the ad sets of a Meta ad account with metrics, targeting, budget and bid_strategy.

  • list_adsets_for_campaigns

    Fetches destination_type, optimization_goal and promoted_object of the ad sets of several campaigns (used when cloning to decide Page, pixel and WhatsApp overrides).

  • get_adset_details

    Full details of an ad set: targeting, daily_budget/lifetime_budget, bid_amount, bid_strategy, optimization_goal, destination_type, promoted_object, billing_event.

  • get_adset_insights

    Insights for a specific ad set (spend, impressions, clicks, conversions, ROAS and more) in the period.

Action (6)

Create, edit, pause or delete something in the ad account or in Ads Editor.

  • pause_adset

    Pauses a Meta ad set specifically (status=PAUSED).

  • activate_adset

    Activates a Meta ad set specifically (status=ACTIVE).

  • toggle_adset

    Pauses or activates an ad set (status=ACTIVE|PAUSED).

  • delete_adset

    Permanently deletes an ad set (its ads are deleted too).

  • clone_adset

    Clones an ad set (same account or cross-account), optionally with its ads.

  • update_adset_bidcap

    Updates the bid_amount (in the account currency) and/or bid_strategy of an ad set.

Meta Ads

Ads and media

20 tools

Read (6)

Read data. They change nothing in the account.

  • list_ads

    Lists the ads of a Meta ad account. Shortcut for list_campaigns with level=ads.

  • list_ads_with_insights

    Lists ads with thumbnails and metrics for the period.

  • get_ad_details

    Full details of a Meta ad, including the creative spec (object_story_spec with link_data/video_data), asset_feed_spec, degrees_of_freedom_spec, url_tags and ad set info (destination_type, promoted_object).

  • get_ad_insights

    Insights for a specific ad (spend, impressions, clicks, conversions, ROAS, device breakdown and more) in the period.

  • get_ad_post_links

    Returns the permalinks (public URLs) of the posts behind Meta ads, on Instagram (instagram.com/p/) or Facebook (effective_object_story_id).

  • get_ads_queue_status

    Shows the state of an ad upload queue (the same one the editor uses) by the queue_id returned by create_ads_from_media: how many went live, which failed and why.

Action (14)

Create, edit, pause or delete something in the ad account or in Ads Editor.

  • update_ad

    Edits a Meta ad: name, primary text (message), headline, URL (link), UTMs (url_tags), CTA, WhatsApp messages and Advantage+ flags. Changes to text, headline, URL or UTMs create a new creative.

  • disable_account_enhancements

    Turns off, in BULK, every automatic creative recommendation and enhancement on the ads of an account.

  • pause_ad

    Pauses a Meta ad specifically (status=PAUSED).

  • activate_ad

    Activates a Meta ad specifically (status=ACTIVE).

  • toggle_ad

    Pauses or activates a Meta ad (status=ACTIVE|PAUSED).

  • delete_ad

    Permanently deletes a Meta ad. Irreversible.

  • clone_ad

    Clones a Meta ad to another ad set (same account or cross-account).

  • bulk_pause_ads

    Pauses up to 50 Meta ads in bulk. Checks ownership of each ad before pausing.

  • bulk_activate_ads

    Activates up to 50 Meta ads in bulk. Checks ownership of each ad before activating.

  • create_ad_from_instagram_link

    Creates a Meta ad from a public Instagram URL (post, reel, tv or stories).

  • upload_media

    Uploads a media file (image or video) to a Meta ad account.

  • upload_ad_media

    Puts ONE media file into Ads Editor so it can become an ad later with create_ads_from_media.

  • create_ads_from_media

    Creates ads from media files through the SAME queue the editor uses: one ad per file in each ad set, with sequential names (AD01, AD02...) and text, Page, Instagram and UTM inherited from the ad set when…

  • update_ad_creative

    Updates the creative of a Meta ad with a new video (video_id) or image (image_hash).

Meta Ads

Batch editing

3 tools

Read (1)

Read data. They change nothing in the account.

  • get_batch_job_status

    Status of an async batch job. Returns processing/done/partial/error with progress (done/ok/failed/total) and results.

Action (2)

Create, edit, pause or delete something in the ad account or in Ads Editor.

  • batch_update_objects

    Updates many Meta objects (campaigns, ad sets, ads) in parallel, synchronously.

  • batch_update_async

    Asynchronous version of batch_update_objects for large batches (over 50).

Meta Ads

Audiences

10 tools

Read (5)

Read data. They change nothing in the account.

  • list_audiences

    Lists the custom audiences of a Meta ad account, used as sources for lookalikes, retargeting and more.

  • get_audience_size

    Returns the approximate size of a Meta audience (lower/upper bound) plus operation and delivery status.

  • get_audience_debug

    Full diagnosis of an audience: subtype, rule, rule_v2, retention_days, customer_file_source, lookalike_spec, operation_status, delivery_status, timestamps.

  • get_audience_job

    Status of a background audience creation job.

  • list_audience_campaigns

    Lists the campaigns of a Meta ad account (id, name, objective), used as filters for campaign event audiences.

Action (5)

Create, edit, pause or delete something in the ad account or in Ads Editor.

  • create_audience

    Creates a Meta custom audience.

  • create_audiences_bulk

    Creates many audiences in bulk (background job).

  • create_engagement_audience

    Creates an Instagram or Facebook ENGAGEMENT audience and builds the correct Meta rule automatically (resolves the Instagram account or Page of the ad account).

  • clone_audience

    Clones an existing Meta custom audience (same account or cross-account).

  • delete_audience

    Deletes a Meta custom audience. Checks ownership: the audience must be in an account the user's Meta token can access.

Meta Ads

Pages, Instagram and pixel

7 tools

Read (7)

Read data. They change nothing in the account.

  • list_fb_pages

    Lists the user's Facebook Pages (from several sources: me/accounts, promote_pages, Business Manager).

  • lookup_instagram_user

    Searches Instagram accounts by username (or returns the user's own when there is no query).

  • list_page_videos

    Lists videos published by a Facebook Page (used as sources for video view audiences).

  • list_ig_videos

    Lists the videos (Reels, IGTV, video posts) of an Instagram account for video view audiences.

  • list_campaign_videos

    Lists videos already used in the campaigns of a Meta ad account (with video_id and thumbnail).

  • get_ig_followers

    Returns the follower count of the Instagram accounts linked to one or more Meta ad accounts.

  • list_pixel_events

    Lists the conversion events (ViewContent, AddToCart, Purchase, Lead and more) tracked by a Meta pixel, used to build website event audiences.

Meta Ads

Lead forms

5 tools

Read (2)

Read data. They change nothing in the account.

  • list_lead_forms

    Lists the Page's instant forms (lead ads).

  • list_ads_using_lead_forms

    Lists the ads of a Meta ad account that use an instant form (lead ad) and which form each one uses.

Action (3)

Create, edit, pause or delete something in the ad account or in Ads Editor.

  • set_ad_lead_form

    Swaps the instant form (lead ad) of an ad.

  • duplicate_lead_form

    Duplicates one of the Page's instant forms, copying questions, privacy policy, thank-you screen and context card.

  • create_lead_form

    Creates a simple instant form on the Page: name, privacy policy and destination website (both https and REQUIRED by Meta) and the standard full name, email and phone questions.

Meta Ads

Locations

3 tools

Read (2)

Read data. They change nothing in the account.

  • search_meta_locations

    Searches Meta locations (city, region/state, country, ZIP code, groups such as worldwide or continents) by name.

  • get_adsets_locations

    Reads the CURRENT locations (include/exclude) of each Meta ad set given, one line per ad set.

Action (1)

Create, edit, pause or delete something in the ad account or in Ads Editor.

  • update_adsets_locations

    Edits the LOCATION of several Meta ad sets at once, keeping the rest of each one's targeting (age, gender, audiences, placements). mode="add" ADDS to the locations each ad set already has…

Meta Ads

Devices

2 tools

Read (1)

Read data. They change nothing in the account.

  • list_meta_device_models

    Lists the device models Meta accepts for targeting (user_device), filtered by operating system and name search.

Action (1)

Create, edit, pause or delete something in the ad account or in Ads Editor.

  • update_adsets_device_targeting

    Sets mobile device and operating system targeting on Meta ad sets (user_os / user_device / OS version / Wi-Fi only).

Google Ads

Accounts

6 tools

Read (5)

Read data. They change nothing in the account.

  • list_google_accounts

    Lists connected Google Ads accounts (direct, managed by an MCC and MCC clients).

  • get_google_connection_status

    Checks whether a valid Google Ads token is connected (without token details).

  • get_google_saved_selection

    Returns the Google Ads accounts the user selected before (saved in the profile).

  • get_google_account_optimization

    Returns the optimization_score (0 to 100) and impact estimates for a Google Ads account.

  • list_google_recommendations

    Lists Google Ads optimization recommendations (keywords, bid adjustments, text ads and more).

Action (1)

Create, edit, pause or delete something in the ad account or in Ads Editor.

  • save_google_accounts_selection

    Saves the user's Google Ads account selection (customer_ids) in the profile.

Google Ads

Campaigns and Performance Max

23 tools

Read (9)

Read data. They change nothing in the account.

  • list_google_campaigns

    Lists the Google Ads campaigns of an account with status, bidding_strategy_type, optimization_score, budget and performance metrics.

  • get_google_campaign_metrics

    Returns only the metrics (spend, impressions, clicks, CTR, conversions, ROAS) of Google Ads campaigns in the period.

  • get_google_campaign_details

    Full details of a specific Google Ads campaign.

  • get_google_url_options

    Reads the URL options of a Google Ads campaign: tracking template (tracking_url_template), final URL suffix (final_url_suffix, where the UTMs live) and custom parameters.

  • get_google_campaign_locations

    Lists the current geo targeting of a Google Ads campaign: locations (city, region, country, with resolved names) and radius targeting around addresses (proximity).

  • list_google_asset_groups

    Lists the asset groups (Performance Max) of a Google Ads campaign with metrics.

  • list_google_image_assets

    Lists the images already uploaded to the Google Ads account (asset library), with id, dimensions, format and possible Performance Max uses (marketing 1.91:1, square 1:1, logo, portrait).

  • get_google_asset_group

    Reads an asset group of a Performance Max campaign: name, status, final URL and every asset by type (headlines, long headlines, descriptions, business name, images, logos, videos), each asset…

  • get_google_account_timeseries

    Aggregated daily series of a Google Ads account (spend, impressions, clicks, conversions per day).

Action (14)

Create, edit, pause or delete something in the ad account or in Ads Editor.

  • pause_google_campaign

    Pauses a Google Ads campaign (PAUSED).

  • activate_google_campaign

    Activates a Google Ads campaign (ENABLED).

  • update_google_campaign_status

    Changes the status of a Google Ads campaign (ENABLED, PAUSED or REMOVED).

  • update_google_budget

    Updates the budget of a Google Ads campaign.

  • duplicate_google_campaign

    Duplicates a Google Ads campaign in the SAME account, copying by default its ad groups, ads (responsive search ads), keywords and targeting (location and language).

  • set_google_url_options

    Sets the UTMs of a Google Ads campaign through the FINAL URL SUFFIX (final_url_suffix), the right place: it applies to every ad in the campaign and does not break when an ad URL changes.

  • rename_google_campaign

    Renames a Google Ads campaign (only the name changes; status, budget and targeting do not).

  • update_google_campaign_locations

    Changes the geo targeting of a Google Ads campaign.

  • create_google_pmax_campaign

    Creates a PERFORMANCE MAX campaign from scratch in Google Ads (budget + campaign + asset group with headlines, long headlines, descriptions, business name, images and logo + search themes + location), in a…

  • upload_google_image_asset

    Uploads a PNG or JPEG image (base64, up to 5 MB) to the Google Ads account library and returns the asset_id for Performance Max.

  • update_google_asset_group

    Edits the asset group of a Performance Max campaign: adds headlines, long headlines, descriptions, business name, images (by asset_id), videos and search themes; removes assets by the link that…

  • update_google_bidding

    Changes the bid strategy of a Google Ads campaign (MANUAL_CPC, ENHANCED_CPC, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE) with optional parameters.

  • create_google_campaign

    Creates a Search campaign from scratch in Google Ads (budget + campaign + ad group + keywords + RSA + optional extensions).

  • clone_google_campaign_to_account

    Clones a Google Ads campaign to ANOTHER ad account.

Google Ads

Ad groups and ads

16 tools

Read (5)

Read data. They change nothing in the account.

  • list_google_adgroups

    Lists the ad groups of a Google Ads campaign with bid, status and metrics.

  • list_all_google_adgroups

    Lists ALL ad groups of a Google Ads account (no campaign filter), with metrics for the period.

  • list_google_ads

    Lists the ads of a Google Ads ad group (headlines, descriptions, URLs, metrics).

  • list_all_google_ads

    Lists ALL ads of a Google Ads account, with metrics for the period.

  • get_google_ad_details

    Full details of a Google Ads ad: headlines (pinned), descriptions, display_url, final_url, tracking_template, custom_parameters, ad_strength.

Action (11)

Create, edit, pause or delete something in the ad account or in Ads Editor.

  • create_google_ad_group

    Creates a new ad GROUP under an existing Search campaign, with keywords and, optionally, the first responsive ad.

  • create_google_ad

    Creates a new responsive search ad (RSA) under an existing ad group.

  • rename_google_adgroup

    Renames a Google Ads ad group.

  • set_google_adgroup_target_cpa

    Sets the target CPA of an ad GROUP (in the account currency).

  • update_google_adgroup_status

    Changes the status of a Google Ads ad group (ENABLED, PAUSED, REMOVED).

  • pause_google_adgroup

    Pauses a Google Ads ad group.

  • activate_google_adgroup

    Activates a Google Ads ad group.

  • duplicate_google_adgroup

    Clones a Google Ads ad group (with ads and keywords) to another campaign.

  • update_google_ad_status

    Changes the status of a Google Ads ad (ENABLED, PAUSED, REMOVED).

  • update_google_ad

    Edits a Google responsive search ad (headlines, descriptions, final_url, tracking_template).

  • duplicate_google_ad

    Copies a Google Ads responsive search ad (RSA) to the SAME ad group or to another ad group in the same account.

Google Ads

Keywords and search terms

9 tools

Read (4)

Read data. They change nothing in the account.

  • list_google_keywords

    Lists the keywords of a Google Ads ad group with match_type, bid, status, quality_score and metrics.

  • get_google_keyword_ideas

    Google Keyword Planner: suggestions with the account's REAL search volume and CPC, from a website and/or seed keywords.

  • list_google_keyword_search_terms

    Real search terms that ONE specific keyword triggered, with metrics.

  • list_google_search_terms

    Google Ads search terms report: real queries that triggered ads, with status (ADDED, EXCLUDED, NONE) and metrics.

Action (5)

Create, edit, pause or delete something in the ad account or in Ads Editor.

  • add_google_keyword

    Adds a keyword to a Google Ads ad group with a match_type (BROAD, PHRASE, EXACT) and an optional bid.

  • update_google_keyword

    Pauses, re-enables or changes the bid of a Google Ads keyword.

  • remove_google_keyword

    Removes a Google Ads keyword from an ad group.

  • add_google_negative_keyword

    Adds a Google Ads negative keyword at campaign level (campaign_id) or ad group level (ad_group_id).

  • change_google_keyword_match_type

    Changes the match type of a keyword (BROAD, PHRASE, EXACT).

Google Ads

Extensions (assets)

7 tools

Read (2)

Read data. They change nothing in the account.

  • list_google_extensions

    Lists the Google Ads extensions (sitelinks, callouts and structured snippets) of an account or of a specific campaign (campaign_id).

  • list_google_account_assets

    Scans the account's extensions at all three levels (account, campaign and ad group) and returns them deduplicated.

Action (5)

Create, edit, pause or delete something in the ad account or in Ads Editor.

  • create_google_sitelinks

    Creates Google Ads sitelinks and links them to a campaign.

  • create_google_callouts

    Creates Google Ads callouts (up to 25 characters each) and links them to a campaign.

  • create_google_snippets

    Creates a Google Ads structured snippet and links it to a campaign: a header (for example Services, Brands, Courses, Destinations) and a list of values (up to 25 characters each).

  • update_google_extension

    Edits a Google Ads extension (sitelink, callout or structured snippet).

  • remove_google_extension

    Unlinks a Google Ads extension from the level where it is attached (account or campaign).

Google Ads

Conversions

5 tools

Read (2)

Read data. They change nothing in the account.

  • list_google_conversion_actions

    Lists the active conversion actions of a Google Ads account: id, name, category, type and whether it is primary.

  • get_campaign_conversion_goal

    Shows the conversion goals of a Google Ads campaign: whether it uses the ACCOUNT goals (mode=account) or conversions SPECIFIC to this campaign (mode=specific), and which ones (selected_action_ids).

Action (3)

Create, edit, pause or delete something in the ad account or in Ads Editor.

  • create_google_conversion_action

    Creates a conversion action (webpage type) in the Google Ads account and returns the TAG (global site tag + event snippet) for the user to install on the site. category must be one of: SUBMIT_LEAD_FORM, CONTACT, PURCHASE…

  • remove_google_conversion_action

    Removes (archives) a conversion action from the Google Ads account.

  • set_campaign_conversion_goal

    Sets the conversion goals of a Google Ads campaign. mode="account" makes the campaign inherit the account goals; mode="specific" makes it optimize only for the chosen conversions (conversion_action_ids…

Google Ads

Demographics

2 tools

Read (1)

Read data. They change nothing in the account.

  • list_google_demographics

    Lists the demographics of a Google Ads Search ad group: gender, age range, household income and parental status, with the state of each value (default, adjusted by +/- %, excluded) and the metrics for the period…

Action (1)

Create, edit, pause or delete something in the ad account or in Ads Editor.

  • update_google_demographic

    Changes ONE demographic value of a Search ad group. action: "exclude" (the ad group stops showing to that audience), "adjust" (bid adjustment in %, from -90 to +900, for example adjustment_pct 20 =…

Google Ads

AI optimization

11 tools

Read (3)

Read data. They change nothing in the account.

  • list_google_optimizations

    Lists the user's GOOGLE ADS AI Optimizations (google_ads_scales engine): suggest/auto mode, autonomy flags (add negatives, pause keywords, budget, reallocation), caps, seasonality and the last_analysis of…

  • list_google_optimization_suggestions

    Lists the PENDING suggestions of the Google Optimization engine (negative terms, keyword pauses, budget, caps, PMax, extensions…) with title, explanation and numeric evidence.

  • get_google_optimization_history

    History of ACTIONS of a Google Optimization (automatic and approved): what changed, from what to what (budgets in the account currency), the reason and the evidence, ready to display, with chips and groups…

Action (8)

Create, edit, pause or delete something in the ad account or in Ads Editor.

  • approve_google_suggestion

    APPROVES a pending Google Optimization suggestion: runs the change in Google Ads (through the same write path as the engine, with validate_only first) and records the decision as training. note (optional) becomes a comment for…

  • dismiss_google_suggestion

    DECLINES a pending Google Optimization suggestion without touching the account.

  • toggle_google_optimization

    Turns a Google Optimization on or off (pauses or resumes the engine on that account).

  • delete_google_optimization

    Deletes a Google AI Optimization. Its suggestions and history go with it. Requires a Google AI Optimization already active on the account.

  • duplicate_google_optimization

    Duplicates the settings of a Google AI Optimization to another account or campaign.

  • set_google_optimization_note

    Saves the GENERAL training note of the optimization, what the engine must always take into account.

  • undo_google_optimization_action

    Undoes ONE action the Google engine already ran (restores the previous value in Google Ads).

  • rate_google_optimization_action

    Marks an action in the engine history as right or wrong.

Platform

AI budget scaling

10 tools

Read (6)

Read data. They change nothing in the account.

  • list_optimizations

    Lists every AI optimization (budget scale) the user set up, without calling the Meta API (fast).

  • get_optimizations_dashboard

    Aggregated executive dashboard of all scales: summary (spend/results/MER/ROAS/CPA), top and bottom performers and states (healthy/risk/critical).

  • get_optimizations_health_summary

    Health summary of all scales: counts (healthy/risk/critical), average score and categories.

  • get_optimization_details

    Details of a specific scale (looked up through the list and filtered by id).

  • get_optimization_spend

    Spend and results metrics of a scale (week_spent, month_spent, results_by_campaign).

  • get_optimization_history

    Run history of a scale: actions taken, metrics, healthScore, budget adjustments.

Action (4)

Create, edit, pause or delete something in the ad account or in Ads Editor.

  • create_optimization

    Creates an AI optimization (budget scale).

  • update_optimization

    Updates an existing scale. Accepts a subset of the create_optimization fields plus bid_cap.

  • delete_optimization

    Permanently deletes a budget scale.

  • toggle_optimization

    Turns a budget scale on or off (toggles is_active).

Platform

Automated rules

8 tools

Read (4)

Read data. They change nothing in the account.

  • list_rules

    Lists the automated rules the user set up (all accounts, with an optional ad_account_id filter).

  • get_rule_details

    Full details of an automated rule (conditions, actions, schedule, calculation_period).

  • get_rule_history

    Run history of a rule: action taken, affected entities, success or error, timestamp.

  • list_recent_rule_executions

    Recent runs of all the user's rules (overall timeline).

Action (4)

Create, edit, pause or delete something in the ad account or in Ads Editor.

  • create_rule

    Creates an automated rule. Two formats: (1) CONDITION + action, with metric/operator/threshold; (2) pure SCHEDULE, schedule_type "specific_date" with schedule_date and schedule_time and NO metric: fires the action at the time…

  • update_rule

    Updates an existing automated rule.

  • delete_rule

    Permanently deletes an automated rule.

  • toggle_rule

    Turns an automated rule on or off (toggles is_active).

Platform

Alerts and notifications

10 tools

Read (4)

Read data. They change nothing in the account.

  • list_alerts

    Lists every alert the user set up (metric + threshold + status).

  • check_alerts

    Triggers a manual alert check (rate limited on the backend).

  • list_notifications

    Lists the user's in-app notifications (read and unread).

  • get_unread_notifications_count

    Returns the number of unread notifications.

Action (6)

Create, edit, pause or delete something in the ad account or in Ads Editor.

  • create_alert

    Creates an alert with a metric (cpa, cpc, cpm, ctr, spend, roas), an operator (gt, lt, eq) and a threshold.

  • update_alert

    Updates an existing alert. campaign_objectives = [] clears the objective filter (back to all campaigns).

  • delete_alert

    Permanently deletes an alert.

  • mark_notification_read

    Marks a notification as read.

  • mark_all_notifications_read

    Marks every notification as read.

  • delete_notification

    Permanently deletes a notification.

Platform

Reports

12 tools

Read (9)

Read data. They change nothing in the account.

  • list_reports

    Lists every report created by the authenticated user (ID, title, slug, linked accounts, Instagram, Google).

  • get_report

    Retrieves a report by its ID (UUID) or public slug.

  • get_report_access_logs

    Access logs of a report (authenticated): IPs, user agents, durations, referrers.

  • get_public_report

    Basic data of a public report (by slug).

  • get_public_report_metrics

    Meta Ads metrics of a public report (campaigns, spend, conversions, ROAS).

  • get_public_report_creatives

    Creatives (with thumbnails and metrics) of a public Meta report.

  • get_public_report_instagram_insights

    Instagram account insights of a public report (followers, engagement, top posts).

  • get_public_report_google_metrics

    Google Ads metrics of a public report.

  • get_public_report_google_advanced

    Advanced Google report of a public report (ad groups, cities, videos).

Action (3)

Create, edit, pause or delete something in the ad account or in Ads Editor.

  • create_report

    Creates a new report linked to one or more Meta ad accounts, with predefined sections and a period.

  • update_report

    Updates fields of an existing report (title, config, is_public, linked accounts).

  • delete_report

    Permanently deletes a report.

Platform

Balance monitor and Accounts Hub

7 tools

Read (3)

Read data. They change nothing in the account.

  • get_account_balance_status

    Returns the balance health of all the user's Meta and Google accounts: balance, days_remaining, today_spend, spend_cap, status and accounts on alert.

  • list_monitor_blacklist

    Lists the accounts hidden from the Monitor (blacklist) with date and optional reason.

  • list_hidden_accounts_central

    Lists the accounts the user hid in the Accounts Hub.

Action (4)

Create, edit, pause or delete something in the ad account or in Ads Editor.

  • hide_account_in_monitor

    Hides an account (Meta or Google) from the balance Monitor dashboard.

  • unhide_account_in_monitor

    Shows an account that was hidden from the balance Monitor again.

  • hide_account_in_central

    Hides an account (Meta or Google) from the user's Accounts Hub.

  • unhide_account_in_central

    Shows an account that was hidden in the Accounts Hub again.

Platform

Sales and UTMs

2 tools

Read (2)

Read data. They change nothing in the account.

  • get_sales_summary

    Summary of sales received from supported checkout platforms, grouped by Meta campaign, ad set and ad, in the period.

  • list_integrations_utms

    Lists the configured UTM integrations (checkout platform projects and their linked ad accounts).

Platform

Internal team use

2 tools

Read (1)

Read data. They change nothing in the account.

  • get_platform_client_context

    Support lookup restricted to Ads Editor administrators. Not visible to customers.

Action (1)

Create, edit, pause or delete something in the ad account or in Ads Editor.

  • relatar_bug_whatsapp

    Bug report logged by the support team, restricted to Ads Editor administrators. Not visible to customers.

Frequently asked questions

Is the Ads Editor MCP an official Meta product?

No. Ads Editor is an independent platform and the MCP server belongs to it, not to Meta or Google. It talks to both platforms through their official APIs, with the authorization (OAuth) you grant when you connect your accounts.

Does it work in ChatGPT?

Yes. It works in any client that accepts an MCP connector: ChatGPT, Claude, Codex and Cursor, among others. You add the connector with the address and token generated in Ads Editor and start asking in plain English.

Is the MCP read-only?

No. Of the 212 tools, 102 are read tools (they query metrics, campaigns and audiences) and 110 are action tools: they pause, activate, create, edit budgets and clone. Campaigns created through the MCP start paused, and there is a safety cap on daily budgets.

Where can I see what the AI did in my account?

In the history on the MCP page inside Ads Editor (Recent activity), with every tool that was called. The changes also show up in the change history of Meta and Google Ads themselves.

Further reading

Try the MCP on your own accounts

7-day free trial. Plans start at R$ 97 per month, billed in BRL; the pricing page shows which plans include the MCP.

Start free trial