Log inSubmit server
Vibeads MCP logo

Vibeads MCP

by vibeads

Manage Google Ads campaigns from MCP clients with live reporting, diagnostics, guarded edits, drafts, and approval-based publishing.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Vibeads MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "mcp-335": {
      "command": "npx",
      "args": [
        "-y",
        "@vibeads/mcp"
      ],
      "env": {
        "VIBEADS_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

The vibeads/mcp MCP server connects MCP clients to VibeAds and Google Ads for campaign reporting, diagnostics, keyword research, strategy drafting, and controlled campaign changes. It provides read tools for live account and campaign data, while write operations such as publishing, budget increases, and resuming campaigns use confirmations or approval links. Reach for it when managing Google Ads for local-service or lead-generation businesses without writing GAQL. The package can run locally with an API key or use the hosted MCP endpoint with OAuth.

Use cases

  • Review Google Ads account health and campaign diagnostics
  • Find wasted spend in recent search terms
  • Draft and preview campaigns for local services
  • Import existing campaigns into VibeAds
  • Apply guarded keyword, bid, budget, and publishing changes

Key features

  • Live Google Ads performance reports
  • Account health scoring across six dimensions
  • Search-term waste and diagnostic analysis
  • Campaign strategy and ad-group drafting
  • Approval-controlled campaign changes
  • OAuth or API-key authentication

Tools29

What Vibeads MCP lets your agent do. Expand a tool for its parameters.

Self-reported~1.2k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

7/7 checks healthy over the last 46d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · @vibeads/mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1Stargazers on the source repository.
npm downloads3.8kPackage downloads in the last 30 days.
Last commit4d agoMost recent push to the default branch.
Tools exposed29Callable tools this server registers over MCP.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How Vibeads MCP works

What vibeads/mcp does

The vibeads/mcp MCP server connects an AI assistant to VibeAds and connected Google Ads accounts. It is listed in the 🎯 Marketing category and focuses on campaign management for local-service and lead-generation businesses. VibeAds includes tuned knowledge for many service categories, while other categories use generic defaults.

Read operations cover campaign lists, campaign details, account health, diagnostics, search-term waste, keywords, recommendations, Google Ads accounts, and performance reports. Reports can cover a selected preset or date range of up to 90 days, with optional breakdowns such as day, device, hour, ad group, keyword, or location.

Write operations can import campaigns, create strategy drafts, preview and add ad groups, edit keywords and negative keywords, change keyword status and bids, adjust budgets, pause or resume campaigns, and publish campaigns. Drafting and applying strategies do not make campaigns live. Publishing and some other changes can spend money, so the server applies approval controls.

How it works

The vibeads/mcp MCP server routes tool calls through the VibeAds gateway. The assistant selects periods, campaigns, and other parameters rather than constructing Google Ads queries directly. Live tools read from Google Ads where indicated; VibeAds-managed campaigns also expose imported and draft campaign data.

Account health combines checks across Tracking, Keywords, Budget, Creative, Targeting, and Performance into a score from 0 to 100 with a letter grade. Diagnostics group optimization issues by severity and include suggested fixes. Search-term analysis uses the latest synchronized terms, covering the seven days before that sync unless the available configuration changes the threshold.

OAuth is available through the hosted endpoint at https://getvibeads.com/api/mcp for supported assistants. API-key access works through the local npm package or by sending a key to the hosted endpoint. API calls are limited to 60 per hour per key; OAuth usage shares a 60-call hourly limit across signed-in apps.

Setup and configuration

Create a VibeAds API key beginning with vba_mcp_, then set VIBEADS_API_KEY when running the npm package. A typical stdio configuration invokes npx -y @vibeads/mcp. The package also supports --init to print client configuration examples.

Alternatively, add the hosted MCP URL and sign in through OAuth. With an API key and the hosted service, send the key in the x-vibeads-api-key header or as a bearer token. Header-based authentication is preferable to putting the key in the URL. Keys are account-scoped and can be revoked from VibeAds settings.

Tools and capabilities

  • Inspect campaigns, keywords, search terms, recommendations, diagnostics, and account health.
  • Generate keyword ideas from Keyword Planner using seed terms, a webpage, or both.
  • Produce campaign strategies and poll their progress before applying a draft.
  • Preview and add ad groups, including keywords, ads, and landing-page plans.
  • Import up to three campaigns at a time without changing Google Ads.
  • Modify keywords, negative keywords, keyword status, manual-CPC bids, and daily budgets.
  • Pause, resume, or publish campaigns subject to the applicable approval flow.

Limitations and notes

The package requires a VibeAds API key; the hosted OAuth route requires a client that supports that sign-in flow. Pro and Max capabilities are required for strategy drafting and certain write operations, and some actions consume credits. Keyword research, for example, has a stated credit cost.

Publishing spends real money. API-key connections and Claude Code return an approval URL for publishing and other gated changes. ChatGPT, Claude, and Meta AI can publish qualifying Search campaigns within an assistant daily limit after budget confirmation, while other cases use an approval URL. Budget increases have similar limits. An approval link must be opened in the signed-in VibeAds session.

Read tools do not modify accounts, but write tools can affect live campaigns. Adding an ad group to a published campaign starts serving within the campaign budget. Google Ads campaigns that have not been imported are visible through the import-discovery tool but are not managed by VibeAds until imported.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Vibeads MCP

vibeads/mcp is an MCP server that connects AI assistants to VibeAds and Google Ads. Its main tools report on campaigns, performance, keywords, search terms, diagnostics, recommendations, and account health, while also supporting strategy drafts, campaign imports, guarded edits, and approval-based publishing through the VibeAds gateway.

Install it through an MCP client's stdio configuration with `npx -y @vibeads/mcp` and set `VIBEADS_API_KEY` to a VibeAds key. The package also supports `npx -y @vibeads/mcp --init` for configuration examples.

Yes, vibeads/mcp works with Cursor using the npm package and an API key. Add a server in Cursor's MCP settings, use `npx -y @vibeads/mcp` as the command, and provide `VIBEADS_API_KEY`.

No, publishing is subject to human confirmation or an approval URL. API-key connections and Claude Code return an approval link, while ChatGPT, Claude, and Meta AI can publish qualifying Search campaigns after budget confirmation within the configured daily limit.

It reports campaign metrics, ad groups, targeting, landing pages, diagnostics, keywords, search terms, recommendations, and account health. Performance reports can cover a chosen period of up to 90 days and optionally break results down by day, device, hour, ad group, keyword, or location.

Related MCP servers

All in Marketing All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewVibeads MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/mcp-335?style=directory)](https://allmcps.com/mcp/mcp-335)
HTML Embed
<a href="https://allmcps.com/mcp/mcp-335"><img src="https://allmcps.com/api/badge/mcp-335?style=directory" alt="Vibeads MCP on AllMCPs" /></a>