Microsoft Ads MCP. Pull campaign, budget, and keyword data directly into chat.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Microsoft Ads MCP Server connects your AI agent directly to Microsoft Advertising data. You can list all campaigns, get budget details, check ad group performance, and pull specific keyword lists without leaving your chat interface.
It's built for marketers who need programmatic access to campaign metrics.
What your AI agents can do
Get ms account info
Retrieves basic profile and administrative details for your connected Microsoft Ads account.
Get ms ad group details
Gets specific performance metrics, settings, and data for a single ad group within a campaign.
Get ms campaign details
Retrieves comprehensive details about a chosen advertising campaign, including its objective and status.
Retrieves fundamental details about your connected Microsoft Ads account.
Lists and searches for all active ad campaigns, or pulls specific performance metrics from a selected campaign.
Fetches granular details about individual ad groups and lists the keywords contained within them.
Lists all shared budget accounts to track spending limits across multiple campaigns.
Retrieves the actual ads running within an ad group, along with specific targeting parameters for a campaign.
Ask AI about this MCP
Supported MCP Clients
Gemini Microsoft Ads MCP Server: 10 Tools for Ad Campaigns
These tools let your AI client interact with core Microsoft Advertising functions—from listing campaigns to retrieving specific keyword lists.
019d75d4get ms account info
Retrieves basic profile and administrative details for your connected Microsoft Ads account.
019d75d4get ms ad group details
Gets specific performance metrics, settings, and data for a single ad group within a campaign.
019d75d4get ms campaign details
Retrieves comprehensive details about a chosen advertising campaign, including its objective and status.
019d75d4list ms ad groups
Lists all available ad groups that exist within a specific campaign structure.
019d75d4list ms ads
Retrieves the text, image, and status details for every ad running inside an ad group.
019d75d4list ms budgets
Generates a list of all shared budget containers tied to your account.
019d75d4list ms campaigns
Lists every campaign available in your entire Microsoft Ads account structure.
019d75d4list ms keywords
Pulls a complete list of keywords and their associated performance data for an ad group.
019d75d4list ms targeting settings
Lists all the geographical or demographic targeting rules applied to a specific campaign.
019d75d4search ms campaigns
Quickly filters and finds campaigns using partial names or keywords instead of listing everything.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Microsoft Ads, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
Look, this Microsoft Ads MCP Server connects your AI agent straight into your advertising data. You don't gotta click through a dozen tabs or wrestle with clunky reports; your agent just calls the right tool and gives you the raw numbers you need. It's built for marketers who live in campaign metrics.
Getting Started: Account Overview & Campaigns
You can use get_ms_account_info to grab fundamental details about the connected Microsoft Ads account. Need to find a specific ad campaign? You've got two ways: run list_ms_campaigns to see every single campaign you got running, or if you know part of the name, use search_ms_campaigns to filter it down fast.
Once you pick a campaign, get_ms_campaign_details pulls all its deep info—its objective and what status it's in.
Deep Dive: Ad Groups, Keywords, and Ads
After selecting a campaign, you gotta know what's inside. Run list_ms_ad_groups to see every ad group linked to that campaign structure. For granular performance metrics on just one section, use get_ms_ad_group_details. You can then run list_ms_keywords against an ad group to pull a complete list of keywords and the specific performance data tied to each one.
To check what actual copy is running, list_ms_ads retrieves all the text, image, and status details for every single ad inside that ad group. You can also check which geo or demographic rules apply by calling list_ms_targeting_settings against a campaign.
Budgeting & Management
To keep tabs on spending, use list_ms_budgets to generate a list of all shared budget containers across your whole account. This lets you track limits without digging through every single campaign's settings.
How Microsoft Ads MCP Works
- 1 Your AI client sends a natural language request (e.g., 'What's the budget status in Campaign Alpha?').
- 2 The MCP Server identifies the necessary function (
list_ms_budgets) and executes the call using your account credentials. - 3 The server returns structured data, which your agent then formats into a clear, readable summary for you.
The bottom line is that it turns complex API calls—like checking ad group details or listing keywords—into simple chat commands.
Who Is Microsoft Ads MCP For?
This tool is built for the Digital Marketing Manager, the PPC Specialist, and the Data Analyst. If you spend your day switching between the Microsoft Ads console, a spreadsheet, and Slack to pull metrics—you need this. It cuts out the context switching.
Uses get_ms_ad_group_details to quickly compare performance across different ad groups without manually downloading reports.
Runs list_ms_campaigns followed by list_ms_budgets to get a high-level view of spending limits and campaign status for quarterly reporting.
Uses the server to query specific data points, like finding all keywords in an ad group that haven't been viewed recently, saving hours of manual filtering.
What Changes When You Connect
- Checks your spending limits instantly. Instead of navigating to the billing tab to run
list_ms_budgets, you just ask your agent for 'shared budgets' and get a clean list. - Goes deep on performance metrics. Need to know exactly what's running? Use
get_ms_ad_group_detailsto pull all ad group stats without leaving the chat window. - Saves time listing content. Instead of clicking through, use
list_ms_keywordsand specify the ad group ID; you get a clean list of every keyword in seconds. - Finds what you need faster. Forget scrolling through 50 campaigns—use
search_ms_campaignsto filter by name or partial text immediately. - Builds better reports. By combining
list_ms_adswithget_ms_ad_group_details, your agent can pull all creative assets and associated metrics in one go.
Real-World Use Cases
Investigating a Budget Overrun
The analyst notices spending spiked. They ask their agent, 'What are the current budgets?' The agent calls list_ms_budgets and identifies that Campaign Gamma's budget is maxed out, saving an emergency manual check.
Auditing Campaign Structure
The manager wants to see everything. They prompt the agent to 'List all campaigns in the last quarter.' The server runs list_ms_campaigns, followed by calling list_ms_ad_groups for each one, giving them a complete structural map.
Optimizing Keyword Performance
A user suspects poor keyword performance. They tell the agent to check 'keywords in Ad Group Beta.' The agent runs list_ms_keywords, pulls the list, and highlights any keywords with a high click rate but low conversions.
Reviewing Targeting Rules
Before launching an ad, the specialist needs to confirm geo-restrictions. They ask the agent for 'targeting settings on Campaign Delta.' The server uses list_ms_targeting_settings and returns a bulleted list of active rules.
The Tradeoffs
Manually checking budgets
Logging into the Microsoft Ads console, navigating to 'Billing,' filtering by date range, then exporting an XLSX file just to see if you're close to hitting your cap.
→
Just ask your agent. Prompt: 'What are the shared budgets and how much is left?' The server runs list_ms_budgets and gives you a direct answer in chat.
Listing everything, then filtering
Using the main campaign list view to find Campaign Zeta, scrolling through dozens of results until you spot the right name—a huge waste of time.
→
Use search_ms_campaigns instead. Prompt: 'Search for campaigns containing 'Q4 Retargeting'.' It filters immediately.
Missing ad group details
Pulling a list of keywords (list_ms_keywords) but not seeing which specific campaign or ad group they belong to, making the data useless.
→
Always start by getting context. First run get_ms_campaign_details, then use list_ms_ad_groups to get the parent container ID before running any list tools.
When It Fits, When It Doesn't
Use this server if your primary need is structured data retrieval from Microsoft Ads—specifically, listing groups of related items (Campaigns -> Ad Groups -> Keywords). You should use it when you need to answer 'What is the status of X?' or 'Give me a list of Y.' Don't use it if you just want general marketing advice; your agent can write that. Also, don't rely on it for historical data older than what the API exposes (check documentation). If your core task involves running complex creative copy generation or interpreting market trends outside of ad performance metrics, look into specialized AI tools instead.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Microsoft Ads. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 10 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Navigating Ad Campaigns shouldn't require 15 clicks.
Today, checking campaign status is a multi-step process. You have to log in, select the correct account, find the main dashboard tab, filter by date range, drill down into specific ad groups, and then click another tab just for budget details—all before you even get the numbers.
With this MCP server, your agent handles it all. Instead of clicks, you use a simple prompt like 'Show me Campaign Delta's current status.' You get the detailed metrics immediately, structured cleanly in chat.
Microsoft Ads MCP Server: Get campaign, budget & keyword data.
The manual steps that disappear are navigating to the billing tab just for `list_ms_budgets`, and then having to manually cross-reference those budgets with ad groups found via `get_ms_ad_group_details`. It's tedious data stitching.
Now, your agent connects all these pieces. You get a single, cohesive answer that combines budget status, campaign scope, and granular performance metrics without you lifting a finger.
Common Questions About Microsoft Ads MCP
How do I list all my campaigns using list_ms_campaigns? +
You ask your agent to 'List all campaigns.' The server runs list_ms_campaigns and gives you a full roster of every campaign name, ID, and primary status.
Can I get details for just one ad group with get_ms_ad_group_details? +
Yes. You provide the specific Ad Group ID, and the server uses get_ms_ad_group_details to return metrics like impressions, clicks, and CTR for that single unit.
What is list_ms_keywords used for? +
It pulls a complete inventory of keywords associated with an ad group. This lets you audit performance by seeing every keyword in one structured output.
Do I need to use search_ms_campaigns if list_ms_campaigns works? +
Use search_ms_campaigns when you know part of the name or keywords. If you just want a complete, unfiltered list, stick with list_ms_campaigns.
If I need to confirm access details, how does the `get_ms_account_info` tool verify my Microsoft Ads credentials? +
It pulls basic account metadata. The agent confirms you have connected an authorized billing profile and lists key organizational identifiers for verification.
When I run `list_ms_ads`, what specific content details can my AI agent read about each ad? +
The tool retrieves the ad copy, headline, description, and current status. It's useful for reviewing creative assets across an entire ad group.
What information does the `list_ms_targeting_settings` tool retrieve for a campaign's target audience? +
It lists all active targeting parameters associated with a specific campaign. You can see which demographics, locations, or devices are currently included in the reach.
Using `list_ms_budgets`, how do I understand the scope of shared budget data? +
It lists all shared budgets available to the connected account. This function helps you see potential cost caps across multiple departments or internal teams.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
HubSpot Sales Hub
Manage deals, pipelines, products, quotes, and meetings in your HubSpot Sales Hub through natural conversation.
Wistia
Manage videos, projects, and performance analytics on Wistia with AI agents.
Box
Manage files, folders, collaborations, and metadata on Box — the enterprise cloud content management platform.
You might also like
AT&T Messaging
CPaaS Messaging -- Send SMS/MMS, manage shortcodes, track delivery status, and run bulk campaigns via AT&T Messaging API.
JotForm
Manage forms, submissions, and reports via JotForm API.
Hubstaff
Analyze timesheets, query organizational lists, and manage team activities via Hubstaff seamlessly from any AI agent.