Microsoft Ads MCP connector

The Microsoft Ads connector lets AI agents report on and manage Microsoft Advertising accounts through InsightfulPipe's hosted MCP server at https://microsoft-ads.insightfulmcp.com/. It covers performance reports, campaigns, ad groups, ads, keywords, extensions, audiences, budgets, bid strategies, UET tags, conversion goals and experiments.

Microsoft Ads MCP server reference

Endpoint: https://microsoft-ads.insightfulmcp.com/
Server name: microsoft-ads-mcp
Actions: 92 (35 read, 57 write). Workspace owners, admins and operators choose which actions each connected account exposes, and destructive actions are off by default.

Add it from a terminal, sign in to InsightfulPipe in the browser window that opens if asked, and click Authorize access:

claude mcp add --transport http microsoft-ads-mcp https://microsoft-ads.insightfulmcp.com/
gemini mcp add --transport http microsoft-ads-mcp https://microsoft-ads.insightfulmcp.com/
codex mcp add microsoft-ads-mcp --url https://microsoft-ads.insightfulmcp.com/

What agents can do

Reports: account, campaign, ad group, ad, keyword, search query, geographic, user location, age and gender, audience, and goals and funnels reports. Reports are submitted, then collected with poll_report_status.
Campaign structure: add, update and read campaigns, ad groups, ads, asset groups, keywords and negative keywords, plus labels and shared lists.
Extensions and targeting: manage ad extensions, campaign and ad group criteria, and negative sites.
Budgets and bidding: manage budgets, bid strategies, seasonality adjustments and data exclusions.
Audiences and measurement: manage audiences and audience groups, apply customer lists, create UET tags, conversion goals and value rules, and upload offline conversions.
Experiments: create and update experiments.

Before you connect

A Microsoft Advertising login with access to the accounts.

Connect Microsoft Ads

In the InsightfulPipe app, open Connectors, choose Microsoft Ads and click Connect.
Choose Read Only or Read + Write.
Sign in and approve access.
Select the accounts to connect.
Add the MCP server to Claude, ChatGPT or another client, then sign in to InsightfulPipe if asked and click Authorize access.

Permissions and safety

Management actions need Read + Write.
Add and update actions change live campaigns, so confirm changes before running them.
delete_keywords is the only destructive action, and it stays off until an owner, admin or operator enables it in Configure actions for this account.

Limits

There is no LinkedIn profile (company, industry or job function) report.
Reports run asynchronously, so large date ranges take longer to return.

Example prompts

"Using Microsoft Ads, show clicks, cost and conversions by campaign for last month."
"List search queries with more than 20 clicks and no conversions in the last 30 days."
"Run an age and gender report for the Brand campaign this quarter."
"Add these negative keywords to the Generic campaign."

Troubleshooting

An account is missing: check that your Microsoft Advertising login can access it, then reconnect and select it.
A report is still pending: ask the agent to poll the report status again.
"This account is connected read-only, so this action cannot be enabled for it." Reconnect with Read + Write.