Microsoft Ads MCP Server for Openclaw

A professional-grade MCP server for programmatically managing Microsoft Advertising campaigns, ad groups, and performance reporting.

duartemartins
v1.0.0
Jan 27, 2026
3
3.3k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install microsoft-ads-mcp

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install microsoft-ads-mcp using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Microsoft Ads MCP Server?

The Microsoft Ads MCP Server is a robust tool designed to interface with the Microsoft Advertising API through the Model Context Protocol. As part of the Openclaw Skills ecosystem, it empowers developers to create, manage, and optimize search engine marketing campaigns on the Microsoft Search Network, including Bing, Yahoo, AOL, and DuckDuckGo.

This skill bridges the gap between manual dashboard management and automated, programmatic ad operations. It allows for the seamless handling of high-volume ad accounts while providing lower CPC opportunities and reaching unique, privacy-conscious audiences on platforms like DuckDuckGo. By utilizing this server, teams can integrate advertising workflows directly into their AI-driven development or marketing automation stacks.

Microsoft Ads MCP Server Use Cases

  • Automating the creation of search campaigns on Bing and DuckDuckGo to reach specialized audiences.
  • Streamlining the migration of high-performing keywords and ad copy from Google Ads to Microsoft Advertising.
  • Scaling ad group management and keyword bidding strategies across multiple accounts using CLI tools.
  • Generating and downloading detailed performance reports to feed into custom data analytics pipelines.
  • Managing Responsive Search Ads (RSAs) programmatically to test headlines and descriptions at scale.

How Microsoft Ads MCP Server Works

  1. The server connects to the Microsoft Advertising API using a Developer Token and Azure AD Client ID.
  2. Users initiate an OAuth authentication flow to securely link their Microsoft Ads account to the skill.
  3. Commands are issued via the MCP interface to define campaign structures, budgets, and targeting parameters.
  4. The server processes these requests to create or update entities like ad groups, keywords, and creative assets.
  5. Integrated reporting tools allow users to submit report requests and poll for completion to retrieve performance metrics like CTR, Spend, and Conversions.

Microsoft Ads MCP Server Setup

Follow these steps to integrate this skill into your workflow:

  1. Installation:
git clone https://github.com/Duartemartins/microsoft-ads-mcp-server.git
cd microsoft-ads-mcp-server
pip install -r requirements.txt
  1. Configuration: Add the following to your ~/.mcporter/mcporter.json file:
{
  "mcpServers": {
    "microsoft-ads": {
      "command": "python3",
      "args": ["/path/to/microsoft-ads-mcp-server/server.py"],
      "type": "stdio",
      "env": {
        "MICROSOFT_ADS_DEVELOPER_TOKEN": "your_token",
        "MICROSOFT_ADS_CLIENT_ID": "your_azure_app_client_id"
      }
    }
  }
}
  1. Authentication: Execute the auth commands through your MCP client:
mcporter call microsoft-ads.get_auth_url
# Sign in and copy the redirect URL
mcporter call microsoft-ads.complete_auth '{"redirect_url": "YOUR_REDIRECT_URL"}'

Microsoft Ads MCP Server Data Schema & Taxonomy

The skill organizes advertising data into a hierarchical structure compatible with standard marketing taxonomy:

Level Key Attributes Purpose
Account AccountID, Name High-level container for all campaigns
Campaign Name, Daily Budget, Status Controls overall spending and targeting
Ad Group Name, CPC Bid, CampaignID Categorizes keywords and ads into themes
Keyword Text, Match Type, Bid Defines the search queries that trigger ads
Ad (RSA) Headlines, Descriptions, Final URL The creative assets shown to users
Report Impressions, Clicks, Spend, CTR Performance metrics for optimization

Microsoft Ads MCP Server Advanced Features

  • Support for Responsive Search Ads (RSA) allowing up to 15 headlines and 4 descriptions for dynamic optimization.
  • Automated report polling system for Campaign, Keyword, Search Query, and Geographic performance data.
  • Comprehensive match type support including Broad, Phrase, and Exact match keyword syntax.
  • Safety-first campaign logic that creates new campaigns in a 'Paused' state to ensure manual verification.
  • Multi-account search functionality for managing complex organizational structures within Openclaw Skills.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*