Vibeads MCP

@vibeads/mcp

Talk to your Google Ads account from ChatGPT, Claude, Claude Code, 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 your assistant 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, apply guarded optimizations, edit keywords, bids and budgets, add ad groups, and publish, with you confirming anything that spends money.

There are two ways to connect, and both reach the same 29 tools:

• Sign in (OAuth). Add the hosted server, https://getvibeads.com/api/mcp, in ChatGPT, Claude, Meta AI or Claude Code and sign in to VibeAds when it asks. No key and nothing to install.
• API key. For Cursor, Cline, Windsurf and any client that can't sign in: create a vba_mcp_ key and use this npm package, or send the key to the hosted server in a header.

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, apply optimizations, edit keywords, bids and budgets, and publish through the VibeAds gateway
• 🔐 Sign in or use a key: OAuth sign-in for assistants that support it, a revocable API key for everything else. Your Google login never reaches the assistant
• 🔒 Safe by design: read tools can't modify anything; write tools run inside VibeAds' safety guardrails, and nothing spends money without you confirming it
• ⚡ 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.

Connect

An approval link only works in your own signed-in VibeAds session, so neither a key nor a connected app can approve it.

Option A: sign in (no key, nothing to install)

ChatGPT, Claude and Meta AI

Add the server address as a custom connector (Claude, Meta AI) or a custom MCP server (ChatGPT), and sign in to VibeAds when the assistant asks:

https://getvibeads.com/api/mcp

Step-by-step instructions for each one: Connect ChatGPT, Claude or Meta AI. VibeAds emails you when an app is connected to your account.

Claude Code

Add the server with a fixed callback port, then open /mcp in Claude Code, choose VibeAds and sign in in your browser:

claude mcp add --transport http --callback-port 31790 vibeads https://getvibeads.com/api/mcp

Any free port works; 31790 is an example. Keep it fixed: VibeAds checks the return address exactly, so a later sign-in on a different port is refused (run claude mcp remove vibeads and add it again). VibeAds' sign-in page calls Claude Code "An app on this computer": allow it only if you just started connecting from Claude Code.

Signed-in apps are listed in Settings, Connected apps, where you can disconnect them and set the daily budget assistants may publish up to.

Option B: API key

Step 1: get your API key

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

[→ Generate API key](https://getvibeads.com/app/settings/mcp)

Keys start with vba_mcp_, are shown once, and are scoped to your account only. Make one per client or machine, so you can revoke one without touching the others.

Step 2: configure your MCP client

This package runs on your computer and forwards every call to VibeAds with your key. It always uses an API key; to sign in instead, use Option A.

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. (Claude Desktop can also sign in instead, through a custom connector: see Option A.)

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

Claude Code

claude mcp add vibeads -e VIBEADS_API_KEY=vba_mcp_YOUR_KEY_HERE -- npx -y @vibeads/mcp

Cline and other MCP clients

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

npx -y @vibeads/mcp --init prints ready-to-paste configs for each client.

Or: the hosted server with your key

Nothing to install: give the client the hosted address and send the key in an x-vibeads-api-key header. In Claude Code:

claude mcp add --transport http vibeads https://getvibeads.com/api/mcp --header "x-vibeads-api-key: vba_mcp_YOUR_KEY_HERE"

The key also works as Authorization: Bearer vba_mcp_.... A client that can't send headers can put it in the address (https://getvibeads.com/api/mcp?key=vba_mcp_...); that address then works like a password, so prefer a header or signing in. Guides for Cursor, OpenAI Codex, Gemini CLI and VS Code with GitHub Copilot.

Environment variables (this package)

Setup is one env var: every tool (read and write) runs through the server-side VibeAds gateway with your API key.

Usage

Once connected, you can ask your assistant questions like:

📋 Campaign discovery

"Show me all my VibeAds campaigns"

"Which campaigns are paused?"

"Give me the 5 most recently created campaigns"

🔬 Deep dives

"Tell me everything about my plumber campaign in Austin"

"How did my HVAC campaign perform last week?"

"What's the CPA for campaign abc12345?"

📈 Reports for any period

"Compare September with August for my Austin plumbing campaign"

"Spend by device across my whole account last month"

"Which keywords spent the most in the last 90 days?"

🔎 Keyword research

"How many people search for drain cleaning in Austin, TX?"

"Find keyword ideas from my services page for Round Rock and Pflugerville"

🧾 Audit a whole Google Ads account

Works right after you connect Google Ads, before anything is imported:

"Where is my Google Ads budget being wasted?"

"Audit my Google Ads account"

📊 Account health

"What's my VibeAds account health score?"

"Which dimension is pulling my score down?"

"Give me the health score just for campaign xyz"

💸 Search term analysis

"What search terms are wasting my budget?"

"Show me the top 10 winning keywords from the last 30 days"

"How much am I wasting on terms with zero conversions?"

🩺 Diagnostics + recommendations

"What should I fix first?"

"Show me all critical diagnostics"

"What's wrong with my roofing campaign?"

Available tools

Read tools

|