# Microsoft Advertising setup

> Connect Microsoft Advertising to Claude, ChatGPT, Codex or any MCP client, what to ask it once it is connected, and the 39 tools behind the answers.

[Guides](https://www.getmcpads.com/guides)

## For you

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

> **Note** 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.

## Connect it

1. Open Sources to review access status. Authorized operators can open connection setup; external assistants must wait until access is enabled.
2. Approve the consent screen. The gateway stores an encrypted refresh token, never a password.
3. Tick the accounts to expose. Nothing is readable until you do.
4. Paste the endpoint into your assistant, or use the shared one for every platform at once.

Microsoft Advertising on its own endpoint

```text
https://mcp.getmcpads.com/bing-ads/mcp
```

## What to ask

```text
Report campaign performance for the last 30 days with native units.
Show configured targeting, audience inclusions and exclusions.
Prepare a campaign, group and ad, keeping everything paused.
Show the actual creative assets linked to ads.
```

## What answers each one

| Question | Tools |
| --- | --- |
| Report campaign performance for the last 30 days with native units. | [`bing_get_campaigns`](https://www.getmcpads.com/docs/sources/bing-ads/tools/bing_get_campaigns), [`bing_get_insights`](https://www.getmcpads.com/docs/sources/bing-ads/tools/bing_get_insights), [`bing_get_report`](https://www.getmcpads.com/docs/sources/bing-ads/tools/bing_get_report) |
| Show configured targeting, audience inclusions and exclusions. | [`bing_get_ad_groups`](https://www.getmcpads.com/docs/sources/bing-ads/tools/bing_get_ad_groups), [`bing_get_targeting`](https://www.getmcpads.com/docs/sources/bing-ads/tools/bing_get_targeting), [`bing_get_audiences`](https://www.getmcpads.com/docs/sources/bing-ads/tools/bing_get_audiences) |
| Prepare a campaign, group and ad, keeping everything paused. | [`bing_get_write_schema`](https://www.getmcpads.com/docs/sources/bing-ads/tools/bing_get_write_schema), [`bing_create_campaign`](https://www.getmcpads.com/docs/sources/bing-ads/tools/bing_create_campaign), [`bing_create_ad_group`](https://www.getmcpads.com/docs/sources/bing-ads/tools/bing_create_ad_group), [`bing_create_ad`](https://www.getmcpads.com/docs/sources/bing-ads/tools/bing_create_ad) |
| Show the actual creative assets linked to ads. | [`bing_get_ads`](https://www.getmcpads.com/docs/sources/bing-ads/tools/bing_get_ads), [`bing_list_ad_creatives`](https://www.getmcpads.com/docs/sources/bing-ads/tools/bing_list_ad_creatives) |

## What it can change

Native campaign, ad group, ad, keyword, targeting, audience, conversion and asset operations are implemented and tested in selected sandbox configurations. Production writes remain disabled.

> **Warning** 20 write tools, absent from the tool list on the Free plan. Each one previews by default and needs a second call with confirm before anything changes.

- [Microsoft Advertising reference](https://www.getmcpads.com/docs/sources/bing-ads): All 39 tools, with their parameters.
- [Metrics](https://www.getmcpads.com/docs/sources/bing-ads/metrics): 109 metrics you can request.
- [Dimensions](https://www.getmcpads.com/docs/sources/bing-ads/dimensions): 84 dimensions and report attributes.
- [Skills](https://www.getmcpads.com/skills): 4 operating procedures use this source.

## For your agent

> **Note** 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.

|  |  |
| --- | --- |
| Platform id | `bing_ads` |
| Tool prefix | `bing_` |
| Account parameter | `accountId` |
| Dedicated endpoint | https://mcp.getmcpads.com/bing-ads/mcp |
| Tools | 39, 20 of which write |
| Announced by default | `bing_get_campaigns`, `bing_get_insights`, `bing_get_setup_guide`, `bing_get_targeting`, `bing_health_check`, `bing_list_ad_creatives` |
| Metrics | 109, see /docs/sources/bing-ads/metrics |
| Dimensions | 84, see /docs/sources/bing-ads/dimensions |

## Scope requested from the platform

| 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 |

## Reaching a tool that is not announced

```text
search_tools({ task: "..." })      find it
describe_tool({ name: "..." })     read its schema
run_tool({ name, args })           execute, with the same checks
```

## What will refuse you

- An account not ticked by the owner. Call `list_accounts` and use a `accountId` from it.
- A write on a plan without writes. The tool is absent from the list and refused if called anyway.
- A write without `confirm: true` returns a preview and applies nothing. That is not an error.
- A call to this platform on another platform's dedicated endpoint. The refusal names the URL that serves it.

## Questions this source answers

| Question | Tools, in order |
| --- | --- |
| Report campaign performance for the last 30 days with native units. | `bing_get_campaigns` then `bing_get_insights` then `bing_get_report` |
| Show configured targeting, audience inclusions and exclusions. | `bing_get_ad_groups` then `bing_get_targeting` then `bing_get_audiences` |
| Prepare a campaign, group and ad, keeping everything paused. | `bing_get_write_schema` then `bing_create_campaign` then `bing_create_ad_group` then `bing_create_ad` |
| Show the actual creative assets linked to ads. | `bing_get_ads` then `bing_list_ad_creatives` |

---

This page as HTML: https://www.getmcpads.com/guides/sources/bing-ads
Every page under /guides and /docs is available as Markdown: append `.md`, or send `Accept: text/markdown`.
