Skip to content
Get MCP AdsGet MCP Ads, home

Microsoft Advertising MCP API reference

Every Microsoft Advertising tool the MCP server exposes, with its parameters. 39 tools, 109 metrics and 84 dimensions, on a dedicated endpoint.

41 rows

Search, Audience and Performance Max account structure, keywords, targeting, audiences, UET, image and video assets, and asynchronous reports.

Connection

Platform id
bing_ads
Tool prefix
bing_
Account parameter
accountId
Dedicated endpoint
https://mcp.getmcpads.com/bing-ads/mcp
Access
External assistant access is not enabled. Sandbox testing and production account discovery are available to authorized operators. Publisher and external-tenant consent verification remain in progress; the developer token has already been obtained.
Tools
39, 20 of which write
Metrics
109
Dimensions
84

Scope requestedLink to this section

ScopeGrantsAllows writes
https://ads.microsoft.com/msads.manageRead and write on Microsoft Advertising. No read-only scope is published by Microsoft.Yes
offline_accessKeep the connection alive without asking you to sign in again.No

CataloguesLink to this section

Write tools (20)Link to this section

Absent from the tool list on the Free plan. Each one previews by default and needs a second call with confirm: true.

ToolWhat it doesKindDiscovery
bing_add_ad_group_targetingAdd one native ad group targeting criterion.WriteOn demand
bing_add_campaign_targetingAdd one native campaign targeting criterion.WriteOn demand
bing_create_adCreate a Microsoft Ads ad with native fields.WriteOn demand
bing_create_ad_groupCreate a Microsoft Ads ad_group with native fields.WriteOn demand
bing_create_asset_groupCreate a paused Performance Max asset group with text/image assets.WriteOn demand
bing_create_audienceCreate a Microsoft Ads audience with native fields.WriteOn demand
bing_create_campaignCreate a Microsoft Ads campaign with native fields.WriteOn demand
bing_create_conversion_goalCreate a Microsoft Ads conversion_goal configuration.WriteOn demand
bing_create_keywordCreate a Microsoft Ads keyword with native fields.WriteOn demand
bing_create_uet_tagCreate a Microsoft Ads uet_tag configuration.WriteOn demand
bing_import_videoImport a video from your directly downloadable HTTPS file into the selected account.WriteOn demand
bing_update_adUpdate a Microsoft Ads ad with native fields.WriteOn demand
bing_update_ad_groupUpdate a Microsoft Ads ad_group with native fields.WriteOn demand
bing_update_ad_group_targetingUpdate one native ad group targeting criterion.WriteOn demand
bing_update_audienceUpdate a Microsoft Ads audience with native fields.WriteOn demand
bing_update_campaignUpdate a Microsoft Ads campaign with native fields.WriteOn demand
bing_update_campaign_targetingUpdate one native campaign targeting criterion.WriteOn demand
bing_update_keywordUpdate a Microsoft Ads keyword with native fields.WriteOn demand
bing_update_videoUpdate the description of an account-owned video asset.WriteOn demand
bing_upload_imageUpload image bytes to the selected Microsoft Ads library.WriteOn demand

Read tools (19)Link to this section

Tools marked Announced appear in your client's tool list. The rest are reachable through search_tools and run_tool, which run the same checks.

ToolWhat it doesKindDiscovery
bing_get_ad_groupsRead ad groups and native configuration in an owned campaign.ReadOn demand
bing_get_adsRead ads including native creative assets, URLs and status.ReadOn demand
bing_get_asset_groupsRead Performance Max asset groups with native creative configuration and status.ReadOn demand
bing_get_audiencesRead accessible audience configuration for one explicit type.ReadOn demand
bing_get_campaignsRead native campaign configuration, budget, settings and status for an explicit campaign type.ReadAnnounced
bing_get_conversion_goalsRead conversion-goal configuration; this does not establish that events are flowing.ReadOn demand
bing_get_geo_fileGet Microsoft's current geographic targeting catalog download link.ReadOn demand
bing_get_insightsSubmit an asynchronous Microsoft Ads report for the selected account.ReadAnnounced
bing_get_keywordsRead keywords, match types, bids and status from an owned ad group.ReadOn demand
bing_get_mediaRead metadata of uploaded Microsoft Ads media by ID in the selected account.ReadOn demand
bing_get_reportPoll and download a Microsoft Ads report bound to this selected account and environment.ReadOn demand
bing_get_reporting_schemaRead the pinned Microsoft report types, supported native columns and official references.ReadOn demand
bing_get_setup_guideMicrosoft Ads connector coverage, sandbox validation and remaining limitations.ReadAnnounced
bing_get_targetingRead actual configured campaign or group targeting, separately by criterion type.ReadAnnounced
bing_get_uet_tagsRead UET tracking tag configuration.ReadOn demand
bing_get_videosRead account video assets and processing status.ReadOn demand
bing_get_write_schemaPinned Microsoft native entity fields.ReadOn demand
bing_health_checkRead the selected account and confirm sandbox/production, customer and currency.ReadAnnounced
bing_list_ad_creativesRetrieve actual image representations linked to account-owned ads and Performance Max asset groups, preserving parent IDs/names.ReadAnnounced
Esc

Type to search