microsoft-ads-mcp

What This Skill Does

The microsoft-ads-mcp skill provides an interface to manage Microsoft Advertising campaigns, including Bing and DuckDuckGo ads. It enables users to create, update, and monitor marketing assets such as campaigns, ad groups, keywords, and ads. By bridging OpenClaw with the Microsoft Advertising API, this skill allows for programmatic control over ad spend, targeting, and status updates, effectively automating manual dashboard tasks through simple natural language commands.

Installation

1. Ensure you have the mcporter CLI tool installed.
2. Clone the repository from https://github.com/Duartemartins/microsoft-ads-mcp-server.git.
3. Install the dependencies using pip install -r requirements.txt.
4. Register the server in your ~/.mcporter/mcporter.json file with your MICROSOFT_ADS_DEVELOPER_TOKEN and MICROSOFT_ADS_CLIENT_ID.
5. Run the authentication flow using mcporter call microsoft-ads.get_auth_url and complete it via mcporter call microsoft-ads.complete_auth.
6. Finally, execute clawhub install openclaw/skills/skills/duartemartins/microsoft-ads-mcp to integrate it into OpenClaw.

Use Cases

• Automated Scaling: Increase or decrease budgets based on performance data analyzed by other OpenClaw agents.
• Rapid Campaign Deployment: Quickly spin up new ad groups and keyword sets for seasonal promotions or A/B testing.
• Performance Reporting: Extract ad performance metrics programmatically to feed into external dashboards or reporting tools.
• Cross-Platform Syncing: Import existing Google Ads strategy structures into Microsoft Advertising to capture high-intent search traffic on Bing and DuckDuckGo.

Example Prompts

1. "Check the current performance of my 'Summer Sale' campaign and let me know if any ad groups have a high bounce rate."
2. "Create a new ad group called 'Eco-Friendly Widgets' in the 'General Marketing' campaign with a CPC bid of $1.75."
3. "Pause all ads in the 'Productivity Tools' group and create a new set of phrase-match keywords for the search term 'AI writing assistant'."

Tips & Limitations

• Safety First: The skill creates campaigns in a 'paused' state by default. Always verify your configuration before pushing to production to avoid unexpected ad spend.
• Authentication: The Microsoft Advertising API requires periodic re-authentication. Ensure your refresh tokens are handled correctly by the MCP server.
• Complexity: While the skill provides full control, managing complex bidding strategies manually via CLI can be prone to error; use specific budget constraints to keep costs in check.
• Targeting: This skill is best used for management; deep-dive audience targeting settings may still require the web interface for full configuration.