Microsoft Ads MCP server for your AI

Pull last week's spend and conversions by campaign, pause the keywords wasting budget, add negatives from search terms, and research new keywords with Bing search volumes, across every ad account one sign-in reaches.

PopMCPMicrosoft Ads

Which campaigns spent the most last week, and how many conversions did each one get?

Contact sales Connect

Supported Microsoft Ads tools

All six Microsoft Advertising services in one connection, from Campaign Management and Reporting to Ad Insight, Bulk, Customer Management and Billing, plus the account changes PopMCP can watch.

284 tools in the full catalog: 155 read and 129 write. 39 load by default, and the rest are found with tool search.

microsoft_ads_get_keyword_traffic_estimates

Provides traffic estimates for keywords e.g., average CPC, average position, clicks, CTR, impressions, and total cost.

microsoft_ads_get_recommendations

Discover your recommendations.

microsoft_ads_keyword_ideas

Keyword ideas with monthly searches, competition and bids.

microsoft_ads_get_account

Gets the details of an account.

microsoft_ads_get_user

Gets the details of an user.

microsoft_ads_search_accounts

Searches for accounts that match the request criteria.

microsoft_ads_get_conversion_goals_by_ids

Gets the specified conversion goals.

microsoft_ads_get_uet_tags_by_ids

Gets the specified Universal Event Tracking (UET) tags.

microsoft_ads_get_budgets_by_ids

Gets the specified budgets from the account's shared budget library.

microsoft_ads_update_budgets

Updates the specified budgets in the account's shared budget library.

microsoft_ads_get_account_monthly_spend

Gets the amount spent by the account in the specified month.

microsoft_ads_account_overview

Account details, campaign counts and last week's totals in one call.

microsoft_ads_add_campaigns

Adds one or more campaigns to the specified account.

microsoft_ads_delete_campaigns

Deletes one or more campaigns in a specified account.

microsoft_ads_get_campaigns_by_ids

Gets the specified campaigns within an account.

microsoft_ads_list_campaigns

Every campaign of every type, compact.

microsoft_ads_set_status

Pause or enable campaigns, ad groups or keywords.

microsoft_ads_update_campaigns

Updates specified campaigns in a specified account.

microsoft_ads_add_keywords

Adds one or more keywords to an ad group.

microsoft_ads_add_negative_keywords_to_entities

Adds negative keywords to the specified campaign or ad group.

microsoft_ads_delete_keywords

Deletes one or more keywords in a specified ad group.

microsoft_ads_get_keywords_by_ad_group_id

Gets the keywords within an ad group.

microsoft_ads_get_negative_keywords_by_entity_ids

Gets the negative keywords that are assigned directly to campaigns or ad groups.

microsoft_ads_update_keywords

Updates the keywords within a specified ad group.

microsoft_ads_get_ad_extension_ids_by_account_id

Gets the ad extensions from the account's ad extension library.

microsoft_ads_add_ads

Adds one or more ads to an ad group.

microsoft_ads_get_ads_by_ad_group_id

Retrieves the ads within an ad group.

microsoft_ads_get_labels_by_ids

Gets labels by label identifiers.

microsoft_ads_update_ads

Updates the specified ads within an ad group.

microsoft_ads_add_ad_groups

Adds new ad groups to a specified campaign.

microsoft_ads_download_campaigns_by_account_ids

Downloads settings and performance data for all of the account's campaigns.

microsoft_ads_get_ad_groups_by_campaign_id

Gets the ad groups within the specified campaign.

microsoft_ads_get_bulk_download_status

Gets the status of a bulk download request.

microsoft_ads_get_report

Rows of a report submitted earlier.

microsoft_ads_list_report_types

Every report type with its columns, scope and filters.

microsoft_ads_poll_generate_report

Gets the status of a report request.

microsoft_ads_run_report

Run a performance report and get its rows.

microsoft_ads_submit_generate_report

Submits a report request.

microsoft_ads_update_ad_groups

Updates the specified ad groups in a campaign.

microsoft_ads_add_asset_groups

Adds array of asset groups to a specified campaign.

microsoft_ads_add_brand_kits

Create new brand kit.

microsoft_ads_add_html5s

Adds array of HTML5 assets to a specified campaign.

microsoft_ads_add_media

Adds the specified media to an account's asset library.

microsoft_ads_add_videos

Adds one or more videos to an account.

microsoft_ads_apply_asset_group_listing_group_actions

Applies an action to an asset group listing group.

microsoft_ads_create_asset_group_recommendation

Create an asset group recommendation.

microsoft_ads_create_brand_kit_recommendation

Creates a brand kit recommendation.

microsoft_ads_create_responsive_ad_recommendation

Create a responsive ad recommendation.

microsoft_ads_create_responsive_search_ad_recommendation

Create a responsive search ad recommendation.

microsoft_ads_delete_asset_groups

Deletes one or more AssetGroups.

microsoft_ads_delete_brand_kits

Deletes BrandKits from the account.

microsoft_ads_delete_html5s

Deletes array of HTML5 assets from a specified campaign.

microsoft_ads_delete_media

Deletes the specified media from an account's media library.

microsoft_ads_delete_videos

Deletes one or more videos from the account.

microsoft_ads_get_asset_group_listing_groups_by_ids

Retrieves the specified AssetGroupListingGroups.

microsoft_ads_get_asset_groups_by_campaign_id

Retrieves the specified AssetGroups.

microsoft_ads_get_asset_groups_by_ids

Retrieves specified AssetGroups.

microsoft_ads_get_asset_groups_editorial_reasons

Gets reasons for asset group editorial issues.

microsoft_ads_get_brand_kits_by_account_id

Retrieves all of the BrandKits associated with the specified account.

microsoft_ads_get_brand_kits_by_ids

Retrieves the specified BrandKits from the specified account.

microsoft_ads_get_clipchamp_templates

Gets the specified clip champ templates.

microsoft_ads_get_html5s_by_ids

Retrieve HTML5 assets by their IDs.

microsoft_ads_get_media_associations

Gets the media associations of the specified entity type from an account's media library.

microsoft_ads_get_media_meta_data_by_account_id

Gets the media meta data of the specified entity type from an account's media library.

microsoft_ads_get_media_meta_data_by_ids

Gets the specified media meta data from an account's media library.

microsoft_ads_get_responsive_ad_recommendation_job

Retrieves a responsive ad recommentation job.

microsoft_ads_get_supported_clipchamp_audio

Gets the specified supported clip champ audio.

microsoft_ads_get_supported_fonts

Gets the specified supported fonts.

microsoft_ads_get_videos_by_ids

Gets videos by video identifiers.

microsoft_ads_refine_asset_group_recommendation

Refine an asset group recommendation.

microsoft_ads_refine_responsive_ad_recommendation

Refine a responsive ad recommendation.

microsoft_ads_refine_responsive_search_ad_recommendation

Refine a responsive search ad recommendation.

microsoft_ads_update_asset_groups

Updates the specified asset groups.

microsoft_ads_update_brand_kits

Updates the specified BrandKits in the account.

microsoft_ads_update_videos

Updates the videos within the account.

microsoft_ads_apply_recommendations

Apply one or more recommendations.

microsoft_ads_dismiss_recommendations

Dismiss one or more recommendations.

microsoft_ads_get_auction_insight_data

Gets auction insight data for an account, campaigns, ad groups, or keywords.

microsoft_ads_get_audience_breakdown

Gets the audience breakdown.

microsoft_ads_get_audience_full_estimation

Gets the audience full estimation.

microsoft_ads_get_auto_apply_opt_in_status

Get the auto-apply recommendations opt-in status for a single account.

microsoft_ads_get_bid_landscape_by_ad_group_ids

Given a list of existing ad groups, this operation returns for each a list of suggested bids and estimated performance statistics.

microsoft_ads_get_bid_landscape_by_campaign_ids

Given a list of existing campaigns, this operation returns for each a list of suggested bids and estimated performance statistics.

microsoft_ads_get_bid_landscape_by_keyword_ids

Given a list of existing keywords, this operation returns for each a list of suggested bids and estimated performance statistics from 1 to 7 days.

microsoft_ads_get_bid_opportunities

Gets the keyword bid opportunities of the specified ad group.

microsoft_ads_get_budget_opportunities

Gets the campaign budget opportunities of the specified campaign.

microsoft_ads_get_domain_categories

Gets the list of categories available for the website domain and language.

microsoft_ads_get_estimated_bid_by_keyword_ids

Gets the estimated bid value of one or more keywords - specified by keyword identifier - that could have resulted in an ad appearing in the targeted position in the search results in the last 7 days.

microsoft_ads_get_estimated_bid_by_keywords

Gets the estimated bid value of one or more keywords that could result in an ad appearing in the targeted position in the search results.

microsoft_ads_get_estimated_position_by_keyword_ids

Gets the estimated position in the search results if the specified bid value had been used for the keywords in the last 7 days.

microsoft_ads_get_estimated_position_by_keywords

Gets the estimated position in the search results if the specified bid value would be used for the specified keywords.

microsoft_ads_get_historical_keyword_performance

Gets the historical performance of the normalized search term.

microsoft_ads_get_historical_search_count

Gets the number of times the normalized term was used in a search during the specified time period.

microsoft_ads_get_keyword_categories

Gets the keyword categories to which the specified keywords belong.

microsoft_ads_get_keyword_demographics

Gets the age and gender of users who have searched for the specified keywords.

microsoft_ads_get_keyword_idea_categories

Gets the list of keyword idea categories.

microsoft_ads_get_keyword_ideas

Gets the list of keyword ideas.

microsoft_ads_get_keyword_locations

Gets the geographical locations of users who have searched for the specified keywords.

microsoft_ads_get_keyword_opportunities

Gets a list of keyword suggestions that are relevant to the specified ad group.

microsoft_ads_get_performance_insights_detail_data_by_account_id

Gets the performance insights detail data for a single account.

microsoft_ads_get_text_asset_suggestions_by_final_urls

Gets text asset suggestions by final URLs.

microsoft_ads_retrieve_recommendations

Retrieve a list of recommendations.

microsoft_ads_set_auto_apply_opt_in_status

Set the auto-apply recommendations opt-in status for a single account.

microsoft_ads_suggest_keywords_for_url

Suggests the possible keywords for the content located at the specified URL.

microsoft_ads_suggest_keywords_from_existing_keywords

Suggests keywords that could perform better than the specified keywords.

microsoft_ads_tag_recommendations

Notifies Microsoft Advertising that the specific recommendation to create responsive search ads should be tagged as *applied* or *dismissed*.

microsoft_ads_add_account

Creates a new account within an existing customer.

microsoft_ads_add_client_links

Initiates the client link process to manage the accounts of another customer.

microsoft_ads_delete_account

Deletes an account.

microsoft_ads_delete_customer

Deletes a customer.

microsoft_ads_delete_user

Deletes an user.

microsoft_ads_dismiss_notifications

A service operation to dismiss notifications.

microsoft_ads_find_accounts

Gets a list of accounts owned by the specified customer that match the specified filter criteria.

microsoft_ads_find_accounts_or_customers_info

Gets a list of the accounts and customers that match the specified filter criteria.

microsoft_ads_get_account_pilot_features

Gets a list of the feature pilot IDs that are enabled for an ad account.

microsoft_ads_get_accounts_info

Gets the identifiers, names, and numbers of accounts that are accessible from the specified customer.

microsoft_ads_get_customer

Gets the details of a customer.

microsoft_ads_get_customer_pilot_features

Gets a list of the feature pilot IDs that are enabled for all ad accounts owned by a customer (manager account).

microsoft_ads_get_customers_info

Gets the identifiers and names of customers that are accessible to the current authenticated user.

microsoft_ads_get_linked_accounts_and_customers_info

Gets the customer and account hierarchy under the specified customer.

microsoft_ads_get_notifications

Gets a list of notification objects.

microsoft_ads_get_users_info

Gets a list of objects that contains user identification information, for example the user name and identifier of the user.

microsoft_ads_search_client_links

Searches for the client links for the customer of the current authenticated user, filtered by the search criteria.

microsoft_ads_search_customers

Searches for customers that match the request criteria.

microsoft_ads_search_user_invitations

Searches for user invitations that match the request criteria.

microsoft_ads_send_user_invitation

Sends an email invitation for an user to sign up for Microsoft Advertising.

microsoft_ads_signup_customer

Creates a new customer and account.

microsoft_ads_update_account

Updates the details of the specified account.

microsoft_ads_update_client_links

Updates the status of the specified client links.

microsoft_ads_update_customer

Updates the details of the specified customer.

microsoft_ads_update_user

Updates the personal and business contact information about a Microsoft Advertising user.

microsoft_ads_update_user_roles

Updates the roles of the specified user.

microsoft_ads_validate_address

Determines whether or not the submitted address is valid for Microsoft Advertising accounts.

microsoft_ads_add_campaign_conversion_goals

Adds new campaign conversion goals to the account's shared campaign conversion goal library.

microsoft_ads_add_conversion_goals

Adds new conversion goals to the account's shared conversion goal library.

microsoft_ads_add_conversion_value_rules

Create new conversion value rules.

microsoft_ads_add_new_customer_acquisition_goals

Adds new customer acquisition goals to the account's shared conversion goal library.

microsoft_ads_add_uet_tags

Adds new Universal Event Tracking (UET) tags that you can add to your website to allow Microsoft Advertising to collect actions people take on your website.

microsoft_ads_apply_offline_conversion_adjustments

Applies offline conversion adjustments.

microsoft_ads_apply_offline_conversions

Applies offline conversions for the account with Microsoft Click Id among other offline conversion data.

microsoft_ads_apply_online_conversion_adjustments

Applies online conversion adjustments.

microsoft_ads_delete_campaign_conversion_goals

Deletes a campaign conversion goal.

microsoft_ads_get_conversion_goals_by_tag_ids

Gets the conversion goals that use the specified UET tags.

microsoft_ads_get_conversion_value_rules_by_account_id

Gets conversion value rules by the account ID.

microsoft_ads_get_conversion_value_rules_by_ids

Gets conversion value rules by their IDs.

microsoft_ads_get_new_customer_acquisition_goals_by_account_id

Gets the specified new customer acquisition goals.

microsoft_ads_get_offline_conversion_report_by_goal_ids

Retrieves offline conversion statistics and diagnostics for your accounts.

microsoft_ads_get_offline_conversion_reports

Gets the offline conversion reports in the requested date range.

microsoft_ads_get_uet_tag_auth_key

Gets an authentication key for a UET (Universal Event Tracking) tag.

microsoft_ads_update_conversion_goals

Updates conversion goals within the account's shared conversion goal library.

microsoft_ads_update_conversion_value_rules

Update existing conversion value rules.

microsoft_ads_update_conversion_value_rules_status

Update the status of the specified conversion value rules.

microsoft_ads_update_new_customer_acquisition_goals

Update the specificed new customer acquisition goals.

microsoft_ads_update_uet_tags

Updates the specified Universal Event Tracking (UET) tags.

microsoft_ads_add_audience_groups

Adds array of audience groups to the account.

microsoft_ads_add_audiences

Adds one or more audiences.

microsoft_ads_add_linked_in_segments

Adds array of LinkedIn segments to a specified campaign.

microsoft_ads_apply_customer_list_items

Defines the ApplyCustomerListItems service operation.

microsoft_ads_apply_customer_list_user_data

Defines the ApplyCustomerListUserData service operation.

microsoft_ads_delete_audience_group_asset_group_associations

Deletes one or more AudienceGroupAssetGroupAssociations.

microsoft_ads_delete_audience_groups

Deletes one or more AudienceGroups.

microsoft_ads_delete_audiences

Deletes the specified audiences.

microsoft_ads_delete_linked_in_segments

Deletes array of LinkedIn segments from a specified campaign.

microsoft_ads_get_asset_group_associations_by_audience_group_ids

Retrieves the specified AudienceGroupAssetGroupAssociations by audience group IDs.

microsoft_ads_get_audience_group_associations_by_asset_group_ids

Retrieves the specified AudienceGroupAssetGroupAssociations by asset group IDs.

microsoft_ads_get_audience_groups_by_ids

Retrieves specified AudienceGroups.

microsoft_ads_get_audiences_by_ids

Retrieves the specified audiences from the specified account.

microsoft_ads_get_company_list_details

Retreives company list details.

microsoft_ads_get_linked_in_segments

Retrieves LinkedIn segments associated with the account.

microsoft_ads_search_companies

Search for profile data by company name.

microsoft_ads_set_audience_group_asset_group_associations

Sets AudienceGroupAssetGroupAssociations.

microsoft_ads_update_audience_groups

Updates the specified audience groups.

microsoft_ads_update_audiences

Updates the specified audiences.

microsoft_ads_update_linked_in_segments

Updates the specified LinkedIn segments.

microsoft_ads_add_bid_strategies

Adds bid strategies to an account's portfolio bid strategy library.

microsoft_ads_add_budgets

Adds new budgets to the account's shared budget library.

microsoft_ads_add_data_exclusions

Add a data exclusion to the specified account.

microsoft_ads_add_seasonality_adjustments

Add seasonality adjustments to the specified account.

microsoft_ads_delete_bid_strategies

Deletes bid strategies from an account's portfolio bid strategy library.

microsoft_ads_delete_budgets

Deletes budgets from the account's shared budget library.

microsoft_ads_delete_data_exclusions

Deletes the specified data exclusions from the specified account.

microsoft_ads_delete_seasonality_adjustments

Deletes the specified seasonality adjustments from the specified account.

microsoft_ads_get_bid_strategies_by_ids

Gets bid strategies in an account's portfolio bid strategy library.

microsoft_ads_get_data_exclusions_by_account_id

Gets the data exclusions associated with an account.

microsoft_ads_get_data_exclusions_by_ids

Gets the specified data exclusions associated with an account.

microsoft_ads_get_seasonality_adjustments_by_account_id

Gets the seasonality adjustments associated with an account.

microsoft_ads_get_seasonality_adjustments_by_ids

Gets the specified seasonality adjustments associated with an account.

microsoft_ads_update_bid_strategies

Updates bid strategies in an account's portfolio bid strategy library.

microsoft_ads_update_data_exclusions

Make updates to the specified data exclusions.

microsoft_ads_update_seasonality_adjustments

Make updates to the specified seasonality adjustments.

microsoft_ads_add_insertion_order

Adds an insertion order to the specified account.

microsoft_ads_add_list_items_to_shared_list

Adds negative keywords to a negative keyword list, or negative sites to a website exclusion list.

microsoft_ads_add_shared_entity

Adds a negative keyword list to the ad account library, or adds a website exclusion list to the manager account (customer) library.

microsoft_ads_check_feature_adoption_coupon_eligibility

Check the FAC eligibility of an account.

microsoft_ads_claim_feature_adoption_coupons

Claim feature adoption coupons.

microsoft_ads_delete_list_items_from_shared_list

Deletes negative keywords from a negative keyword list, or negative sites from a website exclusion list.

microsoft_ads_delete_shared_entities

Deletes negative keyword lists from the ad account library, or deletes website exclusion lists from the manager account (customer) library.

microsoft_ads_delete_shared_entity_associations

Deletes the negative keyword list to campaign associations, or website exclusion list to ad account associations.

microsoft_ads_dispatch_coupons

Dispatch coupons of the specified coupon class name owned by the specified customer.

microsoft_ads_distribute_coupons

Distribute coupons of the specified coupon class name to the specified accounts.

microsoft_ads_get_billing_documents

Gets the specified billing documents.

microsoft_ads_get_billing_documents_info

Gets a list of objects that contains billing document identification information, for example the billing document identifier, amount, and account identifier.

microsoft_ads_get_billing_groups

Retrieves billing groups.

microsoft_ads_get_coupon_info

Gets information about coupons associated with a customer ID.

microsoft_ads_get_list_items_by_shared_list

Gets the negative keywords of a negative keyword list, or negative sites of a website exclusion list.

microsoft_ads_get_negative_sites_by_ad_group_ids

Gets the negative sites URLs that are assigned directly to ad groups.

microsoft_ads_get_negative_sites_by_campaign_ids

Gets the negative site URLs that are assigned directly to campaigns.

microsoft_ads_get_shared_entities

Gets negative keyword lists or website exclusion lists.

microsoft_ads_get_shared_entities_by_account_id

Gets negative keyword lists.

microsoft_ads_get_shared_entity_associations_by_entity_ids

Gets the negative keyword list to campaign associations by campaign IDs, or website exclusion list to ad account associations by ad account IDs.

microsoft_ads_get_shared_entity_associations_by_shared_ids

Gets the negative keyword list to campaign associations by negative keyword list IDs, or website exclusion list to ad account associations by website exclusion list IDs.

microsoft_ads_get_ungrouped_accounts

Retrieves ungrouped accounts.

microsoft_ads_redeem_coupon

Redeems a coupon to the specified account.

microsoft_ads_search_coupons

Searches for coupons that match a specified criteria from within the set of coupons where the supplied *customerID* is identified as the *ownerCustomer*.

microsoft_ads_search_insertion_orders

Searches for insertion orders that match a specified criteria.

microsoft_ads_set_negative_sites_to_ad_groups

Sets the negative site URLs directly to ad groups.

microsoft_ads_set_negative_sites_to_campaigns

Sets the negative site URLs directly to campaigns.

microsoft_ads_set_shared_entity_associations

Sets the negative keyword list to campaign associations, or website exclusion list to ad account associations.

microsoft_ads_update_billing_group_accounts

Updates billing group accounts.

microsoft_ads_update_insertion_order

Updates an insertion order within the specified account.

microsoft_ads_update_shared_entities

Updates the negative keyword lists or website exclusion lists.

microsoft_ads_add_experiments

Adds experiments and creates experiment campaigns based on existing campaigns in an account.

microsoft_ads_delete_experiments

Deletes one or more experiments.

microsoft_ads_get_campaign_ids_by_bid_strategy_ids

Gets the campaign identifiers that are associated with the specified portfolio bid strategies.

microsoft_ads_get_campaign_ids_by_budget_ids

Gets the campaign identifiers that share each specified budget.

microsoft_ads_get_campaigns_by_account_id

Gets the campaigns within an account.

microsoft_ads_get_experiments_by_ids

Gets experiments by experiment identifiers.

microsoft_ads_update_experiments

Updates the specified experiments.

microsoft_ads_get_account_migration_statuses

Gets the migration status info for the specified accounts.

microsoft_ads_get_account_properties

Gets account level properties by name.

microsoft_ads_get_annotation_opt_out

Returns the current annotation opt-out configuration.

microsoft_ads_get_bmc_stores_by_customer_id

Gets the Microsoft Merchant Center stores for the specified customer.

microsoft_ads_get_bsc_countries

Gets the list of supported sales country codes for Microsoft Shopping Campaigns.

microsoft_ads_get_diagnostics

Defines the get diagnostics service operation.

microsoft_ads_get_geo_locations_file_url

Gets a temporary URL that you can use to download a file that contains identifiers for the geographical locations that you can target or exclude.

microsoft_ads_get_health_check

Retrieves health check entities and types.

microsoft_ads_get_profile_data_file_url

Gets a temporary URL that you can use to download industry or job function profile data.

microsoft_ads_set_account_properties

Sets account level properties by name.

microsoft_ads_update_annotation_opt_out

Updates the annotation opt-out settings for an account.

microsoft_ads_add_ad_group_criterions

Adds one or more ad group criterions.

microsoft_ads_add_campaign_criterions

Adds one or more campaign criterions that help determine whether ads in each campaign get served.

microsoft_ads_apply_hotel_group_actions

Applies an add, update, or delete action to each of the specified BiddableAdGroupCriterion or NegativeAdGroupCriterion, which each contain a HotelGroup.

microsoft_ads_apply_product_partition_actions

Applies an add, update, or delete action to each of the specified BiddableAdGroupCriterion or NegativeAdGroupCriterion, which each contain a ProductPartition.

microsoft_ads_delete_ad_group_criterions

Deletes the specified ad group criterions.

microsoft_ads_delete_campaign_criterions

Deletes one or more campaign criterions.

microsoft_ads_delete_negative_keywords_from_entities

Deletes negative keywords from the specified campaign or ad group.

microsoft_ads_get_ad_group_criterions_by_ids

Gets ad group criterions by identifiers and types.

microsoft_ads_get_campaign_criterions_by_ids

Gets the specified campaign criterions.

microsoft_ads_get_keywords_by_asset_group_id

Gets the keywords within an asset group.

microsoft_ads_get_keywords_by_editorial_status

Retrieves the keywords with the specified editorial review status.

microsoft_ads_get_keywords_by_ids

Retrieves the specified keywords.

microsoft_ads_update_ad_group_criterions

Updates one or more ad group criterions.

microsoft_ads_update_campaign_criterions

Updates one or more campaign criterions.

microsoft_ads_add_ad_extensions

Adds one or more ad extensions to an account's ad extension library.

microsoft_ads_delete_ad_extensions

Deletes one or more ad extensions from the account's ad extension library.

microsoft_ads_delete_ad_extensions_associations

Removes the specified association from the respective campaigns or ad groups.

microsoft_ads_get_ad_extensions_associations

Gets the respective ad extension associations by the specified campaign and ad group identifiers.

microsoft_ads_get_ad_extensions_by_ids

Gets the specified ad extensions from the account's ad extension library.

microsoft_ads_get_ad_extensions_editorial_reasons

Gets reasons for ad extension editorial issues.

microsoft_ads_set_ad_extensions_associations

Associates the specified ad extensions with the respective campaigns or ad groups.

microsoft_ads_update_ad_extensions

Updates one or more ad extensions within an account's ad extension library.

microsoft_ads_add_labels

Adds one or more labels to an account.

microsoft_ads_appeal_editorial_rejections

Appeals ads or keywords that failed editorial review.

microsoft_ads_delete_ads

Deletes one or more ads from the specified ad group.

microsoft_ads_delete_label_associations

Deletes label associations.

microsoft_ads_delete_labels

Deletes one or more labels from the account.

microsoft_ads_get_ads_by_editorial_status

Retrieves the ads that belong to the specified ad group and have the specified editorial review status.

microsoft_ads_get_ads_by_ids

Retrieves the specified ads from the specified ad group.

microsoft_ads_get_editorial_reasons_by_ids

Gets the reasons why the specified entities failed editorial review and whether the issue is appealable.

microsoft_ads_get_label_associations_by_entity_ids

Gets label associations by entity identifiers.

microsoft_ads_get_label_associations_by_label_ids

Gets label associations by label identifiers.

microsoft_ads_set_label_associations

Sets label associations.

microsoft_ads_update_labels

Updates the labels within the account.

microsoft_ads_add_import_jobs

Creates a new import job.

microsoft_ads_delete_import_jobs

Deletes the import jobs.

microsoft_ads_get_import_entity_ids_mapping

Gets mappings of your source entity IDs to Microsoft Advertising entity IDs.

microsoft_ads_get_import_jobs_by_ids

Gets import jobs by their type and identifiers.

microsoft_ads_get_import_results

Gets results for import jobs completed within the last 90 days.

microsoft_ads_update_import_jobs

Replaces the specified import jobs with new import jobs.

microsoft_ads_delete_ad_groups

Deletes one or more ad groups from the specified campaign.

microsoft_ads_download_campaigns_by_campaign_ids

Downloads settings and performance data for the specified campaigns.

microsoft_ads_get_ad_groups_by_ids

Gets the specified ad groups within the specified campaign.

microsoft_ads_get_bulk_upload_status

Gets the status and completion progress of a bulk upload request.

microsoft_ads_get_bulk_upload_url

Submits a request for a URL where a bulk upload file may be posted.

Connect Microsoft Ads to Claude, ChatGPT and Claude Code

Authorize once, then an endpoint your client signs into. Nothing to deploy, and nothing to install on the Microsoft Ads side.

Register an app in the Microsoft Entra admin center with Any Entra ID Tenant + Personal Microsoft accounts and PopMCP's Redirect URI as a Web platform, request a developer token in Microsoft Advertising under Settings, Developer settings, copy the client ID, the secret Value and the developer token into PopMCP, then click Sign in with Microsoft and pick your ad account.

Application (client) ID00001111-aaaa-2222-bbbb-3333cccc4444

Client secret Value••••••••••••3f7a

Developer token••••••••••••3f7a

Authorize PopMCP on Microsoft AdsAuthorize

Drop the PopMCP URL into Claude, ChatGPT, Claude Code, Codex or any other supported client. It signs in through PopMCP with OAuth, so your Microsoft Ads credential never leaves the server.

app.popmcp.com/mcp

Claude wants to connectApprove

Ask for something harmless before the agent changes anything. Writes run as soon as it calls them, so confirm it reads the right account first.

Which campaigns spent the most last week, and how many conversions did each one get?

microsoft_ads_run_reportok

Then just ask for the work

“Which campaigns spent the most last week, and how many conversions did each one get?”
- run_report
“Show the search terms that cost money last month without a single conversion”
- run_report
“Pause the keywords in the Running Shoes ad group that had no clicks in the last 30 days”
- list_campaigns
- get_ad_groups_by_campaign_id
- run_report
- set_status
“Find keyword ideas for trail running shoes in the United States with monthly searches and suggested bids”
- keyword_ideas
“Add exact match keywords for our new waterproof line to the Shoes ad group with a $1.20 bid”
- get_ad_groups_by_campaign_id
- add_keywords
“How much has this ad account spent so far this month?”
- get_account_monthly_spend

Contact support View docs

Use Microsoft Ads from the assistant you already open

One hosted endpoint, registered once per client. The same tools and the same permissions, whichever window the request comes from.

Claude DesktopCustom connector

Add the PopMCP URL under Customize → Connectors and the tools appear in every chat.

Claude WebCustom connector

The same endpoint, registered in the browser. Nothing to install on the machine you are working from.

ChatGPTCustom connector

CodexDesktop & CLI

Wire the endpoint into Codex or the Codex CLI when a task needs live business context, not a fixture.

OpenCodeCoding agent

ZCodeDesktop app

Add PopMCP as an MCP server in Z.ai's desktop app and work the account from the same window.

Contact support View docs

FAQ

Microsoft Ads MCP server questions

What teams ask before putting Microsoft Ads behind an AI client.

How do I connect Microsoft Ads to PopMCP?

Sign in with the Microsoft account you use for Microsoft Advertising and approve access on Microsoft's own page, then pick the ad account from the list. Today that sign-in runs through an app you register once in the Microsoft Entra admin center (Any Entra ID Tenant + Personal Microsoft accounts, PopMCP's Redirect URI as a Web platform, a client secret) together with your developer token. Tokens renew on their own after that.

What is a developer token and where do I get one?

Microsoft Advertising asks every API call for a developer token as well as your sign-in. A Super Admin gets one at ui.ads.microsoft.com under Settings, then Developer settings: choose the user, accept the agreement and select Request Developer Token. It is usually issued at once. It grants no extra access: the AI can only reach the accounts your own login can open.

Can I connect accounts I manage as an agency?

Yes. After you sign in, PopMCP lists every ad account your login reaches, including client accounts linked to your manager account, and remembers which manager account each one is reached through. Pick one or several, each into its own workspace. A connection only works on its own ad account: a request for any other account is refused.

Does it work with personal Microsoft accounts?

Yes. Work or school accounts and personal Microsoft accounts both sign in, whichever one you use at ui.ads.microsoft.com. If your organization blocks third-party apps, an admin approves the app once. If Microsoft answers that your organization has not enabled the service, an Entra admin adds the Microsoft Advertising app to the tenant once, which Microsoft's own docs describe.

How do reports work?

Microsoft builds reports in the background. run_report submits one of 48 report types (campaign, ad group, keyword, search term, geographic, audience and more) with your columns and dates, waits for it, downloads the file and returns the rows. If a large report takes longer, it returns an id and get_report fetches the rows later. Money is in your account's currency.

Which Microsoft Ads events can PopMCP watch?

6 in total. Change detection for a new campaign, a campaign paused, enabled or out of budget, a changed daily budget, a change in the ad account's status and a new budget suggestion from Microsoft. One threshold fires when this month's spend passes the amount you set. Microsoft Advertising has no webhooks, so these are checked on a schedule.

How many Microsoft Ads tools load into my AI client?

39 everyday tools load by default, including the 7 that do several steps at once: account_overview, list_campaigns, run_report, get_report, list_report_types, set_status and keyword_ideas. All 277 operations stay reachable through search_tools, describe_tool and raw_operation, 149 that read and 128 that write, from audiences, conversion goals and UET tags to experiments, imports, bulk files and billing.

Do I have to run or host the Microsoft Ads MCP server myself?

No. PopMCP hosts it and gives you a Streamable HTTP MCP URL. There is nothing to deploy, no callback URL to register, and no infrastructure to keep running or patch.

Which AI clients can use this MCP server?

Any client that supports a remote Streamable HTTP MCP server: Claude Desktop, Claude Web, Claude Code, ChatGPT custom connectors, Codex and the Codex CLI, OpenCode and Z.ai's ZCode, as well as editors such as Cursor, Windsurf and Zed. Your client signs in to PopMCP with OAuth; the provider credential never leaves the server.

How do I connect Microsoft Ads to Claude Code?

Connect Microsoft Ads in PopMCP first, then run claude mcp add --transport http popmcp https://app.popmcp.com/mcp in a terminal. Inside Claude Code, run /mcp and sign in to PopMCP in the browser window it opens, ticking Microsoft Ads on the consent screen. The Microsoft Ads tools are then available in that session, and no Microsoft Ads credential is stored on your machine.

Why do only 39 of the 284 tools load by default?

Loading 284 tool definitions into every conversation burns context before the work starts. PopMCP loads a curated 39-tool set covering the everyday workflows and keeps the rest searchable, so your AI pulls a specialist tool only when a task needs it. Every tool stays searchable, and on Scale the owner can load the full catalog for a teammate's connection.

What is the difference between a tool and a trigger?

A tool is something your AI calls, and there are 284 here. A trigger is something PopMCP watches for you: 6 Microsoft Ads events that can start work on the PopMCP side. Triggers never enter your AI client's context, and none of them ask you to paste a callback URL into Microsoft Ads.

Connect Microsoft Ads to your AI in minutes

Launch a hosted MCP endpoint for Microsoft Ads, keep tool access under control, and start testing real workflow prompts right away.

Connect your first MCP