Skip to content

Step-by-step guide

How to use GoMarble: turn your ad accounts into an AI brain

What GoMarble does, how Brand IQ learns your brand, every way to connect it to Claude and Slack, and the prompts I use to audit, report and check competitors.

On this page

GoMarble is an AI analyst for your paid ads. You connect your Meta, Google and TikTok ad accounts, plus your store and email data, then ask it questions in your own words. It tells you what's working, why your costs moved and what to change next. On the higher plans it can make those changes for you, but only after you approve them.

It's built for people who run ads without a full-time data analyst: small business owners, media buyers, creative strategists and agencies.

What GoMarble does

Answering "why did my ads get worse this week?" usually means opening Ads Manager, Google Ads, Shopify and a spreadsheet, then lining the numbers up yourself. GoMarble reads all of them at once. You get the answer, the evidence behind it and the next step.

It does the job of a stack of separate tools:

JobWhat people usually useWhat GoMarble does
Pulling numbers from every ad accountSupermetrics, Looker Studio, spreadsheetsYou ask a question and it pulls the numbers
Working out why an ad winsMotion, AtriaBreaks each ad into its hook, message and visuals
Checking competitor adsMeta Ad Library, Foreplay, AdSpySearches 200M+ ads and groups the patterns
Client and team reportsHours of screenshots and slidesWrites the report and sends it to Slack or email on a schedule
Making changes in the accountClicking through Ads ManagerPrepares the exact change and waits for your approval

How GoMarble becomes your AI brain

Ask ChatGPT or Claude about your ads and they start from zero. They only know what you paste in, so you get generic best practice.

GoMarble keeps a memory of your brand called Brand IQ. It starts building when you connect your accounts and finish setup, and it keeps learning as new data comes in. You don't fill anything in.

What it learnsWhere it learns it from
Who buys from you and what you sellYour website and ad accounts
What your winning ads have in commonYour top-spending ads and their results
What a normal week looks like for your accountYour Meta, Google and GA4 history
Your goals, spend limits and approval rulesThe targets you set during setup
How your brand soundsYour website, briefs and approved ads
What competitors are testingTheir live ads

Here's why that matters. Say your ROAS (return on ad spend, the revenue you get back for every dollar on ads) drops 20% on a Monday. That could be normal for your account, or it could be a real problem. Brand IQ knows what your normal looks like, so GoMarble can tell the difference before it suggests a change. When it writes a creative brief, it builds on your own winning hooks instead of whatever works for everyone else.

Brand IQ also comes with you when you use GoMarble inside Claude, ChatGPT or Slack, so every answer starts with that background. It comes with the Operator plan and above.

The main features

FeatureWhat it does for you
Ask your dataChat with every connected account at once. "Which campaign brought in the most new customers last month?"
Performance diagnosisFinds what changed and traces it to the exact campaign, ad or search term behind it
Creative analysisRanks every ad by spend, ROAS, CPA (cost per sale), hook rate and hold rate, then breaks down why the winners win
Pre-flight checkUpload a new image or video before you spend on it and get feedback on the hook, message, offer and call to action
Competitor researchAn ad library you can talk to. Search 200M+ ads across Facebook, Instagram, TikTok, YouTube and LinkedIn by buyer, pain point or brand
DashboardsDescribe the view you want and it builds it, keeps it updated and answers questions about it
ReportsWritten reports with charts and recommendations. Edit them with AI, export to PDF, PowerPoint or Word, and schedule them
AgentsAI teammates that each watch one job, like budget pacing or tired ads, and report back in Slack or email
Campaign changesLaunch campaigns, upload ads, adjust budgets, pause ads and manage keywords, all waiting on your approval (Operator and above)

Hook rate is the share of people who watched the first 3 seconds of a video ad. Hold rate is how many of those kept watching. Together they tell you if the opening stopped the scroll and if the rest held attention.

Nothing changes without your yes

This is the part that makes it safe to plug into a live ad account. For every agent, you set each action to one of three modes:

ModeWhat happens
AllowIt does low-risk work on its own, inside the limits you set
AskIt prepares the exact change and waits for you to approve it
BlockIt can never take that action

You can also cap how much budget an agent can move, limit it to certain accounts and give it a named manager. Every change is logged with who approved it, so you can always see what happened.

How to connect it

Step 1: Sign up and connect your accounts

  1. Sign up at apps.gomarble.ai with Google or your email.
  2. Connect your ad accounts. GoMarble uses Meta's and Google's own sign-in screens, so you never hand over a password, and you choose which accounts it can see.
  3. Connect your store and email platforms too, like Shopify, Klaviyo and GA4. This lets it judge your ads by real sales, not only what Meta reports.
  4. Finish setup and confirm your goals, like your target cost per sale. Brand IQ starts learning straight away.

Here's what you can connect:

TypeExamples
Ad platformsMeta, Google, TikTok, LinkedIn, Microsoft (Bing), Pinterest, Snapchat, Reddit, Amazon
Store and emailShopify, WooCommerce, BigCommerce, Klaviyo, Mailchimp
Website analyticsGoogle Analytics 4, Google Search Console, Mixpanel, PostHog
CRM (your customer and sales records)HubSpot, Salesforce, GoHighLevel, Close
CreativeMeta Ad Library, Foreplay, Higgsfield, Air
DataGoogle Sheets, Snowflake, BigQuery
Where it reportsSlack, Gmail, Microsoft Teams, Notion

Copilot includes 10 connectors and Operator and above include 80+. A few in GoMarble's directory are still marked "coming soon", so check gomarble.ai/integrations for the one you need.

Step 2: Choose where you talk to it

You don't have to live in the GoMarble app. It has an MCP server (a connector that lets AI apps like Claude use it), so the same accounts and Brand IQ follow you into the apps you already use.

WhereBest for
GoMarble appDashboards, reports, creative analysis and approving changes
Claude (website, desktop or phone app)Asking about your ads alongside the rest of your work
Claude CodeRunning GoMarble's free audit skills and building your own automations
SlackAsking @GoMarble in a channel and approving changes in the thread (Operator and above)
ChatGPT, Cursor, n8n and other AI appsTeams that already work there
EmailScheduled reports landing in your inbox

I do most of my work in the GoMarble app itself, because that's where the dashboards, reports and approvals live. The other options are handy when you're already working somewhere else.

The MCP connection is included on every plan. Questions you ask through Claude or ChatGPT still use your GoMarble credits.

Connect GoMarble to Claude

You need a paid Claude plan for this.

  1. In Claude, open Settings, then Connectors.
  2. Click Add custom connector.
  3. Call it GoMarble and paste this as the URL: https://apps.gomarble.ai/mcp-api/mcp
  4. Click Connect, sign in to GoMarble and choose the workspace and ad accounts Claude can use.
  5. Start a new chat and paste the prompt below. Click Allow when Claude asks to use the GoMarble tools.
Prompt
Using GoMarble, give me a quick health check of my [META / GOOGLE] ad account for the last 7 days. What changed compared with the week before, and what's the one thing I should look at first?

Once it's connected on the website, it works in the Claude phone app too. On a Team or Enterprise plan, a Claude workspace owner has to add the connector first.

Connect GoMarble to Claude Code

Open your terminal (the text window where you run Claude Code) and paste this:

Command
claude mcp add --transport http gomarble https://apps.gomarble.ai/mcp-api/mcp

Then start Claude Code, type /mcp, pick gomarble and sign in. You only do this once.

Add GoMarble's free skills to Claude

Skills are instruction files that teach Claude how to do a specific job. GoMarble has two free ones, for Meta Ads and Google Ads, that teach Claude to audit an account the way a senior media buyer would. They work best with the GoMarble connection, but they also work with a CSV export, a screenshot or a pasted table if you haven't connected anything.

Paste this into Claude Code to install them:

Prompt
Install the GoMarble paid media skills from https://github.com/gomarble-ai/gomarble-ai-paid-media-claude-skills by running: npx skills add gomarble-ai/gomarble-ai-paid-media-claude-skills

Then try one:

Prompt
Run a Meta Ads audit for the last 30 days. Find what changed, what's wasting spend, which creatives are getting tired, and what I should do next.
Prompt
Run a Google Ads audit across Search, Shopping and Performance Max. Find wasted spend, sort the search terms into keep and exclude, and tell me what to do next.

Add GoMarble to Slack

Slack is on Operator and above.

  1. In GoMarble, open Settings, then Apps, and connect Slack.
  2. Approve it for your Slack workspace, then follow the welcome message to pick a channel.
  3. Mention @GoMarble in that channel, or message it directly.
Prompt
@GoMarble where is broad match wasting spend this month?

When it suggests a change, like a list of keywords to block, you approve it right there in the thread.

ChatGPT, Cursor and n8n

They use the same address: https://apps.gomarble.ai/mcp-api/mcp. Add it as a custom connector or MCP server and sign in when asked. ChatGPT needs a work plan for custom connectors. If an app asks for an API key instead, make one in GoMarble under Settings, then API keys. Never paste it into a chat.

How I use it every day

These are the jobs I use GoMarble for most. Swap the highlighted parts for your own details.

1. Audit my ad accounts

I check my accounts every day to see what did and didn't work. The trend reports are what keep my calls accurate.

Prompt
Audit my [META / GOOGLE] ad account for yesterday against the last 7 days. What improved, what got worse, and why? Rank the top 3 things I should fix today, with the exact change for each. Don't make any changes yet.

2. Find winning creatives and hooks in seconds

This is really useful on accounts with hundreds of live ads, where nobody can watch them all.

Prompt
Rank my Meta ads from the last 30 days by [ROAS / CPA]. For the top 5, break down the hook in the first 3 seconds, the message and the visuals. What do the winners have in common, and which ads are starting to get tired?

A "tired" ad (GoMarble calls it fatigue) is one people have seen too many times, so it stops working.

3. Pull key numbers across every account

Great when I need Meta, Google and Klaviyo side by side. The platforms each take credit for the same sale, so seeing them together gives a truer picture.

Prompt
Show me spend, revenue, ROAS and new customers for last month across Meta, Google and Klaviyo, side by side. Which channel brought in the most new customers for the money?

4. Turn the data into graphs people understand

Especially helpful for teams and clients who don't live in Ads Manager.

Prompt
Build a dashboard for [ACCOUNT NAME] that tracks daily spend, ROAS and CPA for the last 30 days, plus my top 5 ads by spend. Add a short note on what changed this week.

5. Build reports in minutes, then put them on autopilot

I have automations set up for all my clients, so they get a weekly and a monthly digest without me building them.

Prompt
Write a weekly performance report for [CLIENT NAME] covering [META AND GOOGLE]. Lead with what changed and why, then the top ads, then 3 recommendations for next week. Keep it short enough to read in 2 minutes.

When you're happy with it:

Prompt
Send this report to [EMAIL / SLACK CHANNEL] every Monday at 9am with the latest data.

6. Know where to move budget

It recommends where to shift budget across the whole funnel, from the ads that introduce you to new people through to the ones that close the sale. That way the money goes where it's working.

Prompt
Where can I move $[AMOUNT] a week across my campaigns without pushing my cost per sale above $[TARGET]? Show what to cut, where to add and why. Don't make any changes yet.

7. Check out competitor ads

I love this one. I see what's working for competitors and find the gaps we're missing.

Prompt
Find ads from [COMPETITOR NAMES, OR YOUR CATEGORY] that have been running for 30+ days. Group them by angle and hook. Then compare them with my best ads and give me 3 gaps worth testing.

GoMarble can't see a competitor's sales. It judges a winner by how long the ad has been running and how many versions they've made of it.

8. Pull out winning frameworks to reuse

A winning ad formula can make a huge difference, and this speeds up finding yours.

Prompt
Look at my top 10 ads from the last 90 days and pull out the framework behind them: the hook type, the structure, the proof and the offer. Then write 3 new ad scripts for [PRODUCT] that follow the same framework.

Start with a ready-made template

If you don't know what to ask first, start with one of GoMarble's ready-made templates:

TemplateWhat you get
Audit my Meta AdsA review of your account setup and spend, with fixes ranked by impact
Budget Leak CheckCampaigns, ad sets and keywords spending without enough return
Are my creatives fatigued?The exact ads losing attention, and when it started
E-Commerce Weekly ReportSpend, sales, ROAS, orders and top products in one weekly report
CMO Daily BriefA daily snapshot of only the numbers that moved
Competitor Intelligence ReportNew competitor ads and the gaps worth testing
Creative Fatigue MonitorAn agent that watches your live ads and warns you in Slack before they tire

Which plan you need

Prices are in US dollars. Annual billing saves about 15%.

PlanPriceMonthly ad spendWhat you get
FreeFreeUp to $50K1 ad account per platform, 1 seat, 1 read-only agent and 100 one-off credits. No card needed
Copilot$139/moUp to $50KAudits, creative analysis, competitor research and scheduled reports. 5 ad accounts, 1 seat, 1,000 credits a month. It reads your accounts but never changes them
Operator$399/moUp to $500KEverything in Copilot, plus Brand IQ, approved changes, Slack, white-label reports and a shared team workspace. 15 ad accounts, 5 seats, 2,000 credits a month
Scale$799/moUp to $1.5MApproval policies, control over who can act on each account, unlimited agents and guided onboarding. 40 ad accounts, 10 seats, 4,500 credits a month

Credits get used every time GoMarble does work, and big reports across lots of accounts use more. Unused credits don't roll over. You can top up at $100 per 1,000.

Copilot suits most small businesses that want the analysis and reports and are happy to make the changes themselves. Move to Operator when you want Brand IQ, Slack and agents that make changes once you approve them. I run a lot of client accounts, so I'm on one of the bigger agency plans.

Tips for better results

  • Read every suggestion for the first couple of weeks before you approve anything. You'll learn how it thinks and where it needs your judgement.
  • Add "don't make any changes yet" when you're only exploring.
  • Connect Shopify or your store, so it judges ads by real sales.
  • Set your targets during setup. Brand IQ uses them to decide what counts as a problem.
  • Start a template or prompt on one account, check the output, then roll it out to the rest.
  • Keep an eye on credits if you run lots of multi-account reports.

Troubleshooting

Will connecting AI to my Meta ad account get it banned?

In 2026 a lot of advertisers had Meta accounts shut down after connecting Claude straight to Meta with a personal developer token and letting it run changes overnight. GoMarble is a Meta-approved app that connects through Meta's normal sign-in, checks every change before it reaches Meta, and waits for your approval before it changes anything. GoMarble says none of its users have had a Meta-confirmed ban caused by it. Whatever tool you use, keep approvals on and avoid unofficial connectors that act on their own.

Claude can't see my GoMarble data

Check GoMarble is switched on in the connectors list for the chat you're in. If it is, open Settings, then Connectors, and click Connect on GoMarble again to sign back in. On a Team or Enterprise plan, a workspace owner has to add the connector first.

Sign-in fails or I see "Client not found"

Remove the GoMarble connector from your AI app and add it again with https://apps.gomarble.ai/mcp-api/mcp. If it still fails, log out of GoMarble in your browser, log back in and try again.

Can it change my campaigns without asking?

Not unless you set that action to Allow. Copilot and Free can only read your accounts. On Operator and above, each change is prepared for you to approve, inside the accounts and budget limits you set.

It stopped partway through a big report

You've probably run out of credits for the month. Top up in GoMarble and run it again, or split the report into one account at a time.

Quick recap

  1. Sign up through my link to get 7 days free
  2. Connect your ad accounts, store and email platforms, and set your targets
  3. Let Brand IQ learn your brand
  4. Connect it to Claude, Claude Code or Slack so you can ask from anywhere
  5. Run the daily audit prompt, then try the creative and competitor prompts
  6. Schedule your weekly and monthly reports
  7. Read every suggestion before you approve it

Follow me for more AI workflows

New guides and tools go out as short videos first. The write-ups land here.

From the library

  • GoMarble

    Marketing & Ads

    3.9

    An AI analyst for your ad accounts that explains what's working and lines up the fixes.

    Freemium
  • Claude

    AI Assistants & LLMs

    4.6

    Anthropic's chat assistant, at its best on careful writing and long documents.

    Freemium
  • Claude Code

    Coding & Dev Tools

    4.4

    An AI agent that works inside your project: it reads, writes and runs the code for you.

    Paid
  • Triple Whale

    Marketing & Ads

    3.8

    Pulls your store, ad and email numbers into one dashboard you can ask questions of.

    Freemium
  • Foreplay

    Marketing & Ads

    4.2

    Save competitors' ads, spot trends and turn them into briefs for your next creative.

    Paid

More free resources