Run Google Ads from Cursor

Manage Search, Performance Max, Display, and YouTube campaigns from your IDE — 39 Google Ads tools, real CPC data, ad ops alongside product code.

Try free View Google Ads docs

39 Google Ads tools, all in Cursor
Paused-by-default. Cannot delete campaigns.
OAuth setup in ~2 minutes

See it in action

In Cursor

› 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.

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

Overview

Adspirer is the MCP server that connects Cursor (the AI-native IDE) to your Google Ads accounts. Run the one-line installer (`bash <(curl -fsSL https://raw.githubusercontent.com/amekala/ads-mcp/main/plugins/cursor/adspirer/install.sh)`), authenticate via Cursor Settings → MCP, and Cursor's Agent mode can run all 39 Google Ads tools alongside your codebase — keyword research with real CPC data, Search and Performance Max creation, wasted-spend audits, search-term analysis, negative-keyword management, and PMax search themes + audience signals. Cursor Rules enforce the right workflow automatically (one vague prompt becomes a complete validated sequence: connection check → keyword research → asset discovery → validation → paused launch). Marketing engineers, founders, and PMs running ad ops alongside product code never leave the IDE. New campaigns create paused; Adspirer cannot delete campaigns. Free tier: 15 calls / month.

Safety guarantees

New campaigns always created paused for review
Adspirer cannot delete existing campaigns
Budget changes need explicit confirmation
OAuth 2.1 + PKCE — passwords never seen

How it works

Cursor

You ask in chat

prompt

Adspirer

39 tools, paused-by-default

tool calls

Google Ads

Live data, paused for review

Step 01

Connect

Paste the MCP URL into Cursor, OAuth into Google Ads.

Step 02

Manage

Ask in chat. Adspirer routes through 39 Google Ads tools.

Step 03

Scale

Switch accounts in chat. Same audits across every client.

What you can do

39 tools across Google Ads. The ones 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

Every Google Ads format Adspirer supports — request one in chat.

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.

More prompts to try

Cursor blends prose prompts with inline code — great when you're scripting ad ops alongside product code.

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

Cursor sits open all day for product work. In Agent mode, ask: "research Google keywords for {feature} launch, real CPC data, group by intent — then build a Search campaign at $60/day, paused." Cursor Rules force keyword research → asset validation → paused creation in order; the campaign brief lives in the repo as markdown.

Launch briefs become version-controlled artifacts. The next campaign is a copy-paste edit instead of a fresh UI walkthrough.

Compare & decide

Adspirer vs alternatives

For running Google Ads from Cursor.

	Adspirer	DIY MCP server	Legacy SaaS dashboard
Install	One-line installer + auth in Cursor Settings → MCP	Build MCP server, write IDE plugin	No IDE integration
Cost — entry tier	Free (15 calls / mo)	Hosting + maintenance	$200-500 / mo minimum
Real CPC keyword data	Yes — Google Keyword Planner via `research_keywords`	Build Keyword Planner integration	Often blended estimates
Workflow rules	Cursor Rule enforces research → validate → paused launch	Manual	Vendor-defined
Composer multi-file output	Yes — write reports + briefs to repo	Manual	No
Brand workspace	`/adspirer-setup` → BRAND.md	Manual	No equivalent
Write capability	Search + PMax + Display, paused on create	Whatever you build	Mostly read-only
Safety: cannot delete	Hard-coded — no delete tool	Up to you	Varies

Pricing

Start free. Upgrade if you outgrow it.

Free Forever

15 / mo

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

Start free →

Best for Cursor

Plus

$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 →

Configure

Required: Cursor Pro (recommended). Most users finish in about two minutes.

Show setup steps for Cursor

Add Adspirer to Cursor MCP config

In Cursor → Settings → MCP, add a new server with URL https://mcp.adspirer.com/mcp and transport http.

Authenticate

OAuth flow opens in your browser. Sign in to Adspirer.

Use it

In any Cursor chat, ask Adspirer to run an audit, build a campaign, or pull a report.

FAQ

Capabilities

I run product code AND Google Ads from Cursor. Will the contexts collide?

No. Adspirer's MCP tools live alongside your code tools — Cursor decides which to call based on the prompt. Asking "research keywords for {feature}" calls Adspirer; asking "refactor this component" calls your code tools. The brand-workspace BRAND.md keeps marketing context separate from README.md / code context.

What's the difference between Cursor Rules and the Adspirer skills?

Skills teach Cursor *how* to use the Google Ads tools (the right sequence: research → validate → create paused). Rules enforce *when* — e.g., "before calling create_search_campaign, always run research_keywords and validate_and_prepare_assets first." Skills make Cursor capable; Rules keep it disciplined. The one-command installer ships both.

Do I have to be in Agent mode? Will Ask or Edit mode work?

Use Agent mode. Ask and Edit modes can't call MCP tools that change state — they're scoped to question-answering and inline edits respectively. For Google Ads research, audits, and campaign creation, switch to Agent mode (Cursor v2.4+) and the Adspirer tools become available.

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 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.

Workflows

Can Composer actually write campaign briefs and reports to my repo?

Yes. Cursor Composer (multi-file editing mode) has full access to Adspirer tools — ask it to "pull last 30 days, write a wasted-spend audit to reports/google.md, write the negatives list to negatives.csv." Composer creates both files in the same flow. They commit like any other code artifact, which means your performance reports get version control and PR review for free.

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.

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.

Safety & control

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.

Power user

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.