How to Use the Microsoft Ads MCP in Windsurf

Q: How do I add the Microsoft Ads server to Windsurf?

Open your mcpconfig.json file and add the server definition under the mcpServers key. Alternatively, use the built-in MCP panel to refresh your connection.

Connect Microsoft Ads to Windsurf to let Cascade query your campaigns and budgets without leaving your editor.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Microsoft Ads MCP to Windsurf

Create your Vinkius account to connect Microsoft Ads to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Microsoft Ads with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Full Campaign Visibility in Windsurf

Cascade pulls your live account data directly into the chat context. It uses `list_ms_campaigns` and `get_ms_campaign_details` to show you exactly what's running across your entire account. You don't have to jump between browser tabs anymore. The MCP Server feeds your active campaign specs straight into the IDE, so Cascade can reason about your performance metrics immediately.

Autonomous Budget and Ad Analysis

Give Cascade a goal and it will chain `list_ms_budgets` with `get_ms_ad_group_details` to find where you're overspending. It maps out your current allocation without you needing to manually trigger each tool. Because it understands the relationship between these objects, the agent can correlate your spend with specific ad groups. It identifies the gaps in your strategy by reading the data from `list_ms_ad_groups` and `list_ms_ads` in one go.

Targeting and Keyword Deep Dives

Ask Windsurf to audit your reach and it fetches your settings using `list_ms_targeting_settings`. It looks at your current audience parameters to verify if your ads are actually hitting the intended demographic. When you need to refine your approach, it pulls your active terms via `list_ms_keywords`. Cascade analyzes these against your campaign performance to highlight which terms aren't pulling their weight.

Setup guide

Set up Microsoft Ads MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Microsoft Ads MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Microsoft Ads payment history." If connected, Cascade will call the Microsoft Ads tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "microsoft-ads-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Microsoft Ads now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Microsoft Ads MCP in Windsurf

Not directly. This MCP Server is read-only, meaning Windsurf can analyze your data but cannot push changes back to the platform.

Open your mcp_config.json file and add the server definition under the mcpServers key. Alternatively, use the built-in MCP panel to refresh your connection.

No. Your credentials stay local or with the Vinkius host. The server only receives an endpoint token to fetch your campaign data.

The server uses paginated responses to handle large accounts. Cascade will process the chunks it receives to maintain a manageable context window.

Your keyword data is handled via encrypted transport. It exists only within the ephemeral session provided by the Vinkius sandbox during your active chat.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript