Run Google Ads from Cursor

Valkiria reads the Google Ads account you connected over Google OAuth and gives the assistant campaigns, dated spend and conversions, the standing audit findings and the care recommendations. Cursor reads the Valkiria server from a config file and authenticates with a developer API key in a header. The key carries the scopes you gave it, so you decide up front whether the editor can only read or also propose.

Checked:

01

Connect Cursor in 3 steps

  1. In Valkiria create a developer API key with the scopes you need.
  2. Add the server to .cursor/mcp.json as shown below, replacing vk_live_… with your key.
  3. Restart Cursor and tell the assistant: "Get started with Valkiria".
  • This recipe uses a header instead of a sign-in, so it needs a developer API key. Developer API keys are part of the plans that include API access; the pricing page shows which.
  • Keep the key out of version control: put .cursor/mcp.json in .gitignore or use a user-level config.
.cursor/mcp.json
{
  "mcpServers": {
    "valkiria": {
      "url": "https://valkiria.pro/mcp",
      "headers": { "Authorization": "Bearer vk_live_…" }
    }
  }
}

02

What works for Google Ads today

Connection: Google OAuth. One authorisation covers Google Ads and Merchant Center; manager accounts (MCC) are supported.

The assistant can read

  • Campaigns with status and budgets, including Search, Performance Max and Shopping.
  • Dated spend, clicks and conversions per currency for an explicit date range, with the time of the last sync.
  • Open findings of the standing campaign audit, by severity, and the review of a single campaign.
  • Care recommendations for a campaign, with a preview of what each one would change.
  • Live from Google: one campaign as a tree of ad groups, ads and keywords; keywords with quality score; the search terms report; negative keywords; ad extensions; Performance Max asset groups with their search themes.
  • Search terms and keywords that spent money without a recorded conversion, impression share and the account change history.

The assistant can propose or request

  • Propose keywords and negative keywords to add or remove, a keyword update, and Performance Max search themes.
  • Propose a campaign budget, a bid strategy, targeting, extensions, a new ad group or a responsive search ad, and a status change for several items at once.
  • Approve or reject a care recommendation. Before it is queued, the change can be checked by Google itself in validate-only mode.
  • Request a pause or a resume of a campaign.
  • Create a campaign draft inside Valkiria. A campaign that later reaches Google is created PAUSED.
  • Create and update automation rules.
  • Create a monitor that checks the account on a schedule and notifies you or queues a proposal, and schedule a report by email. Neither changes an ad account by itself.

Live integration statusGoogle Ads in Valkiria

03

Prompts to try: Google Ads in Cursor

Copy one, replace the parts in brackets and send it. The assistant picks the tools itself.

  1. Which Search campaigns spent the most in the last 30 days without a single conversion? Show spend in the account currency.

  2. Compare my Performance Max and Search campaigns for the last 14 days: spend, clicks, conversions and cost per conversion.

  3. List the open audit findings for my Google Ads account, blocking ones first, and explain each one in plain language.

  4. Show the care recommendations for my Shopping campaign and what each would change before I decide.

  5. Pull dated Google Ads facts for the last 90 days and write them to reports/google-ads-90d.csv, one row per campaign per day.

  6. Compare this week's Google Ads audit findings with findings/last-week.json in this repo, save the new list and summarise what is new.

04

How changes stay safe

  • This client authenticates with a developer API key in a header. The key can only do what its scopes allow; create a read-only key if the editor should never propose changes.
  • Two scopes, chosen by you at sign-in: read, and propose. With read alone the assistant cannot request any change.
  • A change requested from an assistant is a proposal. It waits in Approvals in Valkiria until the account owner approves it, unless the write policy you set for that account allows that kind of change by itself.
  • New campaigns are created paused. Starting new spend and deleting always wait for a person.
  • The assistant can list what is waiting for approval and reject a proposal. It cannot approve one: approval stays with the owner in Valkiria.
  • The change history shows who or what made each change and the value before and after, with Undo where the change can be reversed.
  • You can disconnect an assistant at any time on the Connect AI page; a developer API key can be deleted the same way.

05

Limits

Google Ads

  • Deleting from the assistant removes a Valkiria draft only, never a campaign in Google Ads.
  • Starting new spend is never done by the assistant: resuming and launching wait for a person.

Cursor

  • A developer API key is required, and developer API keys are not included in every plan.
  • A key does what its scopes allow until you delete it, so create a read-only key if the editor should never propose changes.
  • The assistant sees only your own Valkiria workspace, and only the ad accounts connected there.
  • Numbers are as fresh as the last sync or import; the assistant can tell you when that was.
  • Money stays in each account's own currency. Different currencies are not converted or added up.
  • Reading data is not counted against the monthly allowance; changes and AI generations are. Allowances per plan are on the pricing page.

06

FAQ

Ask Cursor about your Google Ads account

Create a free account, connect an ad account and add the connector. The first pass only reads.

Drag to move. Alt + arrow keys move the button; Alt + Home resets its position.

Cookie Preferences

We use cookies to enhance your experience. Essential cookies are always active. You can manage optional cookies below.

Essential
Analytics
Marketing
Third-Party