Microsoft Advertising MCP API reference

Every Microsoft Advertising tool the MCP server exposes, with its parameters. 42 tools, 118 metrics and 117 dimensions, on a dedicated endpoint.

View as Markdown

Performance alertsAvailable on Team and Enterprise. Check supported metrics, levels and dimensions before creating a rule.

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

To connect another identity without replacing your existing access, open this source in the dashboard and choose Add another account. Select accounts from the combined list and save. See account scoping for selection, plan limits and reconnection.

Connection

Platform id: bing_ads
Tool prefix: bing_
Account parameter: accountId
Dedicated endpoint: https://mcp.getmcpads.com/bing-ads/mcp
Access: Connect through Microsoft, then explicitly select the advertising accounts your assistant may access. Reads are available on Free; writes require an eligible paid plan.
Tools: 42, 23 of which write
Metrics: 118
Dimensions: 117

Scope requested

Scope requested
Scope	Grants	Allows writes
`https://ads.microsoft.com/msads.manage`	Read and write on Microsoft Advertising. No read-only scope is published by Microsoft.	Yes
`offline_access`	Keep the connection alive without asking you to sign in again.	No

Catalogues

Write tools (23)

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

Write tools (23)
Tool	What it does	Kind	Discovery
`bing_add_ad_group_targeting`	Add one native ad group targeting criterion.	Write	On demand
`bing_add_campaign_targeting`	Add one native campaign targeting criterion.	Write	On demand
`bing_create_ad`	Create a Microsoft Ads ad with native fields.	Write	On demand
`bing_create_ad_group`	Create a Microsoft Ads ad_group with native fields.	Write	On demand
`bing_create_asset_group`	Create a paused Performance Max asset group with text/image assets.	Write	On demand
`bing_create_audience`	Create a Microsoft Ads audience with native fields.	Write	On demand
`bing_create_campaign`	Create a Microsoft Ads campaign with native fields.	Write	On demand
`bing_create_conversion_goal`	Create a Microsoft Ads conversion_goal configuration.	Write	On demand
`bing_create_keyword`	Create a Microsoft Ads keyword with native fields.	Write	On demand
`bing_create_uet_tag`	Create a Microsoft Ads uet_tag configuration.	Write	On demand
`bing_import_video`	Import a video from your directly downloadable HTTPS file into the selected account.	Write	On demand
`bing_rename_account`	Rename the selected Microsoft Ads account.	Write	On demand
`bing_rename_ad_group`	Rename a Microsoft Ads ad group.	Write	On demand
`bing_rename_campaign`	Rename a Microsoft Ads campaign.	Write	On demand
`bing_update_ad`	Update a Microsoft Ads ad with native fields.	Write	On demand
`bing_update_ad_group`	Update a Microsoft Ads ad_group with native fields.	Write	On demand
`bing_update_ad_group_targeting`	Update one native ad group targeting criterion.	Write	On demand
`bing_update_audience`	Update a Microsoft Ads audience with native fields.	Write	On demand
`bing_update_campaign`	Update a Microsoft Ads campaign with native fields.	Write	On demand
`bing_update_campaign_targeting`	Update one native campaign targeting criterion.	Write	On demand
`bing_update_keyword`	Update a Microsoft Ads keyword with native fields.	Write	On demand
`bing_update_video`	Update the description of an account-owned video asset.	Write	On demand
`bing_upload_image`	Upload image bytes to the selected Microsoft Ads library.	Write	On demand

Read tools (19)

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.

Read tools (19)
Tool	What it does	Kind	Discovery
`bing_get_ad_groups`	Read ad groups and native configuration in an owned campaign.	Read	On demand
`bing_get_ads`	Read ads including native creative assets, URLs and status.	Read	On demand
`bing_get_asset_groups`	Read Performance Max asset groups with native creative configuration and status.	Read	On demand
`bing_get_audiences`	Read accessible audience configuration for one explicit type.	Read	On demand
`bing_get_campaigns`	Read native campaign configuration, budget, settings and status for an explicit campaign type.	Read	Announced
`bing_get_conversion_goals`	Read conversion-goal configuration; this does not establish that events are flowing.	Read	On demand
`bing_get_geo_file`	Get Microsoft's current geographic targeting catalog download link.	Read	On demand
`bing_get_insights`	Submit an asynchronous Microsoft Ads report for the selected account.	Read	Announced
`bing_get_keywords`	Read keywords, match types, bids and status from an owned ad group.	Read	On demand
`bing_get_media`	Read metadata of uploaded Microsoft Ads media by ID in the selected account.	Read	On demand
`bing_get_report`	Poll and download a Microsoft Ads report bound to this selected account and environment.	Read	On demand
`bing_get_reporting_schema`	Read the pinned Microsoft report types, supported native columns and official references.	Read	On demand
`bing_get_setup_guide`	Microsoft Ads connector coverage, validated workflows and remaining limitations.	Read	Announced
`bing_get_targeting`	Read actual configured campaign or group targeting, separately by criterion type.	Read	Announced
`bing_get_uet_tags`	Read UET tracking tag configuration.	Read	On demand
`bing_get_videos`	Read account video assets and processing status.	Read	On demand
`bing_get_write_schema`	Pinned Microsoft native entity fields.	Read	On demand
`bing_health_check`	Read the selected account and confirm its environment, customer and currency.	Read	Announced
`bing_list_ad_creatives`	Retrieve actual image representations linked to account-owned ads and Performance Max asset groups, preserving parent IDs/names.	Read	Announced

Manage your ads from your AI assistant

Start for free

Free with 1 ad account, no card. Pro is free for 7 days.