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
| Scope | Grants | Allows writes |
|---|---|---|
https:/ | 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 |
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.
| Tool | What it does | Kind | Discovery |
|---|---|---|---|
bing_ | Add one native ad group targeting criterion. | Write | On demand |
bing_ | 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 a Microsoft Ads ad_group with native fields. | Write | On demand |
bing_ | Create a paused Performance Max asset group with text/image assets. | Write | On demand |
bing_ | Create a Microsoft Ads audience with native fields. | Write | On demand |
bing_ | Create a Microsoft Ads campaign with native fields. | Write | On demand |
bing_ | Create a Microsoft Ads conversion_goal configuration. | Write | On demand |
bing_ | Create a Microsoft Ads keyword with native fields. | Write | On demand |
bing_ | Create a Microsoft Ads uet_tag configuration. | Write | On demand |
bing_ | Import a video from your directly downloadable HTTPS file into the selected account. | Write | On demand |
bing_update_ad | Update a Microsoft Ads ad with native fields. | Write | On demand |
bing_ | Update a Microsoft Ads ad_group with native fields. | Write | On demand |
bing_ | Update one native ad group targeting criterion. | Write | On demand |
bing_ | Update a Microsoft Ads audience with native fields. | Write | On demand |
bing_ | Update a Microsoft Ads campaign with native fields. | Write | On demand |
bing_ | Update one native campaign targeting criterion. | Write | On demand |
bing_ | Update a Microsoft Ads keyword with native fields. | Write | On demand |
bing_ | Update the description of an account-owned video asset. | Write | On demand |
bing_ | Upload image bytes to the selected Microsoft Ads library. | Write | On 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.
| Tool | What it does | Kind | Discovery |
|---|---|---|---|
bing_ | 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_ | Read Performance Max asset groups with native creative configuration and status. | Read | On demand |
bing_ | Read accessible audience configuration for one explicit type. | Read | On demand |
bing_ | Read native campaign configuration, budget, settings and status for an explicit campaign type. | Read | Announced |
bing_ | Read conversion-goal configuration; this does not establish that events are flowing. | Read | On demand |
bing_ | Get Microsoft's current geographic targeting catalog download link. | Read | On demand |
bing_ | Submit an asynchronous Microsoft Ads report for the selected account. | Read | Announced |
bing_ | 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_ | Read the pinned Microsoft report types, supported native columns and official references. | Read | On demand |
bing_ | Microsoft Ads connector coverage, sandbox validation and remaining limitations. | Read | Announced |
bing_ | Read actual configured campaign or group targeting, separately by criterion type. | Read | Announced |
bing_ | Read UET tracking tag configuration. | Read | On demand |
bing_get_videos | Read account video assets and processing status. | Read | On demand |
bing_ | Pinned Microsoft native entity fields. | Read | On demand |
bing_ | Read the selected account and confirm sandbox/production, customer and currency. | Read | Announced |
bing_ | Retrieve actual image representations linked to account-owned ads and Performance Max asset groups, preserving parent IDs/names. | Read | Announced |