# vibeads/mcp [Health: Active]

**Category:** 🎯 Marketing  
**Repository:** https://github.com/vibeads/mcp  
**GitHub Stars:** 1  
**npm Downloads (last month):** 3841  
**Views:** 2  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/mcp-335

## Description
Manage Google Ads from Claude: read metrics, draft campaigns, publish with human approval.

## Tools
Capabilities this server exposes over MCP:

- **list_campaigns** — Your campaigns in VibeAds (published, imported and drafts) with status, budget and category. Campaigns only in your Google Ads account are listed by `find_campaigns_to_import
- **get_campaign_details** — Deep dive on one campaign: metrics, ad groups, targeting, landing pages, diagnostics
- **get_account_health_score** — 0-100 score + letter grade across 6 dimensions, optionally per-campaign
- **get_search_term_analysis** — Wasted spend + winners from each campaign's latest synced search terms, which cover the 7 days before that sync (configurable cost threshold)
- **get_diagnostics** — Latest agent-optimize diagnostics with severity + recommended fix (up to 50)
- **find_campaigns_to_import** — Before importing: the campaigns in your Google Ads account, read from Google Ads, each marked with whether it is in VibeAds (VibeAds manages only the campaigns in it). Called `list_google_ads_campaigns` in 0.2.15
- **get_performance_report** — One campaign's or a whole account's figures for a period you choose (a preset or two dates, up to 90 days), read live from Google Ads, optionally by day, device, hour, ad group, keyword or location. Money in the account's currency. VibeAds builds every query; the assistant only picks the period and…
- **audit_google_ads_account** — An audit of one connected Google Ads account, read live from Google Ads: up to 25 Search campaigns over the last 30 days, whether or not they are in VibeAds, with a 0-100 health score and grade for the account and each campaign, the issues grouped by check with what fixes each in Google Ads, and ea…
- **list_keywords** — One published campaign's ad groups, keywords and negative keywords, read live from Google Ads: match type, status, max CPC and 30 days of clicks, cost and conversions
- **research_keywords** — Keyword ideas from Google's Keyword Planner for seed keywords, a web page or both, in the places you name: average monthly searches, competition and top-of-page bid range. Pro/Max, 2 credits (a repeat within 90 days is free)
- **list_google_ads_accounts** — Every connected Google Ads account, switched on or not, with the manager account (MCC) each client account sits under
- **list_google_recommendations** — Google's own recommendations for an account (its Recommendations page), with Google's estimate and whether each can be applied from the chat
- **generate_strategy** — Draft a full campaign strategy (keywords, ad copy, 3+ ad groups) server-side, with a Brand ad group for searches of your business's name, and on Max an ad group for each competitor you name. Costs 13 credits. Draft only: nothing is published, no money is spent
- **get_strategy_status** — Poll a strategy job: status, phase, and drafted ad groups once complete
- **apply_strategy** — Turn a completed preview into a real draft campaign (ad groups, keywords, targeting, ad copy, extensions). Costs 6 credits + 3 per ad group for image generation. Draft only: not live, no ad money spent
- **list_recommendations** — Pending optimization recommendations, each with the tool and exact arguments that carry it out (its session and recommendation IDs included), or a link to approve it in VibeAds when no tool makes that change
- **preview_ad_group** — Show a new ad group (keywords, three ads, landing page plan) before it is added. Creates a preview only
- **add_ad_group** — Add a previewed ad group. On a published campaign it starts serving at once, within the campaign's budget
- **request_publish** — Publish a campaign that has ad groups. Publishing spends real money, so with an API key or Claude Code it returns a human-approval URL; ChatGPT, Claude and Meta AI publish a Search campaign within the daily limit you allow assistants once you confirm its budget in the chat, and get an approval URL…
- **import_campaigns** — Bring up to 3 campaigns from your Google Ads account into VibeAds, so its optimizer and reports cover them. Nothing changes in Google Ads. 1 credit each
- **pause_campaign** — Pause a live campaign in Google Ads
- **resume_campaign** — Start a paused campaign again, under the same rules as publishing: with an API key or Claude Code it returns a human-approval URL
- **add_negative_keywords** — Add up to 20 negative keywords to a campaign or one ad group, at once. One that would block the campaign's own keywords is left out
- **add_keywords** — Add up to 20 keywords to one ad group, at once, at the ad group's default max CPC
- **set_keyword_status** — Pause keywords, or turn paused ones back on
- **set_max_cpc** — Set an ad group's, a keyword's or a list of keywords' max CPC on a Manual CPC campaign. Up to double and $50 a click at once; more returns an approval URL
- **set_daily_budget** — Set a campaign's daily budget. A decrease runs at once. An increase returns an approval URL with an API key or Claude Code; signed in to ChatGPT, Claude or Meta AI, up to 20% runs at once
- **dismiss_google_recommendation** — Remove one of Google's recommendations from its list. No campaign changes
- **check_approval** — Poll a publish or change approval: pending → approved → executing → executed (or rejected / expired / failed)

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

**Requires environment variables:** `VIBEADS_API_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## 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.

_Full upstream README: https://allmcps.com/mcp/mcp-335/readme_