Groas
Pergunte sobre suas campanhas, classificações e citações de IA e obtenha respostas com seus próprios dados. Grátis para usar
Documentação
Groas runs and audits Google Ads accounts, works on your Meta (Facebook and Instagram) ads and helps grow your website’s organic visibility. Its MCP server lets Claude (and any other MCP client) read your campaigns, keywords, search terms, daily performance, your Meta campaigns and their results, your competitors and their ads, your websites’ AI visibility, backlinks, SEO and content, and the actions Groas has taken on your behalf — and, if you opt in, make changes.
1. Prerequisites
- A Groas account. If you have none, connecting Groas from Claude opens a Groas window where you make one with your email and a password. Reading your Google Ads and Meta ad accounts through Groas is free. To let Claude make changes to your Google Ads and Meta ads, subscribe to the AI assistant plan: a monthly subscription you can cancel any time in your billing settings. On that plan Claude does the work; Groas does not manage campaigns for you. A Groas plan, where Groas runs your ads or grows your website, is bought on your setup page, which is also where such an account finishes its setup and books its onboarding call.
- For paid ads, at least one Google Ads or Meta ad account connected at Dashboard → Ad platforms. An account made by connecting Groas from Claude opens that page right away, with or without a plan; an account being set up for a Groas plan connects Google Ads on its setup page until its dashboard opens. The first sync takes a few minutes; until it finishes the tools report that no accounts are connected. For organic reads, a brand in Groas.
2. Connect in Claude (web, desktop, mobile)
- Open Customize → Connectors.
- Find Groas in the directory and click Connect. If it is not listed for your organization, choose Add custom connector and enter
https://mcp.groas.ai/mcp. Leave the OAuth client ID and secret fields empty. - A Groas sign-in window opens. Sign in and review the permission summary. Connections are read-only by default; with a plan you can tick Also allow changes to let Claude make changes through Groas — Google Ads budgets, bids, keywords and campaigns, and Meta budgets, ad sets and ads, with the AI assistant plan or a paid-ads plan; your content plan, articles, tracked AI prompts and link outreach with an organic plan. Click Allow. Organisation member logins cannot connect: sign in with the account owner's own Groas login.
- Back in Claude, enable the Groas connector in a chat and ask, for example, "Which of my campaigns lost the most conversions this week?"
On a Claude Team plan, members without connector permissions see a Request button instead; an admin then enables Groas for the organisation.
3. Connect in Claude Code
claude mcp add --transport http groas https://mcp.groas.ai/mcp
Run /mcp inside Claude Code to complete the browser sign-in the first time; the consent screen offers the same write opt-in. The same command with an API key header skips OAuth entirely — see section 6.
4. Other MCP clients (Cursor, ChatGPT, Windsurf, …)
Any client that supports remote MCP servers over Streamable HTTP with OAuth works. Point it at https://mcp.groas.ai/mcp; the server advertises its OAuth metadata, supports dynamic client registration and PKCE, and hands sign-in to scale.groas.ai. A typical mcp.json entry:
{
"mcpServers": {
"groas": { "url": "https://mcp.groas.ai/mcp" }
}
}
5. What Claude can do
Paid-ads tools take accountId, discovered with groas_list_accounts. Organic tools take brandId, discovered with groas_list_brands. You can simply name the account or brand; organic reads do not require Google Ads.
Google Ads read tools (every connection)
Call groas_list_accounts first and pass one of its accounts as accountId.
| Tools | Use them to |
|---|---|
groas_list_accounts | See which accounts you can query. |
listCampaigns · get_campaign_settings · listAdGroups · listAds · listKeywords · listSearchTerms | Browse campaigns, ad groups, ads, keywords and search terms with their status and settings. |
dailyPerformance | Cost, clicks, conversions and value per day for any date range, per campaign, ad group, keyword or Shopping product. |
queryGoogleAds · lookupGaqlFields | Ask Google Ads directly, in its own query language (GAQL), what the fixed reports do not cover. |
list_search_console_and_ga4 · querySearchConsole · queryGa4 · lookupGa4Fields | Live Search Console and GA4 data: for a site or property you pick from the list (no ad account needed), the site a Google Ads account advertises, or a brand's own site. They read through the Google account you connect for website data, see below. |
getAccountAudit · getConversionTrackingAudit | Groas's findings on account health and tracking gaps. |
listGroasActions · listGroasActionFailures · listPlannedActions | Every change Groas made, with its reasoning, anything that failed, and the changes planned for coming days. |
researchKeywords · getKeywordSeasonality · generateKeywordForecastMetrics | Search volume, competition and seasonal trends for keyword ideas, and the clicks and cost to expect from them. |
list_negative_keyword_lists · list_ad_assets · list_asset_group_assets · listAudiences | Shared negative keyword lists, sitelinks and other assets, Performance Max headlines and descriptions, and the audiences you can target. |
listBrandsAndOffers · get_brand_details | Your brands and offers, their guidelines, and which campaigns use each offer. get_brand_details takes a brand id and needs no Google Ads account. |
Google Ads write tools (the AI assistant plan or a paid-ads plan, plus Also allow changes or a write API key)
Without a Groas plan only some of the tools in this guide are offered: see Without a Groas plan in section 6.
| Tools | Use them to |
|---|---|
set_campaign_budget · set_campaign_bidding · set_ad_group_target_cpa · set_bid_modifier | Change budgets, the bidding strategy and its targets, max CPC, an ad group's own target CPA, and bid adjustments by device or location. |
update_campaign_settings | Change where, when, in which languages and on which Google networks a campaign shows, and set its EU political ads declaration, without which Google Ads refuses most changes to the campaign. |
set_status · rename | Pause or switch back on campaigns, ad groups, ads and keywords, and rename campaigns and ad groups. |
remove_campaign · remove_ad_group · remove_ad · remove_keyword | Remove them; a removed campaign or ad group is gone for good (see section 7). |
add_keyword_to_ad_group · move_keyword_to_ad_group · move_keyword_to_negative · change_keyword_match_type · set_keyword_bid · set_keyword_final_url · negate_search_term | Add or move keywords, change their match type, give one keyword its own bid or landing page, and block search terms. |
create_negative_keyword_list · update_negative_keyword_list · attach_negative_keyword_list · detach_negative_keyword_list | Keep lists of blocked searches that several campaigns share. |
create_ads · update_ad · regenerate_ads | Add ads, edit an ad's text, or have Groas rewrite one ad or every ad in an ad group. |
create_ad_assets · update_ad_asset · unlink_ad_assets · update_asset_group_text_assets | Add, edit or stop sitelinks, callouts and other assets, and change Performance Max headlines and descriptions. |
attach_audience_to_ad_group · remove_audience_from_ad_group · set_ad_group_audience_targeting_mode | Target, observe or exclude audiences. |
create_campaign_from_scratch · create_demand_gen_campaign · create_pmax_campaign · create_ad_groups · create_asset_groups · supercharge_campaign · stop_campaign_management | Launch a new Search, Demand Gen (image ads on YouTube, Discover and Gmail) or Performance Max campaign, with images from your media library or image links; add ad groups to a Search campaign or asset groups to a Performance Max campaign you have, hand an existing campaign to Groas to manage, or take it back (it keeps running as it is). A Performance Max launch can hold several asset groups, each with its own landing page and search themes, and needs conversion tracking Google bids on. |
planGroasAction · decidePlannedAction | Schedule a pause, a switch back on, an ad rewrite or a keyword change for a later day, or approve or reject a change Groas planned. |
revertGroasActions | Undo earlier changes (see section 7 for what can be undone). |
create_brand · update_brand_and_offers | Create a brand with its first offer from details you give Claude (Groas saves them as given and writes none of it), or edit the guidelines and offer descriptions Groas uses when it draws images and writes ads. Neither needs a Google Ads account. |
remove_negative_keyword removes one campaign or ad-group exclusion, including negatives added outside Groas. Ask Claude to read the current negative keywords first and remove only the ones you name. Undo re-adds the same exclusion; other exclusions may still block those searches. For shared lists, use update_negative_keyword_list instead.
What to know before letting Claude change Google Ads:
- Changes are live at once. Every write tool changes the live Google Ads account, and budget and bid changes affect spend from the next auction.
- A campaign Groas manages uses credits on the AI assistant plan. After
supercharge_campaign, Groas looks after the campaign every day and charges for it once a day: about 17 credits a month for a Search campaign, 2 for Performance Max and 1 for Demand Gen. With no credits left Groas stops making changes and the campaign keeps running as it is.stop_campaign_managementends it. See Credits in section 6. - New campaigns spend.
create_campaign_from_scratch,create_demand_gen_campaignandcreate_pmax_campaignlaunch on the daily budget you agree, andsupercharge_campaigncan switch a paused campaign back on. - Removing a campaign or ad group is permanent. Claude only removes one after you ask for that explicitly; pause it instead if you might want it back.
- Planned changes happen without a second look. A change planned with
planGroasAction, or one Groas planned that you approve, is made on its day as planned. Withdraw it on the plan card in the Actions tab in Groas.
Some example prompts:
- "Compare cost per conversion across my campaigns for the last 30 days."
- "Which search terms spent more than $50 without converting this month?"
- "What did Groas change in the Brand campaign last week, and why?"
- "Run the conversion tracking audit and summarise the top issues."
Organic read tools (every connection)
Call groas_list_brands, then pass one of its returned id values as brandId. All names below have the organic_ prefix, for example organic_getBrandContext.
| Area | Tools (after the organic_ prefix) |
|---|---|
| Brand | getBrandContext, listOrganicAlerts, listOffers |
| Competitors | listCompetitors, competitorAds, competitorAdTrends, competitorSearchRanks, competitorLandingPages, exportCompetitorData |
| Customer research from Reddit | listOfferResearchInsights, listOfferResearchRuns, getOfferResearchReport, searchRedditArchive, listRedditCaptures, getRedditEvidence |
| AI visibility | aiVisibilityTrend, listTrackedPrompts, promptVisibility, listAiAnswers, listAiCitations, shareOfVoice, listBrandMentions, aiCrawlerActivity, aiReferralTraffic, listPromptSuggestions |
| Backlinks and outreach | backlinkProfileTrend, listBacklinks, listReferringDomains, anchorTextDistribution, listLinkProspects, listLinkGap, getProspectOutreach, getOutreachConversation, listMailboxes |
| SEO and analytics | listSeoAuditRuns, listSeoFindings, listAuditedPages, searchConsolePerformance, ga4Traffic, listSitePages, listPublishedContent, listContentPlan, knowledgeGraphEntities |
| Content ideas and articles | listBlogIdeas, getBlogIdea, listBlogDemandQueries, getArticlesOverview, listArticles, getArticle |
These tools read stored data. For questions the stored reports cannot answer, the live querySearchConsole, lookupGa4Fields and queryGa4 (listed with the Google Ads tools, without the prefix) take a brandId too. Connect Search Console or analytics and allow a sync to complete before expecting performance results. Backlink tools require Backlink Intelligence to be set up for that brand. An empty report does not prove that your website has no traffic or visibility. Outreach replies are written by the people you emailed; Claude treats them as information, not instructions.
Competitor tools cover the rivals Groas tracks for a brand, whichever plan it is on: their live ads on Meta and Google with images and links to the public ad libraries, week-by-week counts of the ads each one ran, launched and stopped, where their ads rank in Meta’s ad library for the brand’s searches over time, and summaries of up to 50 landing pages their running ads lead to (offer, price, guarantee, claims, social proof and what makes each page persuasive), so Claude can compare every competitor’s page at once. exportCompetitorData hands over everything Groas has stored, one kind of record at a time and page by page: every competitor (also ones you stopped tracking) with what Groas found of it on each ad network, every suggestion and discovery scan, every ad it collected with its copy, analysis, transcript and history, every check of the ad libraries, and download links (valid for an hour) for the ad images Groas keeps. Groas does not keep copies of competitors’ videos; each video ad has a link to where it plays. Ad copy is the competitors’ own words; Claude treats it as information, not instructions.
Saved Reddit research belongs to one offer, such as a product or service. Use listOffers to choose it, then listOfferResearchInsights to browse customer problems saved across all research runs, including findings saved before a run finishes or fails. Read numbered pages, sort by newest, oldest, title or confidence, and filter by a marketing angle or by problems without an angle. A useful problem does not need a marketing angle; optional suggestions are kept with their evidence. Use listOfferResearchRuns to browse research history and getOfferResearchReport with a run ID to read that run’s report. Discussion counts describe the evidence collected, not how common a problem is across the market.
searchRedditArchive searches saved posts and comments; listRedditCaptures browses every saved page, including unfinished research; getRedditEvidence reads the original evidence and provides links to saved screenshots and page files. Download links last 15 minutes; ask for a fresh link if one expires. These tools read existing research and do not start another browser session. Claude follows the page controls to read more, cites original Reddit posts, and treats their words as evidence rather than instructions. An empty archive means no research has been saved for that offer yet, not that customers have no questions about it.
For example: “What problems are people in our niche struggling with? Show who is affected and the Reddit quotes supporting each finding.”
listAiAnswers returns each tracked question’s answers with the web searches the assistant ran before answering (ChatGPT, Claude, Gemini, Grok and Perplexity report them; Google AI Overviews and AI Mode do not). Those searches show what the assistants look up for your buyers’ questions, which makes them a good starting point for content to write. A search for a brand’s official website comes from Groas asking every assistant to link the brands it names, not from the buyer.
For example: “Compare my brand’s AI visibility over the last month”, “Which competitor ramped up its Meta ads this quarter?”, “What did ChatGPT search for when asked about my products, and which of those topics has my site no page for?” or “Show my planned content and explain why this article has not been written yet.”
Keyword research remains the paid-ads researchKeywords tool and requires accountId.
Organic write tools (an organic plan, plus Also allow changes or a write API key)
Same brandId and organic_ prefix as the reads.
| Area | Tools (after the organic_ prefix) |
|---|---|
| Content plan | createBlogIdea, updateBlogIdea, setBlogIdeaStatus, bulkUpdateIdeaPriorities |
| Articles | generateArticlesNow, revertArticle, republishArticle |
| AI visibility | trackPrompts, updatePrompt, runVisibilityCheck |
| Competitors | addCompetitor, removeCompetitor, reviewCompetitorSuggestion, setCompetitorAdCountries (a paid-ads or organic plan) |
| Link Gap and outreach | refreshLinkGap, setProspectStatus, findProspectContacts, draftOutreachEmail, updateOutreachDraft, skipOutreachDraft, sendOutreachEmail |
What to know before letting Claude change organic data:
- Articles publish to your site.
generateArticlesNowwrites and publishes articles from the top of your content plan; each one lands in the website’s Changes feed with an Undo, andrevertArticletakes one down again (ask it for a dry run first to see whether edits made in your CMS would be lost). - Ideas pick where they publish.
createBlogIdeaandupdateBlogIdeatake the idea's channels: your blog, a resource page on your own website (in its design, within your daily allowance of new pages) or an LLM hub page for AI assistants. Claude picks the one that suits who the piece is for and tells you why. - Outreach email is real email.
draftOutreachEmailonly writes a draft.sendOutreachEmailsends it from your connected mailbox, only to a contact Groas found on the prospect’s site, and cannot be unsent; Claude asks you first. - Some changes spend from your plan. Tracked prompts are checked by paid AI answers,
runVisibilityCheckruns a check now, andrefreshLinkGapspends from the website’s monthly backlink data budget. - Retries are safe. Every organic write accepts an optional
idempotencyKey; a retry with the same key returns the first result instead of changing anything twice.
Sending several outreach drafts at once and outreach batches stay on the Backlinks page.
Meta ads tools (a connected Meta ad account)
Call groas_list_meta_accounts first and pass its id as metaAccountId.
| Tool | Use it to |
|---|---|
list_meta_campaigns · get_meta_campaign | See your Meta campaigns, their daily results, and what Groas and you did to each one. |
get_meta_campaign_results · get_meta_results_breakdown | Results per ad set and ad, or split by age, gender, placement or region. |
query_meta_insights | Ask Meta directly, in its Insights API's own terms, what the fixed reports do not cover: any metric, any level down to single ads, splits such as country, device or hour, and any period Meta keeps. |
get_meta_budget · set_meta_budget | Read and change a campaign's budget, or each ad set's when the campaign gives them their own. |
set_meta_status | Pause or resume a campaign, an ad set or a single ad. |
list_meta_ads · replace_meta_ad_creative_text | Read the headline, primary text and description of every ad in an ad set, and change them on one ad. Meta cannot edit an ad's text in place, so the ad gets a new creative with the new text: Meta reviews it again, and its likes and comments start over. |
get_meta_ad_set_settings · set_meta_ad_set_bidding | Read an ad set's budget, bidding, optimization, schedule and targeting, and change its bid strategy, cap or ROAS floor and its dates. |
duplicate_meta_ad_set · create_meta_ad_set | Copy a working ad set with a new audience, country or budget, or build one from scratch. Both are made paused unless you ask for them on. |
create_meta_audience | Build an audience to target or exclude: people who visited your website (all of them, buyers only, or visitors of some pages), or a lookalike of buyers in one country. Meta fills it over the next hours; it reaches nobody until an ad set uses it. |
create_meta_campaign | Start a new, empty campaign: its name, what it is for, and optionally one budget shared by its ad sets. Made paused unless you ask for it on; then add an ad set and ads to it. |
import_image | Save one of your own photos from a link into a brand's media library, so it can run as an ad or be what Groas draws new images from. |
list_meta_pixels · list_meta_audiences · search_meta_targeting | Find the pixel, custom and lookalike audiences, interests and places a new ad set targets. |
supercharge_meta_campaign · stop_meta_campaign_management · start_meta_creative_test | Have Groas manage a campaign's creative tests and daily spend pauses, stop that, or start a new creative test now (uses creative credits). |
list_meta_ad_sets · list_media_videos · list_media_images | Find an ad set (read live from Meta) and a video or photo in your brands' media libraries. |
add_video_to_meta_ad_set · get_meta_video_ad | Put a media library video into an existing ad set as a new live ad, then follow its upload. |
add_images_to_meta_ad_set · get_meta_image_ad | Put media library photos, or images Groas drew for you, into an existing ad set, one new live ad each, then follow the upload. |
list_souls · generate_video · get_video | Draft a video for a brand, presented by one of its Souls or in a scene Groas draws, review and make it on its page in Groas, then follow it into the media library. |
find_top_tiktok_videos · get_saved_tiktok_rankings · remake_video | Find the TikTok Shop videos with the most views, likes and comments for products like yours, read the rankings Groas kept of earlier searches, and draft a remake of one with your own photos. |
generate_images · get_images | Draw new ad images for a brand into its media library (0.1 credit an image on the AI assistant plan; on a Groas plan 24 images cost 1 creative credit), then put the ones you pick into an ad set. |
Every change needs write access, as in section 6. A new ad runs as the Facebook Page of an ad already in the ad set and copies its link and button; your existing ads, budget and targeting stay as they are. To add a video or photo that is not in Groas yet, upload it to the brand's media library first, or have Groas make the video: generate_video writes a draft for free and Claude gives you a link to it in Groas. There you read what the presenter says, check the opening picture, every prompt and the price, and press Make this video. Nothing is made or charged before you press it, and Claude cannot press it for you. Ask Claude for changes and the same page shows the new version within 30 seconds (or press Refresh now). Give it the presenter's exact words as a script and they are said word for word. New photos are cheaper: generate_images draws them straight away (0.1 credit an image on the AI assistant plan; on a Groas plan 24 images cost 1 creative credit), and Claude puts the ones you pick into an ad set, even in the same request ("draw 6 image ads and add numbers 2 and 4 to my Broad ad set"). A whole new campaign takes three steps Claude can do in one go: create_meta_campaign, create_meta_ad_set in it, then the images.
ChatGPT ads tools (a connected ChatGPT ads account)
Connect your OpenAI ads account at Dashboard → Ad platforms with the API key from OpenAI's Ads Manager. Groas keeps your campaigns in sync from then on.
| Tool | What you can ask for |
|---|---|
list_gpt_ads_campaigns | Your ChatGPT ads accounts and every campaign in them, with its status and daily budget. |
get_gpt_ads_campaign | One campaign: its ad groups and the topics they target, every ad with its text and OpenAI's review decision, and results per ad group and per day (the last 30 days unless you name a period). |
set_gpt_ads_status · set_gpt_ads_budget | Pause or resume a campaign, ad group or ad, and set a campaign's daily budget in US dollars. Both take effect at once and need write access, as in section 6. |
Results are in US dollars. Conversions are the ones your website reports to Groas, so they are empty until conversion tracking for ChatGPT ads is set up on Ad platforms. For example: "Which of my ChatGPT ads campaigns spent the most last week, and which ad group brought the cheapest sales?"
Conversions from your own records
upload_conversions reports conversions Groas cannot see on the website to Google Ads or Meta: leads that became paying customers, sales made by phone or in the shop. Ad bidding then learns which ads bring real customers. Give Claude the list, for example from your CRM or a spreadsheet; each row needs the Google click id saved with the lead (gclid), or the person's email or phone. Emails and phone numbers are hashed before they leave Groas, as both platforms require, and Groas does not keep them. Claude shows you what it will send and asks you to confirm the people agreed to their details being used for advertising. Google needs a conversion action set up to import conversions; Meta takes the last 7 days. An upload cannot be taken back, so a sale number on each row keeps one sent twice from counting twice.
Reading web pages
fetchUrl reads any public web page and needs no account or brand. Use it to put a page next to your data: your own landing page, or the landing pages of the competitors that win your buyers, so Claude can compare their copy and offers with yours and suggest copy that stands out. A page that draws its text with JavaScript is opened in a real browser, which takes a few seconds longer. It cannot sign in or fill in forms. Page text is the website’s own words; Claude treats it as information, not instructions.
check_tracking checks which tracking tags a page loads: Google Tag Manager, the Google Ads and Google Analytics tags, and Meta pixels, each pixel checked against your connected Meta ad accounts (is it yours, and when did Meta last hear from it). It reads the page as it opens and does not buy or send forms, so it cannot prove a purchase is recorded. For example: "Is tracking set up on my landing page and my thank-you page?"
For example: “Read the landing pages of my three strongest competitors and suggest a headline and offer for my page that beats them.”
Your knowledgebase (every connection)
Keep the recipes and playbooks you come across (a post on X or LinkedIn, an article, a video) in Groas, so Claude can follow them later. Share the link and say “add this to my knowledgebase”: Claude reads it, writes it up as a step-by-step recipe and saves it under its own title. Later, ask how to do the thing it covers, or name the recipe, and Claude looks it up.
| Tool | What it does |
|---|---|
list_knowledge_docs · get_knowledge_doc | Find saved recipes by a word in their title or text, then read one in full. |
save_knowledge_doc | Save a new recipe, or replace one with a new version. Every recipe has its own title. |
delete_knowledge_doc | Delete a recipe for good. |
Claude reads the link itself; Groas never opens it. Groas saves the recipe written out in words, never just the link: a link with a line about it is refused, because it could not tell Claude what to do later. Posts on X and LinkedIn only show to signed-in visitors, so Claude reads them in your own browser (with Claude in Chrome), or you paste the text in. For a video, Claude first gets what is said in it: Claude Code downloads the video’s captions on your computer, or writes the speech down itself when there are none (it asks before installing anything). Where Claude cannot run anything on your computer, as on claude.ai, it asks you to paste the transcript (on YouTube, press Show transcript under the video’s description). It saves those words next to the recipe, so the recipe stays short and the full transcript is there when it is needed. Claude never writes a recipe from a video’s title alone. Saving and deleting recipes works on every connection, read-only ones included: your knowledgebase only holds notes for your AI and changes nothing in your ad accounts or on your website. There is no limit on how many recipes you keep.
For example: “Add this to my knowledgebase: https://x.com/…”, then later “Use my landing page history recipe on my top competitor.”
6. Write access
Two ways to let a client make changes:
Sign-in with the write opt-in. When the client asks for write access (Claude does), the Groas consent screen shows an Also allow changes checkbox, off by default. It is available to accounts with a plan (or lifetime access); accounts without one stay read-only, and the consent screen links to the AI assistant plan. What the box unlocks follows your plan: Google Ads and Meta ad changes need the AI assistant plan or a paid-ads plan, organic changes need the organic plan. Groas re-checks the plan on every change, so a lapsed or downgraded plan stops changes immediately. To go back to read-only, remove the connector and connect again without ticking the box.
Without a Groas plan: free, or the AI assistant plan
Without a Groas plan, Groas connects Claude to your own Google Ads, Meta and ChatGPT ads accounts.
- Free (no plan): Claude gets the tools that read those accounts: campaigns, ad groups, ads, keywords, search terms, results, settings, audiences, keyword research, audits and the log of changes. It cannot change them.
- AI assistant plan: the same, plus the tools that change what is in those accounts: budgets, bidding, campaign settings, keywords and negative keywords, ads and assets, audiences, new campaigns, ad groups and asset groups, Meta budgets, ad sets and ad text, ChatGPT ads budgets, pausing, removing, and undoing changes made through Groas. It also comes with credits every month, which pay for the work Groas does for you (see Credits below): Groas managing a Google Ads campaign, and image ads.
Both keep fetchUrl, check_tracking, your knowledgebase and your website's Search Console and Google Analytics data (list_search_console_and_ga4, querySearchConsole, lookupGa4Fields, queryGa4). For those, connect the Google account that owns your website data at Dashboard → Ad platforms → Google Ads tab → Search Console and Google Analytics. It is a separate sign-in from Google Ads, and Groas only asks Google for permission to read.
Both keep a brand, free: your business, its voice and what it sells. Claude creates it with you (create_brand): it asks about your business, reads your website, shows you what it wrote and saves it once you agree. Groas saves exactly that, copies your website's photos so the images show your real products, and does nothing else with the brand. groas_list_brands, get_brand_details and update_brand_and_offers read and edit it later, on a read-only connection too. You can also add a brand yourself under Brands.
Credits. The AI assistant plan gives you credits every month: 10 at $19, 90 at $49, 200 at $99, 420 at $199, 660 at $299, 920 at $399, 1,200 at $499 and 1,500 at $599. Work Groas does for you takes credits; reading and changing your ad accounts through Claude costs nothing. get_credit_balance tells Claude how many you have left, when they renew, when they would run out at the current pace and what things cost, and list_credit_usage is your billing history: one line per campaign per day. You see the same on Billing, where you also move to another plan, buy a top-up ($1 a credit, valid for 90 days) or turn on auto top-up, which buys the number of credits you choose whenever they fall below your minimum. Plan credits are used first and do not roll over. With no credits left, Groas stops making changes and your campaigns keep running as they are until the plan renews or you top up.
Optional work. Four more things Groas can do on the AI assistant plan, each off until you ask for it, paid from your credits as the work is done, and stopped when your credits run out. Tell Claude what you want and how much, and set_optional_work turns it on, for your whole account or for one brand; set it to 0 to turn it off. You can do the same on Billing, and when you first sign up.
| Work | What Groas does | You choose | It costs |
|---|---|---|---|
| Tracking in AI assistants | Asks ChatGPT, Claude, Gemini, Perplexity and Google the questions your buyers ask, every week, and records whether they recommend you. Groas picks the questions, including some you should already appear for. | How many questions to track | 0.25 credits a check on ChatGPT, 0.12 on Claude, 0.01 on the others: about 1.8 credits a question a month |
| Competitor ads | Finds your competitors and collects the ads they run on Facebook, Instagram and Google, with the pages those ads lead to. | How many competitors to track | 0.03 credits a day for each competitor, about 0.9 a month |
| Customer research on Reddit | Reads public Reddit discussions about what you sell and saves the problems customers describe, in their own words. | How many new insights to find a month | 0.05 credits for each insight found, nothing when none is found |
| Top TikTok videos | Searches the TikTok Shop videos that sell your brands' products best, spread over the month, and keeps every ranking: get_saved_tiktok_rankings reads them, find_top_tiktok_videos searches now. | How many searches a month | 0.25 credits a search |
Work starts within a day of turning it on. Read what it found with the AI visibility, competitor and customer research tools above.
Two things use credits today:
- A Google Ads campaign Groas manages.
supercharge_campaignhands a Search, Performance Max or Demand Gen campaign to Groas, which then looks after its keywords, search terms, ad copy and budget every day. It is charged once a day: about 17 credits a month for a Search campaign, 2 for Performance Max, 1 for Demand Gen.listPlannedActionsshows what Groas plans for the campaign,decidePlannedActionis your yes or no, andstop_campaign_managementtakes the campaign back. - Image ads. Groas draws new ad images showing your real product (
generate_images,get_images) at 0.1 credit an image, and Claude puts the ones you pick into a Meta ad set as new ads (add_images_to_meta_ad_set,get_meta_image_ad,list_media_images). An image that cannot be drawn costs nothing. Your own photos go in withimport_image, free, and the links of drawn or saved images also work as the images of a new Google campaign.
On this plan Claude also reads the brand's website through Groas: its profile and offers (organic_getBrandContext, organic_listOffers), the pages Groas found on it (organic_listSitePages), its Search Console and Google Analytics by day (organic_searchConsolePerformance, organic_ga4Traffic) and the searches worth writing for, from your ads and Search Console (organic_listBlogDemandQueries).
Everything else in this guide is not offered without a Groas plan: the other organic tools (organic_…), such as AI search visibility, SEO audits, backlinks and articles, videos made by Groas and adding videos to Meta ad sets (generate_video, remake_video, add_video_to_meta_ad_set), regenerate_ads (Claude writes ad copy itself with create_ads and update_ad), and Meta campaigns managed by Groas (supercharge_meta_campaign and the creative tests). To get any of this, email support@groas.ai about a Groas plan. A free account has no credits, so no images and no managed campaigns: they come with the AI assistant plan.
API key. Keys are not tied to the consent screen and work in any client:
- In Groas open Account settings → API Keys and create a key with the
writescope. Keys start withgrs_live_. - Send it as a bearer token:
claude mcp add --transport http groas https://mcp.groas.ai/mcp \
--header "Authorization: Bearer grs_live_…"
A key with only the read scope is read-only, apart from your knowledgebase and, without a Groas plan, your brand. A write key needs the same plan as the sign-in route: the AI assistant plan or paid ads for Google Ads and Meta changes, organic for website changes. Groas checks the plan on every change, so a key stops making changes when its plan ends and works again once it is renewed. Rotate or delete keys in the same settings page; a deleted key stops working immediately.
7. Permissions, safety and privacy
- Read-only by default. Nothing in your Google Ads or Meta ad accounts or on your website changes unless you tick Also allow changes at sign-in or deliberately use a write-scoped key, and either way only with a plan that covers the change. Your knowledgebase is the one thing every connection can change, because it only holds your saved recipes; without a Groas plan, so is your brand, which then only holds what you told Claude about your business.
- Every change is recorded. Mutations made through MCP appear in your Groas audit trail, attributed to the user (and API key, if any) that made them. Google Ads changes also appear in List Groas actions; content plan, article and outreach changes appear in the website’s Changes feed, content plan changes marked as made by a connected AI app; Meta changes (budgets, pauses, bidding, new and copied ad sets, new ads) appear in that campaign's history in Groas, marked as made through an AI app connected to Groas.
- Most changes can be undone; a few cannot. Budget, bidding, targeting, keyword, ad, asset, audience, rename and pause or switch-on changes in Google Ads have a one-step Undo (
revertGroasActions, or Undo in the Groas dashboard). These do not:- Creating a campaign or supercharging one: there is no earlier state to return to, and both can start spend. Stop either by pausing the campaign (
set_statusor the Groas dashboard).- Removing a campaign or an ad group: Google Ads removes it for good, and its name stays taken. A removed keyword or ad can be put back, but the ad comes back as a new ad without its past results.
- Editing brand guidelines and offers: Claude gets the previous text back and can save it again, but there is no one-click Undo.
- Meta changes have no one-click Undo. The campaign's history in Groas records each one with what it was before, so it can be changed back by hand: a budget or bid set back, a paused ad set resumed. A new ad or ad set is stopped by pausing it (
set_meta_status) or deleted in Meta Ads Manager.
- Creating a campaign or supercharging one: there is no earlier state to return to, and both can start spend. Stop either by pausing the campaign (
- Claude asks before changing anything. Write tools are marked destructive, so Claude confirms each call with you; read tools run without prompts.
- Website changes. Published articles can be taken down again with
revertArticleor from the Changes feed. A sent outreach email cannot be unsent. - Scope. The server only reaches the Google Ads accounts, Meta ad accounts and brands owned by your Groas account.
- Rate limit. 600 requests per minute per credential.
- Disconnecting. Remove the connector in Claude (Customize → Connectors) to discard its tokens, or delete the API key in Groas. Access tokens expire after one hour.
- Data. Requests are processed by Groas under the Groas privacy policy. The server does not read your Claude conversations, memory or files; it only receives the tool calls Claude makes.
8. Troubleshooting
| Symptom | Fix |
|---|---|
| "No Google Ads accounts are connected" | Connect one at Dashboard → Ad platforms, or on your setup page while your account is being set up for a Groas plan, and wait for the first sync to finish. |
| Write tools are missing or refused | The connection is read-only: you did not tick Also allow changes, the plan for that kind of change (the AI assistant plan or paid ads, or organic) is not active, or the key lacks the write scope. The refusal names the plan the change needs and the page that sells it; see section 6. Without a Groas plan only the ad-account tools are offered, and without any plan only the ones that read; see section 6. On a read-only connection, ask your assistant how to allow changes: its groas_how_to_make_changes tool answers with the steps, such as upgrading to the AI assistant plan. |
| "Invalid or revoked API key" | The key was deleted or mistyped. Create a new one and update the header. |
| Sign-in window says the consent token expired | Start the connection again from the client; consent links are short-lived. |
| HTTP 429 | Rate limit reached. Wait a minute or spread work across credentials. |
| Connector shows as "Custom" after an update | Remove it and add Groas again from the directory. |
Still stuck? Email support@groas.ai with the client you are using and the exact error text.