MCP App Store
by KeenEthics
VibeAds icon

VibeAds MCP Server for ChatGPT

By VibeAds

Overview

VibeAds runs Google Search ads for local home-service businesses: plumbers, HVAC, electricians, roofers, cleaners, landscapers, pest control and other trades. Connect your VibeAds account and ask about your ads in plain language. - See how each campaign is doing: spend, clicks, conversions and cost per lead. - Compare any two periods, such as September with August, and split the numbers by day, device, hour, keyword or location. - Research keywords with Google's own monthly search volumes and bid ranges for your area. - Audit your whole Google Ads account, campaigns you have not brought into VibeAds included: a health score, what is wasting money, and what fixes each issue. - Find the search terms that cost money without bringing customers. - Get the issues VibeAds found in your account, highest priority first, with the fix for each. - Review pending recommendations and carry one out when you agree with it, with the tool for that kind of change: negative keywords, keyword bids, pausing a keyword, a daily budget or a new ad group. - See Google's own recommendations for your account. A budget change or an exact or phrase keyword on a campaign in VibeAds can be made from the chat, within VibeAds' rules; the rest are applied in Google Ads. - Add a new ad group, one VibeAds recommends or one you name. ChatGPT shows you its keywords, ads and landing page before anything is added. - Add negative keywords or keywords, pause a keyword, or change a bid or a daily budget. Each change is listed in VibeAds, where you can undo it. - Draft a new campaign for your trade, budget and service area. VibeAds writes the keywords, the ad copy and the landing pages. Publishing a campaign commits your own ad budget. ChatGPT publishes a Search campaign only after you confirm its daily budget in the chat, and only up to the daily limit in your VibeAds Settings, which you can change or turn off. Starting a paused campaign follows the same rule. Above that, and for raising a daily budget by more than 20% or a bid past double or $50, ChatGPT gives you a link to review and approve it in VibeAds.

How to connect

  1. ChatGPT: Open the VibeAds listing in the ChatGPT app directory and choose Connect. ChatGPT listing VibeAds exposes 29 tools here.

Tools

add_ad_group

ChatGPT
Adds the ad group the user saw in preview_ad_group and agreed to, by its proposalId. On a published campaign it starts serving in Google Ads right away with its keywords and three ads, within the campaign's current daily budget, and VibeAds builds its landing page and generates images for it (3 credits). On a draft campaign it is saved and goes live when the campaign is published. If the preview came from a recommendation, adding it approves that recommendation, and the other recommendations in its session are recorded as rejected. Each preview can be added once; a repeat call returns the first result. An assistant can add 3 ad groups to a campaign a day. The user can pause or remove it from the campaign's Ad Groups tab in VibeAds. Requires a Pro or Max plan.

add_keywords

ChatGPT
Adds up to 20 keywords to one ad group of a published campaign in Google Ads right away. They bid the ad group's default max CPC and spend within the campaign's existing daily budget. Match types are EXACT and PHRASE (the default); "near me" and similar words come off, as Google's editorial rules ask. A keyword already in the ad group, or one a negative keyword in the campaign blocks, is left out, and the reply says why. The change is listed on the campaign's Optimize tab in VibeAds, where Undo removes the keywords. Requires a Pro or Max plan.

add_negative_keywords

ChatGPT
Adds up to 20 negative keywords to a published campaign in Google Ads right away: to the whole campaign, or to one ad group with adGroup. Searches a negative keyword matches stop showing the campaign's ads. Match types are EXACT and PHRASE (the default); a one-word PHRASE negative blocks every search containing that word. A negative that would block one of the campaign's own keywords, or one already there, is left out, and the reply lists them with the reason. The change is listed on the campaign's Optimize tab in VibeAds, where Undo removes it. An assistant can make 20 changes to a campaign a day, adding up to 100 keywords and negative keywords. With sessionId and recommendationId, it carries out that recommendation from list_recommendations, whose applyWith gives these arguments: VibeAds checks they are the recommendation's, records it as approved, and measures the change, rolling it back if the campaign's results get worse. Requires a Pro or Max plan.

apply_strategy

ChatGPT
Turns a completed generate_strategy preview into a draft campaign: the campaign with its ad groups, keywords, targeting, ad copy and extensions. It takes the same jobId once get_strategy_status reports completed, and request_publish works on the campaignId it returns. Costs 6 VibeAds credits plus 3 per ad group for image generation. The campaign is a draft: it is not live and spends no ad money. Each preview becomes one campaign. A second call with the same jobId returns an error naming the campaign the preview already created, unless an earlier call failed and left that draft empty, which the second call then fills. Business contact values given here override those sent to generate_strategy, so a missing phone can be supplied without regenerating. Requires a Pro or Max plan.

audit_google_ads_account

ChatGPT
Audits one of the user's connected Google Ads accounts, read live from Google Ads: up to 25 Search campaigns over the last 30 days, whether or not they are in VibeAds, against the 25 checks of VibeAds' free account audit (conversions, wasted spend, budget, click-through rate, cost per conversion, Quality Score and its parts, ad extensions, search terms, devices, search partners and more; the cost per click and landing page speed checks run on campaigns in VibeAds, which hold the figures they need). It returns a 0-100 health score and letter grade for the account and for each campaign, the issues grouped by check with what fixes each in Google Ads, each campaign's costliest search terms with clicks and no conversions, and inVibeAds, whether VibeAds already manages each campaign. It answers where an account's budget is going to waste, right after the user connects Google Ads and before anything is imported. Campaigns with no impressions in the last 30 days are left out. VibeAds keeps one audit per account for 24 hours, and a repeat in that time returns it; a fresh audit of an account with many campaigns can take a minute. With more than one Google Ads account, the first answer is choose_google_ads_account with the accounts, and customerId names the one the user picks. Without a Google Ads connection, the answer has a link for the user to connect it. Auditing changes nothing in Google Ads. Available on every plan.

check_approval

ChatGPT
Reports on an approval: a link created by request_publish, a publish request_publish started itself (published true), or a link set_daily_budget, set_max_cpc or resume_campaign returned (approvalRequired). actionType says which: publish_campaign or apply_recommendation. status is one of: pending, approved, rejected, expired, executing, executed, failed. Pending means the user has not yet approved the link, which happens in their browser and not through this connection. For apply_recommendation, change says what it is (budget_increase, bid_change or resume_campaign), and executed means the change was made in Google Ads. For publish_campaign, executed means a publish job started, not that ads are serving: publishJob.status is processing, queued, completed or failed, with the current step and any error. Once publishJob.status is completed the campaign is in Google Ads, and publishJob.campaignStatus says whether ads can show. ENABLED: the campaign is live, can spend its daily budget, and can be paused from the dashboard. PAUSED: no ads are showing and nothing is being spent; publishJob.pausedMessage says why, and the campaign's page in VibeAds can start it. publishJob.billingMessage, when present, means Google Ads has no approved payment method, so no ads show and nothing is spent until one is added. Without campaignStatus, the campaign is in Google Ads and list_campaigns shows its status. Requires a Pro or Max plan.

dismiss_google_recommendation

ChatGPT
Dismisses one of Google's recommendations by its resourceName from list_google_recommendations: Google stops showing it on the account's Recommendations page. No campaign, budget, keyword or ad changes. Requires a Pro or Max plan.

find_campaigns_to_import

ChatGPT
Reads every campaign in one of the user's connected Google Ads accounts directly from Google Ads (up to 50, removed ones left out) and marks each with inVibeAds, whether VibeAds already manages it. It answers what campaigns a Google Ads account already has, including the ones VibeAds has not seen. It is for bringing existing campaigns into VibeAds: the user picks the ones to bring in, and import_campaigns copies them. Each campaign has its name, googleCampaignId, status, type, daily budget, and the last 30 days of impressions, clicks, spend and conversions. VibeAds' optimizer, reports and recommendations cover the campaigns in VibeAds, which makes this useful right after the user connects Google Ads. With more than one Google Ads account, the first answer is choose_google_ads_account with the accounts, and a call with customerId reads the one the user picks. Without a Google Ads connection, the answer has a link for the user to connect it. Reading changes nothing. Available on every plan.

generate_strategy

ChatGPT
Previews a draft campaign strategy server-side: keywords, ad copy, and 3 or more ad groups for a service category, budget, and locations. Pro and Max drafts include an ad group for searches of the business's own name, and on the Max plan, competitor ad groups for up to 5 competitors named in competitors; for a competitor given with its website, VibeAds reads that public website to write those ads. Costs 13 VibeAds credits. Returns a jobId: get_strategy_status reports progress with it, and apply_strategy turns the finished preview into a draft campaign. The preview creates no campaign, publishes nothing and spends no ad money. Requires a Pro or Max plan.

get_account_health_score

ChatGPT
Compute a 0-100 account health score across 6 dimensions (Tracking, Keywords, Budget, Creative, Targeting, Performance) by rolling up the latest diagnostics from all campaigns. Returns a letter grade A-F and per-dimension breakdown. Optionally scope to a single campaign.

get_campaign_details

ChatGPT
Get a detailed view of a single VibeAds campaign: budget, bidding strategy, ad groups, targeted locations, landing pages, last 7 days of performance metrics (impressions, clicks, CTR, CPC, spend, conversions, CPA), and any active diagnostics.

get_diagnostics

ChatGPT
Return up to limit issues (default 20, max 50) from the optimizer's most recent run on each campaign, highest severity first: rule, campaign, problem, affected metric with current value vs benchmark, recommended fix and estimated impact. The optimizer runs every 12 hours on published campaigns with synced Google Ads data, so new or unpublished campaigns have none. It returns no recommendation IDs; list_recommendations lists the pending changes, each with the tool that carries it out. Can filter by severity and scope to one campaign.

get_performance_report

ChatGPT
Reads one campaign's figures, or a whole Google Ads account's, for a period the user chooses, live from Google Ads: impressions, clicks, spend, conversions, conversion value, click-through rate, average cost per click, cost per conversion and conversion rate. The period is a preset (the last 7, 30 or 90 days, this month or last month) or a start and end date, up to 90 days; two reports compare two periods, such as September with August. breakdown splits the figures by day, device, hour of the day, ad group, keyword or location. The campaign is one in VibeAds (campaignId) or any campaign in a connected Google Ads account (googleCampaignId); with neither, the report covers the whole account. Money is in the account's currency, not micros, and the days are the account's own. With more than one Google Ads account, a report on an account or on a googleCampaignId first answers choose_google_ads_account with the accounts, and customerId names the one the user picks. Without a Google Ads connection, the answer has a link for the user to connect it. Reading changes nothing. Available on every plan.

get_search_term_analysis

ChatGPT
Analyze each campaign's most recently synced search terms to find wasted spend (terms costing at least min_cost with zero conversions, up to 15, highest cost first) and winners (at least 5 clicks and 1 conversion, up to 10, highest conversion rate first). The synced list holds the up-to-100 highest-cost search terms over the 7 days before the campaign's latest Google Ads sync, so every figure describes those 7 days; lookback_days only sets how old that sync may be. Search terms are the queries people typed, not the account's keywords. Can be scoped to one campaign (full UUID or a unique prefix).

get_strategy_status

ChatGPT
Checks a strategy generation job started with generate_strategy. Returns status and phase while running, and the drafted ad groups (with keyword and headline counts) once complete. Generation usually finishes within a few minutes (the server allows up to 6), and every VibeAds tool call counts toward a limit of 60 calls per hour per connection, so checks are best spaced out. Once it is complete, apply_strategy with the same jobId creates the draft campaign; request_publish works on a draft campaign, not on a preview. Requires a Pro or Max plan.

import_campaigns

ChatGPT
Brings up to 3 campaigns the user chose from find_campaigns_to_import into VibeAds, by their googleCampaignIds. VibeAds copies each campaign's ad groups, keywords, ads, targeting and extensions and then manages it like a campaign it published: it syncs its numbers from Google Ads (starting now), its optimizer reviews it within 12 hours, and get_campaign_details, list_recommendations and pause_campaign work on it with the returned campaignId. Nothing changes in Google Ads. Costs 1 VibeAds credit per campaign. With more than one Google Ads account, customerId names the account the campaigns are in. Requires a Pro or Max plan.

list_campaigns

ChatGPT
Lists the user's campaigns in VibeAds, newest first (default 25, max 100): the Google Ads campaigns VibeAds published or imported, and drafts. This is the list for a request to see the user's campaigns in VibeAds, "my Google Ads campaigns in VibeAds" included, and it works with or without a Google Ads connection. Each campaign has its name, full campaign ID, status, whether it is published to Google Ads, category and business city, daily budget, and created date, and the list names the plan the user's VibeAds account is on (Free, Pro or Max). It has no performance metrics (get_campaign_details has the last 7 days, get_performance_report any period). Every tool that takes a campaign ID accepts the ID it returns. It reads VibeAds, not Google Ads: campaigns that exist only in the user's Google Ads account, not published from or imported into VibeAds, are not in this list. find_campaigns_to_import reads those, and answers what campaigns a Google Ads account already has.

list_google_ads_accounts

ChatGPT
Lists every Google Ads account connected to the user's VibeAds account, switched on or not: name, ID, whether it is the default, and inUse, whether VibeAds manages it. A client account reached through a manager account (MCC) carries managerAccount, the manager it sits under, and managerAccounts lists each manager with its number of connected clients. It is useful for agencies, to tell clients apart before reading, importing or publishing, and when a choose_google_ads_account answer names accounts. Accounts are switched on and off in VibeAds Settings, up to as many as the plan runs at once. Reading changes nothing. Available on every plan.

list_google_recommendations

ChatGPT
Reads Google's own recommendations for one of the user's Google Ads accounts, as on the account's Recommendations page in Google Ads (up to 25, open ones), optionally for one campaign. Each has its resourceName, type, a title in plain words, the campaigns it is for (and whether each is in VibeAds), what it would change (for a budget, the daily budget now and after; for a keyword, its text and match type; for ad text, the lines Google would add), and Google's weekly estimate where Google gives one. applyIn says where the change is made. chat: applyWith is the tool and the exact arguments that make the same change (set_daily_budget for a budget, add_keywords for an exact or phrase keyword, on campaigns in VibeAds), each with its own limits. google_ads: reason says why, and the user applies it on the account's Recommendations page in Google Ads (bidding strategy changes, new networks, broad match before 30 conversions, Google's suggested ad text, campaigns not in VibeAds). dismiss_google_recommendation removes one from Google's list. VibeAds' optimizer's own recommendations are in list_recommendations. With more than one Google Ads account, the first answer is choose_google_ads_account. Reading changes nothing. Available on every plan.

list_keywords

ChatGPT
Lists one published campaign's ad groups, keywords and negative keywords, read live from Google Ads: each keyword's match type, status (ENABLED or PAUSED), max CPC (its own, or its ad group's default) and its last 30 days of clicks, cost and conversions, and each ad group's default max CPC. adGroup narrows the list to one ad group. add_keywords, add_negative_keywords, set_keyword_status and set_max_cpc name keywords and ad groups the way this list shows them. Without a Google Ads connection, the answer has a link for the user to connect it. Reading changes nothing. Available on every plan.

list_recommendations

ChatGPT
Lists the changes VibeAds recommends for the user's campaigns that are waiting for the user's decision, from the 25 most recent optimization sessions. Each session has a sessionId and its campaign; each recommendation has a recommendationId, the change it would make, the reason, a risk level, a blast radius (how much harm the change could do if it is wrong), the estimated impact, and applyWith: the tool and the exact arguments that carry it out, the recommendation's sessionId and recommendationId included (add_negative_keywords, set_keyword_status, set_max_cpc, set_daily_budget, or preview_ad_group then add_ad_group for a new ad group). approval says what that tool does with it: in_chat (it makes the change once the user agrees), approval_link (a budget increase of more than 20%; set_daily_budget returns a link the user opens in VibeAds), preview_then_add (a new ad group), in_vibeads (no tool makes this change from a chat; optimizeUrl is the campaign's Optimize tab, where the user approves it) or not_applicable (advice). Budget changes show the current and new daily budget. Carrying out one recommendation records the other recommendations in its session as rejected. Reading changes nothing. Requires a Pro or Max plan.

pause_campaign

ChatGPT
Pauses one of the user's published campaigns in Google Ads, by its campaignId from list_campaigns or import_campaigns. While it is paused no ads show and nothing is spent. Nothing is deleted. resume_campaign starts it again, and so does Start ads on the campaign's page in VibeAds. A draft that is not in Google Ads yet has nothing to pause, and a campaign that is already paused is left as it is. Requires a Pro or Max plan.

preview_ad_group

ChatGPT
Writes a new ad group for one of the user's campaigns and shows what adding it would do, without adding anything: its keywords, its three ads, its landing page, its images, and the daily budget each ad group would get. It works for an ad group the user names (campaignId and name, for a service the campaign does not cover yet) or for the optimizer's recommended ad group (sessionId and recommendationId from list_recommendations, where approval is preview_then_add). add_ad_group adds it with the returned proposalId once the user agrees. Nothing changes in Google Ads, the campaign's budget is not changed, and no credits are charged. The preview expires after 24 hours. An assistant can preview 10 new ad groups a day. Requires a Pro or Max plan.

request_publish

ChatGPT
Publishes a draft campaign to Google Ads, where it can spend its daily budget, billed to the advertiser's own Google Ads account. For a connection the user made by signing in to VibeAds, when the user allows AI assistants to publish Search campaigns up to a daily budget and this campaign is within it, publishing takes two calls. The first publishes nothing and returns needsConfirmation with dailyBudgetUsd, the most the campaign can spend a day. The second, with confirmedDailyBudget set to that amount once the user agrees to it, starts publishing and returns published true. In every other case (a connection made with a VibeAds API key, no such allowance or a budget over it, a Display or Meta campaign, or two campaigns already published this way in the last 24 hours) the reply has an approvalUrl, valid for 24 hours, with approvalReason: the user opens it in their browser, reviews the budget and approves it, which this connection cannot do. A publish or a new link cancels an earlier pending link for the same campaign. check_approval with the returned approvalId reports when publishing finishes and whether the campaign is live or was left paused. The campaign is a draft with ad groups: one listed by list_campaigns, or one apply_strategy created (a generate_strategy jobId is not a campaign). Without a Google Ads connection, the reply has a link for the user to connect it. With more than one Google Ads account, the first reply is choose_google_ads_account with the accounts, and customerId names the account the user picks, on the confirming call as well; the campaign is published to that account and no other. Requires a Pro or Max plan.

research_keywords

ChatGPT
Looks up keyword ideas in Google's Keyword Planner for seed keywords, a public web page, or both, in the places named: a city such as "Austin, TX", a ZIP code, a county, a state or a whole country, up to 10. Each idea has its average monthly searches over the last 12 months, its competition (LOW, MEDIUM or HIGH, and 0 to 100) and the top-of-page bid range in the Google Ads account's currency, highest search volume first. The figures are Google's, for English-language searches, read through the user's connected Google Ads account; nothing is added to any campaign. Given a web page, Google reads that page, whoever runs the site, to suggest ideas. Costs 2 VibeAds credits when Google is asked; the same research repeated within 90 days is answered from VibeAds' saved copy at no cost. A place Google's location list does not have is named in the answer, and nothing is charged. With more than one Google Ads account, the first answer is choose_google_ads_account, and customerId names the account to use. Without a Google Ads connection, the answer has a link for the user to connect it. Requires a Pro or Max plan.

resume_campaign

ChatGPT
Starts one of the user's paused campaigns again in Google Ads, where it can spend its daily budget, billed to the advertiser's own Google Ads account. It follows the same rules as request_publish. For a connection the user made by signing in to VibeAds, when the campaign's daily budget is within what the user allows AI assistants, it takes two calls: the first changes nothing and returns needsConfirmation with dailyBudgetUsd, and the second, with confirmedDailyBudget set to that amount once the user agrees to it, starts the campaign, and VibeAds emails the user that it started. A campaign can be started this way twice a day. In other cases (a connection made with a VibeAds API key, a budget over the allowance, or a third start in a day) the reply has an approvalUrl the user opens in VibeAds, with approvalReason, and nothing changes until they approve it (check_approval reports the outcome). A campaign that is already running is left as it is. pause_campaign pauses it again, and so does Undo on the campaign's Optimize tab in VibeAds. Requires a Pro or Max plan.

set_daily_budget

ChatGPT
Sets a published campaign's daily budget, in dollars. A decrease, or an increase of up to 20%, changes in Google Ads right away and is listed on the campaign's Optimize tab in VibeAds, where Undo puts the old budget back. The 20% is measured from the lowest daily budget the campaign had in the last 24 hours. A larger increase, or any increase from a connection made with a VibeAds API key, is a change the user approves: the reply has approvalRequired and an approvalUrl they open in VibeAds, and nothing changes until then (check_approval reports the outcome). An assistant can change a campaign's daily budget 3 times a day. With sessionId and recommendationId, it carries out that recommendation from list_recommendations, whose applyWith gives these arguments: VibeAds checks they are the recommendation's, records it as approved, and measures the change, rolling it back if the campaign's results get worse. Requires a Pro or Max plan.

set_keyword_status

ChatGPT
Pauses up to 20 keywords of a published campaign in Google Ads right away, or turns paused ones back on (status paused or enabled). A paused keyword shows no ads and spends nothing; one turned back on spends within the campaign's daily budget. Keywords are named by their text, with matchType or adGroup when two ad groups hold the same text, as list_keywords shows them. The change is listed on the campaign's Optimize tab in VibeAds, where Undo reverses it. With sessionId and recommendationId, it carries out that recommendation from list_recommendations, whose applyWith gives these arguments: VibeAds checks they are the recommendation's, records it as approved, and measures the change, rolling it back if the campaign's results get worse. Requires a Pro or Max plan.

set_max_cpc

ChatGPT
Sets the max CPC (the most Google charges for one click) of one ad group, of one keyword in it, or of up to 20 keywords each with its own bid (keywords), on a published campaign that uses Manual CPC bidding; on other bidding strategies Google sets the bids and the reply says so. A decrease, or an increase up to double the current max CPC and at most $50 a click, changes in Google Ads right away, within the campaign's daily budget, and is listed on the campaign's Optimize tab in VibeAds, where Undo puts the old max CPC back. A larger increase is a change the user approves: the reply has approvalRequired and an approvalUrl they open in VibeAds, and nothing changes until then (check_approval reports the outcome). Over $100 a click is refused. Keywords with a max CPC of their own keep it when their ad group's changes. In a keywords list each bid follows the same limits, and a list with a larger increase changes nothing. With sessionId and recommendationId, it carries out that recommendation from list_recommendations, whose applyWith gives these arguments: VibeAds checks they are the recommendation's, records it as approved, and measures the change, rolling it back if the campaign's results get worse. Requires a Pro or Max plan.

Capabilities

Writes

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/vibeads"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/vibeads)