vibeads/mcp

> **Talk to your Google Ads account from Claude Desktop, Cursor, or any MCP client.**
>
> Built for local service businesses: 35 categories, 32 of them 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, add ad groups, and kick off publish flows, with a human always approving anything that spends money.
---
Features
- 🎯 **Local-service-first** — 27 home-service verticals plus 8 professional/lead-gen ones; 32 of them have their 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 (27):** 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 · air duct & dryer vent cleaning · commercial cleaning & janitorial · 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
Consulting, SaaS and B2B services use generic defaults, and so does any other category you pass, instead of a tuned knowledge base.
---
Installation
> **Using ChatGPT, Claude or Meta AI?** You don't need this package or a key: add the hosted server, https://getvibeads.com/api/mcp, in the assistant and sign in to VibeAds when it asks. Steps for each assistant: Connect ChatGPT, Claude or Meta AI. This package is for clients that run tools on your computer, such as Claude Code, Cursor and Cline.
Step 1 — Get your API key
Sign in to your VibeAds account and generate an API key:
**→ Generate API key**
Keys start with vba_mcp_ and are scoped to your account only.
Step 2 — Configure your MCP client
Claude Desktop
Open your config file:
| OS | Path |
|---|---|
| macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Windows | %APPDATA%\Claude\claude_desktop_config.json |
| Linux | ~/.config/Claude/claude_desktop_config.json |
Add this to the mcpServers block:
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:** VIBEADS_API_KEY=vba_mcp_YOUR_KEY_HERE
Cline / Claude Code / other MCP clients
Use the same config as Claude Desktop above. Most MCP clients follow the same schema.
Environment variables
Setup is one env var — every tool (read and write) runs through the secure server-side VibeAds gateway with your API key.
| Variable | Required? | Purpose |
|---|---|---|
| VIBEADS_API_KEY | ✅ Required | Your vba_mcp_... key. This is the only credential any tool needs. |
| VIBEADS_SUPABASE_URL | Optional | Override the VibeAds backend URL. Defaults to the production endpoint. |