Vibeads MCP server

@vibeads/mcp

Talk to your Google Ads account from Claude Desktop, Cursor, or any MCP client.

Built for local service businesses — 33 categories with tuned keywords, CPC benchmarks and funnel templates.

The official Model Context Protocol server for VibeAds. Ask Claude questions like "which search terms are wasting my budget?" or "what's my account health score?" and get answers pulled from your live campaign data.

Unlike generic Google Ads MCP servers, this one is pre-tuned for local service businesses and rolls up 35+ diagnostic rules into a single 0-100 account health score across 6 dimensions. On Pro/Max plans it can also draft campaign strategies, execute guarded optimizations, and kick off publish flows — with a human always approving anything that spends money.

Features

• 🎯 Local-service-first — 25 home-service verticals plus 8 professional/lead-gen ones, each with its own keyword seeds, CPC benchmarks, audience segments and funnel template
• 📊 Account Health Score 0-100 — weighted across 6 dimensions (Tracking, Keywords, Budget, Creative, Targeting, Performance)
• 🔍 Search term waste detection — finds every dollar burning on zero-conversion terms
• 💡 Diagnostic rollup — 35+ rules from VibeAds' optimization engine, ranked by severity
• ✍️ Write tools (Pro/Max) — draft strategies, approve optimizations, and start publish flows through the VibeAds gateway
• 🔒 Safe by design — read tools can't modify anything; write tools run inside VibeAds' safety guardrails, and publishing always requires a human to approve in the browser
• ⚡ No GAQL required — ask questions in natural language, get markdown answers

Supported categories

Local & home services (25): plumber · HVAC · electrician · roofer · cleaner · landscaper · pest control · painter · handyman · locksmith · garage door · appliance repair · tree service · fencing · windows & doors · carpet & flooring · waterproofing · pressure washing · pool services · junk removal · movers · auto repair · Christmas lighting · dentist · lawyer

Professional & lead-gen (8): real estate · insurance · financial services · education · healthcare · consulting · SaaS · B2B services

Any other category is accepted — it just falls back to generic defaults instead of the tuned knowledge base.

Installation

Step 1 — Get your API key

Sign in to your VibeAds account and generate an API key:

→ Generate API key

Keys start with vbamcp and are scoped to your account only.

Step 2 — Configure your MCP client

Claude Desktop

Open your config file:

Add this to the mcpServers block:

{
  "mcpServers": {
    "vibeads": {
      "command": "npx",
      "args": ["-y", "@vibeads/mcp"],
      "env": {
        "VIBEADS_API_KEY": "vba_mcp_YOUR_KEY_HERE"
      }
    }
  }
}

Restart Claude Desktop. You should see the VibeAds tools appear in the 🔨 tool menu.

Cursor

1. Open Settings → MCP
2. Click Add Server
3. Configure:

• Name: vibeads
• Command: npx -y @vibeads/mcp
• Environment variables: VIBEADSAPIKEY=vbamcpYOURKEYHERE

Cline / Claude Code / other MCP clients

Use the same config as Claude Desktop above. Most MCP clients follow the same schema.

Environment variables

Shortened. The full README is on GitHub.