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.
vibeads-mcp is an MCP project maintained in the vibeads/mcp repository. The maintainer describes its purpose as “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…”. Read the project documentation for the complete scope.
The documented npm package is @vibeads/mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.
The example declares VIBEADS_API_KEY. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.
Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| list_campaigns | Enumerate all campaigns with status, budget, category |
| 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 |
| generate_strategy | Draft a full campaign strategy (keywords, ad copy, 3+ ad groups) server-side. 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… |
| list_recommendations | Pending optimization recommendations awaiting approval, with the session + recommendation IDs |
| approve_recommendation | Execute ONE diagnosed optimization. Approving closes its session and rejects the other recommendations in it. A budget increase over 20% returns an approval… |
| 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 | Start the publish flow for a campaign that has ad groups — returns a human-approval URL because publishing spends real money. With more than one Google Ads… |
| 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. Starting it again is done in VibeAds |
| check_approval | Poll a publish approval: pending → approved → executing → executed (or rejected / expired / failed) |
{
"mcpServers": {
"vibeads": {
"command": "npx",
"args": [
"-y",
"@vibeads/mcp"
],
"env": {
"VIBEADS_API_KEY": "YOUR_VIBEADS_API_KEY"
}
}
}
}From the project documentation. Replace placeholders and example paths before connecting.
| Variable | Description | Required |
|---|---|---|
| VIBEADS_API_KEY | Declared in the maintainer’s client configuration. | Yes |
Search built for AI, not humans — semantic web search that returns model-ready content, plus code context.
Put 6,000+ pre-built scrapers at your assistant's fingertips through one MCP endpoint.
Fetches and analyzes content from Reddit, providing access to hot threads and post details.
Enables interaction with X (formerly Twitter) for retrieving tweets, creating new posts, and replying to existing ones.
Automates LinkedIn interactions and extracts data through browser automation, respecting terms of service and rate limits.
Automates SEO tasks and provides AI-powered optimization by integrating with the Google Ads Keyword Planner API.