Microsoft Ads MCP: what an AI agent can read and change in a B2B account
Microsoft's own Ads MCP server is free, hosted and read-only as of November 2026, so here is what its nine tools read, how to connect it, and which second route covers writes, LinkedIn profile data and pipeline.

A Microsoft Ads MCP server connects Claude, ChatGPT or Microsoft 365 Copilot to a Microsoft Advertising account. As of November 2026 Microsoft's own server is free, hosted by Microsoft and read-only: nine tools read campaigns, keywords, assets, audiences and 180 days of change history, and none of them change anything.
You probably know the account in question. It was imported from Google Ads two years ago, it carries a modest slice of the search budget, and it gets looked at when the invoice arrives. Then someone asks in the quarterly review why Bing's cost per lead doubled in August, and nobody can say who changed what, because nobody was watching.
This guide is for the paid media lead who wants an AI client watching that account instead. It sets out what Microsoft's server reads, in a capability table built only from Microsoft's documentation, walks through the setup for Claude and ChatGPT, and covers what a B2B team needs that the official server doesn't give: writes, and the LinkedIn profile and pipeline data that make Microsoft Ads worth having.
Microsoft's own server is hosted, free and read-only
The Microsoft Advertising MCP server is a remote server that Microsoft runs at one fixed address, so there's nothing to install or host. Microsoft announced on June 17, 2026 that it was "expanding to open pilot with read-only access", and its tools documentation, last updated on October 20, 2026, still says it plainly: "The tools never modify account data."
Microsoft's product page answers the cost question in one line: "Yes, it's free to connect to the Microsoft Advertising MCP server." You may still pay for the AI client or its token usage. The setup guide covers four clients: Copilot Studio, GitHub Copilot in VS Code, ChatGPT and Claude. Sign-in runs through Microsoft Entra ID OAuth with either a work account or a personal Microsoft account, as long as that account already has access to the Microsoft Advertising accounts you want to query.
Having no write tools at all sets Microsoft's server apart from the Google, Meta and LinkedIn servers summarized later in this guide. For a team nervous about letting an AI near a budget, that's a feature.
Geoff Becker, a product manager at Realtor.com, told Microsoft that work which used to require manual pulls across several tools now happens "in seconds, with a human reviewer still in the loop before anything goes live." The AI reads and drafts, and a person makes the change.
A weekly AI review of the smaller search account means the team acts on what changed instead of exporting reports, and Scalewell helps paid teams put that review in place.
The nine tools read structure, performance and change history, and change nothing
Microsoft's server exposes nine tools, every one of them a read, and each returns its results in pages. The table maps each tool to the job a paid team would give it, using only what Microsoft's tools page and use-case guide say, as of November 2026.
| Tool | What it reads, per Microsoft's docs | A B2B job it suits | Writes | Approval step |
|---|---|---|---|---|
| GetAccounts | Account ID, name, number, currency, billing customer, owner | List every account a user can reach before an audit | None | None needed |
| GetCampaigns | Budget, campaign type, status, delivery status, bid strategy, dates | Find campaigns that aren't delivering, with their budgets | None | None needed |
| GetAdGroups | Ad groups with status and performance | Rank ad groups by spend with zero conversions | None | None needed |
| GetAds | Ad copy and status across eight ad types, including responsive search ads | Check every live ad still matches the current offer | None | None needed |
| GetKeywords | Keywords, match types (including AIOptimized), bids, performance | Flag keywords with spend and no conversions in 30 days | None | None needed |
| GetAssetGroups | Performance Max headlines, images, videos, search themes, landing URLs | Review what Performance Max is saying on your behalf | None | None needed |
| GetAssets | Text, image and video assets with usage, pinning and performance | Find headlines with impressions and no clicks | None | None needed |
| GetAudienceAssociations | Audience targets and bid adjustments by campaign and ad group | Confirm the audience lists you expect are still attached | None | None needed |
| GetChangeHistory | Who changed what, with old and new values, for the last 180 days | Answer "who paused this and when" without opening the UI | None | None needed |
Performance comes back as spend, impressions, clicks, CTR, average CPC and CPM, conversions, conversion rate, revenue, ROAS, CPA, and top and absolute top impression rate. Microsoft's use-case guide adds anomaly checks, Excel or Power BI exports, and a Google Ads comparison that only works if your AI client is connected to Google Ads too.

Copilot in Microsoft Advertising reads the same account from inside the platform
Copilot in Microsoft Advertising Platform is the assistant built into the ad account itself, and it answers many of the same questions as the MCP server without any setup. You open it from the Copilot button at the top right of the platform, or select Summarize on the campaign grid or the Overview page for a quick performance snapshot, according to Microsoft's help page.
It diagnoses delivery blockers and broken UET tags, explains spikes and drops, and drafts ad assets, but the help page is clear about its limit: "Copilot cannot yet make changes to your account or perform other actions on your behalf." So both of Microsoft's AI routes are readers today.
The difference is where the answer lands. Copilot's answer stays inside Microsoft Advertising, while the MCP server brings the account data into the AI client that already holds your CRM and Google Ads data. Use Copilot for a quick "why did impressions drop" check, and the MCP server for a weekly report that sets Microsoft beside Google and against pipeline. Neither is the same thing as ads shown inside Microsoft's consumer Copilot, which come from your existing Microsoft Ads campaigns with no opt-out and no separate reporting, as we cover in Microsoft Copilot ads.
Connecting Claude takes eight steps and one Entra app registration
Claude connects to Microsoft's server as a custom connector, using an app registration you create once in Microsoft Entra ID. You need an Azure sign-in with permission to create app registrations in your company's Entra tenant, which is usually an IT request rather than a marketing one, so ask early. The steps follow Microsoft's setup guide as of November 2026.
- Install the Azure CLI and sign in. Install it, reopen your terminal, then run
az login, oraz login --allow-no-subscriptionif you have no Azure subscription. - Create the app registration. Run the command below and save the
appIdit returns, which is your client ID.
az ad app create --display-name "Ads MCP App" --sign-in-audience AzureADandPersonalMicrosoftAccount
- Register Claude's callback address. Add
https://claude.ai/api/mcp/auth_callbackas a public client redirect URI on that app, using the PowerShell snippet in Microsoft's guide. - Check who may add connectors. Custom connectors work on Claude's Free plan (limited to one connector) and on every paid plan. On Team and Enterprise, an owner adds it under Organization settings, then Connectors, and members then connect to it individually.
- Add the connector. In Claude, open Customize, then Connectors, select "+ Add" and choose "Add custom connector", per Anthropic's connector guide. Name it, and paste
https://partner.api.bingads.microsoft.com/ext/mcp/vnextas the MCP Server URL. - Use your own OAuth client. Under Authentication choose "Sign in now", under OAuth client choose "Use your own OAuth client", enter your client ID, then select Add and Connect.
- Sign in as the right user. Authorize with the Microsoft account the AI should act as (the next section covers which one) and grant consent.
- Ask one question and reconcile it. Find your IDs in the address bar: open the Campaigns tab in Microsoft Advertising, and the URL carries your customer ID after
cid=and your account ID afteraid=. Then ask for last week's spend by campaign with a date range, and check it against the platform to the cent before you trust anything harder.
ChatGPT takes the same app registration with its own callback. Plan support is described differently by the two companies: Microsoft's guide lists ChatGPT web on Plus, Pro, Business, Enterprise and Edu, while OpenAI's help center limits full MCP support to Business and Enterprise/Edu and says Pro users "can connect custom MCP servers with read/fetch permissions", so check your plan on OpenAI's page first. You create the app from Plugins, choose "User-Defined OAuth Client", and enter the scopes and endpoints from the guide's table. If you can't get an app registration at all, GitHub Copilot in VS Code connects with an interactive Microsoft sign-in and needs no client ID.
Sign in as a Viewer so the AI's access matches its job
The Microsoft account that completes the sign-in decides what any MCP route can reach, and Microsoft's user roles page says the Viewer role "has read-only permissions". That matters the day you add a second route that can write, or the day Microsoft adds write tools.
Create a dedicated user for the AI: in Microsoft Advertising, hover over Settings in the left menu, select User management, then Invite user, and give it the Viewer role. Only Super Admins and Standard Users can send the invite, and most accounts allow up to 15 users. A separate user also means the change history shows the AI's actions apart from your team's, which is the record you'll want before anyone argues for wider permissions. Our guide to AI agents for PPC covers how that log earns an agent more room.
LinkedIn profile targeting in Microsoft Ads is the B2B data the documented tools leave out
LinkedIn profile targeting lets Microsoft Ads adjust bids by a searcher's company, industry and job function, and for many B2B teams it's the main reason to run Microsoft Ads. Microsoft's LinkedIn profile targeting page lists Search, Dynamic Search ads, Shopping, Audience and Performance Max campaigns (not yet for every Performance Max advertiser), with a cap of 1,000 companies per ad group or campaign, and company lists that must be added by hand inside the platform.
Two details change how you read anything an AI tells you about it. The targeting is bid only: Microsoft says it "will not narrow your ads' audience", so a campaign "targeting" your ICP companies still shows to everyone else. And the documented MCP tools do not include a company, industry or job function breakdown, going by Microsoft's tools page as of November 2026. The Bing Ads API has one, through the professional demographics audience report, which Microsoft describes as "the impressions, clicks, spend, and average cost-per-click for each ad group, organized by company, industry, and job function."
So for a question like "how much did we spend reaching our target accounts on Bing last quarter", ask once in your first week to see what comes back, then plan on a route that calls the Reporting API for that report, or on a file export you hand to the AI.
Writes and pipeline data need a second route
Any change to a Microsoft Ads account through an AI client goes through something other than Microsoft's server: a hosted connector, a general automation service, an open-source server or code you write on the Bing Ads API. The table shows what each route's own pages said on November 15, 2026. Vendors appear as examples of their type, not as recommendations.
| Route | Example checked | Reads | Writes | Approval before a write | Cost as of November 2026 |
|---|---|---|---|---|---|
| Microsoft's own server | Microsoft Advertising MCP | Nine read tools above | None | Not applicable | Free to connect |
| Hosted connector service | Windsor.ai | Performance and structure | Five actions: enable or pause campaigns and ad groups, set a campaign budget | Claude shows the change and runs it after you approve in the chat | Free plan for 1 source and 30 days; paid from $19 a month for 3 sources |
| General automation MCP | Zapier MCP | None listed | Apply offline conversion; create a customer list; add or remove a contact | Set by your AI client | Each successful tool call uses two Zapier tasks |
| Self-hosted open source | bit-of-a-shambles/microsoft-ads-mcp-server | Accounts, campaigns, ad groups, keywords, ads, budgets, reports | Create campaigns (paused by default), ad groups, keywords and responsive search ads; change campaign status | None described in the README | Free (MIT), plus your developer token |
| Build your own | Claude Code writing a thin server on the Bing Ads API | Whatever you build | Whatever you build | Whatever you build | Your time |
Windsor.ai's Microsoft Ads guide, updated November 5, 2026, says its connector "cannot change keyword bids, keywords, ads or negative keywords". The open-source server's repository showed two commits on November 15, 2026, and its README describes no confirmation step before a write.
For B2B, the useful detail in Zapier's Microsoft Advertising actions is "Apply Offline Conversion", which is how a qualified opportunity in your CRM gets back to Microsoft's bidding. On the API, Microsoft's ApplyOfflineConversions takes up to 1,000 conversions per request matched on the Microsoft Click ID, and Microsoft says to wait two hours after creating the offline conversion goal before sending any. We cover the whole loop in offline conversion tracking.
Building your own needs a developer token, requested by a Super Admin in the Developer Portal, plus an OAuth token for a user. Microsoft's get started page makes the safety point for you: a developer token "does not grant additional permissions to any Microsoft Advertising accounts". The user role still sets the ceiling.
Pick the route by asking what the job needs to change
Most B2B jobs on a Microsoft Ads account are reads, so most teams should start with Microsoft's server and add a second route only for a named job that needs it.
- Reporting, audits and change watching: Microsoft's own server. It's free and can't break anything.
- Pausing campaigns or moving budget from a chat: a hosted connector that previews every write, used under a user role you chose on purpose. Read the guide on where humans stay in the loop on ad spend first.
- Sending pipeline stages back to Microsoft: an offline conversion route, through an automation service or the API.
- Spend by target company or job function: the professional demographics report, by export or through the API.
If you run the same setup across platforms, the Google, Meta and LinkedIn versions behave very differently. Google's developer page lists its server as "Read and partial mutate (asset creation, video uploads, and label management with propose-and-confirm validation, or configurable read-only mode)", and it cannot create, modify, pause or enable campaigns, ad groups, ads, budgets or bids; the page adds that it "cannot link assets to campaigns, ad groups, or asset groups". Its write tools can be switched off, but the Propose & Confirm step can't. Meta runs its own hosted ads MCP server, announced on April 29, 2026. LinkedIn's own MCP server, which reads and writes ad accounts, is in beta and already in use as of November 2026, but isn't publicly documented. Our Google Ads MCP and LinkedIn Ads MCP guides cover those setups.
The first month goes wrong in four predictable ways
Most early problems with a Microsoft Ads MCP come from how the tools return data and what the account measures.
- The answer has no numbers in it. Microsoft's tools page says performance metrics come back "only when a PerformanceDateRange is provided" for most tools. If the AI lists campaigns with no spend beside them, ask again with an explicit date range.
- The IDs are wrong. The test prompt needs the account ID and customer ID, and Microsoft warns not to confuse the account ID with the eight-character account number. Take them from the address bar, as in step 8.
- The change log is read as the whole story. Change history covers 180 days, older ranges are rejected rather than trimmed, and Microsoft notes that the "ChangedBy" field can be a user, an application or the system, so it isn't proof that a person made the change.
- Conversions are mistaken for pipeline. The server reports the conversions the account tracks, which in most B2B accounts means form fills. A report that says cost per lead fell hasn't said anything about opportunities until the CRM stages are beside it.
Who should wait: a team whose Microsoft Ads spend is too small to move pipeline either way, since a weekly AI read of a tiny account mostly reports noise, and any team hoping the official server will let an AI run the account. It won't, as of November 2026, and Microsoft's documentation gives no date for write tools.
Where to start
Create a Viewer user, connect Microsoft's server to Claude or ChatGPT, and ask for last week's spend by campaign with a date range, then reconcile it against the platform before you ask anything harder. When you want that read to run every week and reach pipeline, Scalewell helps decide which job the AI takes first and builds it into the stack you already have.
Frequently asked questions
Does the Microsoft Ads MCP server need a developer token?
Microsoft's own server doesn't need one. Its setup guide asks for an Entra app registration and a Microsoft sign-in, and never mentions a developer token. You need one only if you self-host an open-source server or build your own on the Bing Ads API, where a Super Admin requests it in the Developer Portal.
Can I connect with a personal Microsoft account instead of a work account?
A personal Microsoft account works. Microsoft's guide supports both work or school accounts and personal Microsoft accounts for the Microsoft Advertising sign-in, which is why the app registration uses the AzureADandPersonalMicrosoftAccount audience. Copilot Studio itself still needs a work or school account, but its Microsoft Advertising connection can use either type.
Can an agency query many client accounts through one connection?
One connection can cover many clients, within the user's access. GetAccounts lists every account the signed-in user can reach, and the other tools take a customer ID and an account ID per request. The AI reaches the same accounts that user can open in Microsoft Advertising, and nothing more.
Can the Microsoft Advertising MCP show how my ads perform inside Copilot?
It can't report them separately. Microsoft's help page says it does not currently support specific metrics for ads served in Copilot, so they stay blended into normal campaign totals. Any AI answer that claims a Copilot-only figure from this data has invented it.
Does the Microsoft Advertising MCP work with Microsoft 365 Copilot?
It works through Copilot Studio, where you build an agent, add a Model Context Protocol tool with Microsoft's server URL, set OAuth 2.0 with your app's client ID and a client secret, and register the redirect URL Copilot Studio generates. That's the route Microsoft names for Microsoft 365 Copilot on its product page.