AI Client · Windsurf Ad Platform · Google Ads 39 tools

Run Google Ads from Windsurf

Manage Google Ads campaigns inside Windsurf (IDE) — 39 tools, OAuth setup in about 5 minutes, no dashboard switching.

15 tool calls / month free · No credit card · Setup in ~2 minutes

Adspirer is the MCP server that connects Windsurf (IDE) to your Google Ads ad accounts, turning campaign management into a chat conversation. Codeium Windsurf — IDE with native MCP support. On the platform side, 39 tools cover google Search, Performance Max, Display, YouTube, Shopping. Adspirer reads and writes — pull performance reports, audit launch search & pmax campaigns, launch new campaigns, pause underperformers, and reallocate budget — all from chat. New campaigns are always created paused so you can review before they go live, Adspirer cannot delete existing campaigns by design, and the free tier (15 tool calls / month, no credit card) is enough to run a full audit before you pay. Setup takes about 5 minutes via a JSON config entry.

What you can do

39 tools across Google Ads. The eight you'll use most:

Launch Search & PMax campaigns

Build Google Search and Performance Max campaigns from a brief — Adspirer runs keyword research, drafts copy, validates assets, and creates the campaign **paused** so you review before going live.

Research keywords with real CPC

Pull live data from Google Keyword Planner via `research_keywords` — search volume, CPC estimates, and competition level for any seed keyword or business description.

Find wasted spend

Run `analyze_wasted_spend` to surface keywords that have spent your threshold (e.g., $50+) with zero conversions, then pause them or push them to negatives in one prompt.

Audit search terms

Use `analyze_search_terms` to see the actual queries that triggered your ads. The `raw_report` mode returns the literal search strings — perfect for finding negative-keyword opportunities.

Generate ad copy in-spec

`suggest_ad_content` writes headlines (≤30 chars) and descriptions (≤90 chars) that fit Google's exact limits, so RSAs never get rejected for length.

Pause & resume campaigns

Pause campaigns, ad groups, or keywords by name from chat — and resume them later. Adspirer **cannot delete** existing campaigns by design (hard-coded safety).

Tune PMax targeting

Add or remove search themes (up to 50 per asset group) and audience signals (in-market, affinity, custom, user lists) on existing PMax campaigns — without rebuilding from scratch.

Reallocate budget by ROAS

`optimize_budget_allocation` recommends shifts toward your best-ROAS campaigns. Adspirer never raises an existing campaign budget without your explicit confirmation.

Campaign types you can launch

Every Google Ads format Adspirer supports — request one in chat and Windsurf builds the campaign paused for review.

Search campaigns

Text ads on Google Search results. Highest-intent traffic — people actively searching for your keywords.

Performance Max

AI-driven campaigns running across Search, Display, YouTube, Gmail, Maps, and Discover from one asset group.

Display campaigns

Responsive Display Ads across 2M+ sites and apps. Full control over audiences, topics, placements, and keywords.

YouTube campaigns

Video ads on YouTube In-Feed, In-Stream, and Shorts via the Demand Gen format with YouTube-only channel controls.

Shopping campaigns

Product-feed-driven ads with images, prices, and merchant info — built for e-commerce catalogs.

Demand Gen

Visual, social-style ads across YouTube, Discover, and Gmail — designed to drive demand earlier in the funnel.

Sample prompts

Same as Cursor — useful for engineering teams that ship features and ads from one editor.

Google Ads performance audit — Monthly audit that surfaces underperformers and points you at the quick wins.

Google Ads performance audit

Pull my Google Ads performance for the last 30 days. Show spend, conversions, CPA, and ROAS by campaign. Highlight any campaigns with ROAS below 2.0 and tell me which to pause first.

Keyword research with CPC — Real Keyword Planner data with go/no-go recommendations against your CPA target.

Keyword research with CPC

Research keywords for emergency plumbing services in Chicago. Show me search volume, CPC estimates, and competition level. Suggest which keywords to target and which to avoid given a $25 CPA target.

Find wasted spend — Pinpoints non-converting keywords and routes them to pause or negatives.

Find wasted spend

Analyze my Google Ads for wasted spend over the last 30 days. Find keywords that have spent more than $50 with zero conversions. Recommend which to pause and which to add as negative keywords.

Launch a Search campaign — End-to-end Search campaign creation with keyword research and in-spec copy.

Launch a Search campaign

Create a Google Search campaign: - Business: Online pet supply store - Target keywords: organic dog food, natural dog treats, premium pet food - Location: United States - Budget: $40/day - Objective: Website conversions (purchases) Research the keywords first, generate ad copy that fits Google's character limits, then build the campaign — keep it paused.

Tune a PMax campaign — Adjust PMax targeting on a live campaign without rebuilding it.

Tune a PMax campaign

Show me the current search themes and audience signals on my "Adspirer-pmax-03" Performance Max campaign. Add new search themes for: AI ad management, automated advertising, MCP tools for ads. Then search for in-market audiences related to "advertising software" and add the best fit as an audience signal.

Diagnose a CPA spike — Anomaly diagnosis that explains why CPA moved, not just that it did.

Diagnose a CPA spike

My CPA on the "Adspirer-pmax-03" campaign jumped 60% in the last 7 days. Diagnose what changed — search terms, audience signals, asset rotation — and tell me what to fix.

Who this is for

Real workflows from people running Google Ads through Windsurf.

In-house growth marketer running Google Ads solo

Each Monday, ask Windsurf to pull last week's Google Ads performance, surface campaigns running below your ROAS threshold, and recommend creative refreshes for fatigued ads.

Outcome: Replaces a 60–90 minute manual review with a 5-minute chat, and surfaces problems before they tank ad-set performance.

Agency account manager handling 5+ Google Ads accounts

Switch context between client accounts in chat. Run the same audit prompt across each, paste the chat into your weekly client report. Multi-account is built in — no extra seats per account.

Outcome: Cuts cross-account reporting from a half-day per account to ~10 minutes total.

Founder launching their first Google Ads campaign

Brief Windsurf in plain English with budget, audience, and creative URL. Windsurf validates inputs against Google Ads's requirements, builds the campaign paused, and walks you through what to review before launching.

Outcome: No need to learn Google Ads's dashboard UI; campaign goes live correctly the first time.

Adspirer vs alternatives

For running Google Ads from Windsurf.

Capability	Adspirer (this page)	DIY MCP server	Legacy SaaS dashboard
Setup time	~5 minutes via a JSON config entry	2–4 hours building MCP server	30–60 min onboarding + sales call
Cost — entry tier	Free (15 calls / mo)	Hosting + maintenance	$200–500 / mo minimum
Works inside Windsurf	Yes — a JSON config entry	Yes (if you build it correctly)	No — external dashboard only
Multi-account	Yes — switch in chat	Manual per-account auth	Yes — but each account billed
Read + Write	Full read + write (create / pause / update)	Whatever you build	Mostly read-only or seat-gated writes
Safety: cannot delete	Hard-coded — no delete tool	Up to you	Varies
Pricing transparency	Public — $0 / $49 / $99 / $199	Self-hosted	Often quote-only

Pricing

Start free. Upgrade if you outgrow it.

Free Forever

15 / mo

All platforms. ChatGPT & Claude access. No credit card.

Start free →

Plus

Recommended

$49 / mo

150 / mo

Performance analysis + standard campaigns.

Compare Plus →

Pro

$99 / mo

600 / mo

AI optimization, bulk ops, deeper diagnostics.

Compare Pro →

Max

$199 / mo

3,000 / mo

Priority support (24h SLA), custom integrations.

Compare Max →

How it works

From sign-up to your first launched campaign in three steps.

Connect

Paste the Adspirer MCP URL into Windsurf, complete OAuth in your browser, and link your Google Ads account. About 2 minutes.

Manage

Ask Windsurf for an audit, launch a new campaign, pause underperformers, or pull a report. Adspirer handles the 39 Google Ads tools behind the scenes.

Scale

Switch between accounts in chat, run the same audit across clients, and let agency SOPs live in your AI assistant — no extra dashboard logins.

Frequently asked questions

About running Google Ads from Windsurf.

Do I need a developer to set this up?

You'll edit a small JSON config entry to register the Adspirer MCP server (https://mcp.adspirer.com/mcp, transport http, OAuth). If you can edit a settings file in a code editor, you can do this. Total time: about 5 minutes.

Can I switch from Windsurf to a different AI client later?

Yes. Your Adspirer account is independent of the AI client — sign up once, then connect the same MCP URL from ChatGPT, Claude, Cursor, Codex, Windsurf, or any supported client. Tool calls are pooled across clients on the same plan; switching costs you nothing.

What's the read vs. write boundary on Google Ads?

Adspirer is full read and write. It can pull reports, audit performance, and analyze data (read), and it can launch new campaigns, pause underperformers, update budgets, and adjust targeting (write). Two safety guardrails are hard-coded: new campaigns are always created paused so you review before they go live, and Adspirer cannot delete existing campaigns. You keep full control.

Does Adspirer generate images or videos for Google Ads?

No. Adspirer generates ad copy (headlines and descriptions) via suggest_ad_content, but it does not create images or videos. For PMax, you provide image and video URLs from Google Drive, Dropbox, S3, or any public link, and validate_and_prepare_assets checks them against Google's spec before launch.

Can Adspirer delete or modify my existing campaigns?

Adspirer cannot delete campaigns, ad groups, or keywords — hard-coded safety. It can pause and resume them when you ask, and update budgets, bids, or targeting on your instruction. New campaigns are always created paused so you review before they spend a cent.

What's the minimum budget for Google Ads campaigns?

Search campaigns work from $10/day (Google's practical minimum), but $30+/day is recommended for meaningful data. Performance Max needs at least $20/day because it has to test across multiple channels. Adspirer suggests $40/day split across 3-5 ad groups for new Search campaigns.

How does the campaign-creation workflow work?

Search campaigns require a 6-step sequence: verify connection → research_keywords → discover_existing_assets → suggest_ad_content → validate_and_prepare_assets → create_search_campaign. PMax adds asset upload guidance plus optional add_pmax_search_themes and add_pmax_audience_signal. Skipping steps causes Google's API to reject the campaign — Adspirer enforces the order.

Can I manage multiple Google Ads accounts (MCC) from one chat?

Yes. Connect each ad account through OAuth and Adspirer keeps them separate. Use get_connections_status to list connected accounts and reference them by customer ID or name in your prompts. Adspirer's own workspace, for example, has both Adspirer (9120801776) and Sahaayak Inc (1187072345) connected side-by-side.

How are conversions and search terms surfaced?

Use get_campaign_performance for spend / conversions / CPA / ROAS by campaign, and analyze_search_terms to see the actual queries that triggered your ads. The raw_report mode returns the literal search-term strings — feed those into add_negative_keywords to block wasteful traffic in the next prompt.

Connect Windsurf to Adspirer

For technical readers — the exact steps. Most users finish this in about 2 minutes. Required: Windsurf Pro.

Add Adspirer to Windsurf MCP config

In Windsurf settings, add an MCP server with URL https://mcp.adspirer.com/mcp and OAuth authentication.

Related integrations

Same Windsurf, different platform — or same Google Ads, different AI client.

Windsurf × other platforms

Google Ads × other AI clients

Go deeper

Windsurf setup docs

Full reference for Windsurf — every option, every edge case.

Open docs →

Google Ads reference

All 39 tools with parameters, return shapes, and examples.

Open docs →

Ready to connect Windsurf to Google Ads?

Start free — 15 tool calls per month, no credit card. Setup takes about 2 minutes.

Try Adspirer free

Last updated April 28, 2026.