Claude MCP server

VibeAds ships an official Model Context Protocol (MCP) server you can install in Claude Desktop, Cursor, Cline, or any MCP-compatible client. Talk to your VibeAds account in natural language: "How are my plumber campaigns doing this week?"

What is MCP

Model Context Protocol is Anthropic's open standard for connecting AI models to tools and data sources. An MCP server exposes a set of typed functions that any MCP-compatible client can call.

The VibeAds MCP server runs locally on your machine (via npx) and authenticates to our cloud via an API key you generate in the dashboard.

Install in Claude Desktop

1. Sign into VibeAds, go to Settings → MCP API Keys
2. Click "Generate key." Copy the key (shown once, prefix vba_mcp_)
3. Run npx vibeads-mcp-init in your terminal
4. Paste the key when prompted
5. The script writes the config to your Claude Desktop config file
6. Restart Claude Desktop

For Cursor or Cline, the same npx vibeads-mcp-init command prints the JSON snippet to paste into those clients' config files.

Available tools

• list_campaigns: enumerate active campaigns with status + budget.
• get_campaign_details: deep dive on one campaign. Last 7-day metrics, ad groups, landing pages, active diagnostics.
• get_account_health_score: 0-100 score with A-F grade across 6 dimensions (Tracking, Keywords, Budget, Creative, Targeting, Performance). Weighted rollup from 35+ diagnostic rules.
• get_search_term_analysis: wasted spend vs winners with configurable lookback and min cost threshold.
• get_diagnostics: full active issue list grouped by severity with recommended fix and estimated impact.

All five tools are read-only. The MCP server cannot mutate your campaigns. To approve recommendations, you use the dashboard (or the chat panel at /app/chat).

Authentication

Each API key is SHA-256 hashed before storage and scoped to a single VibeAds user. Keys are revocable from /app/settings/mcp. Revoking a key kills any client using it within seconds.

Multiple keys per user allowed (label each so you can revoke selectively, e.g. "Claude Desktop home laptop" vs "Cursor work").

Example prompts

• "What should I fix first across all my campaigns?"
• "Which search terms wasted the most spend last 30 days?"
• "How is my HVAC campaign doing vs the plumber campaign?"
• "Score my account health and tell me the weakest dimension."
• "Find me the keywords with high impressions but low CTR."
• "Are there any new diagnostics on my Atlanta campaign?"
• "Pull the search term analysis for my locksmith campaign with min cost $50."

Security model

The MCP server is a Node.js process running on your machine. It receives function calls from your MCP client, signs them with your API key, and forwards to VibeAds Supabase API. The server stores nothing locally. All your data stays in Supabase.