Skip to main content
GoMarble MCP

GoMarble MCP - Overview

What GoMarble MCP is, which platforms it covers, how changes are approved, and what controls access.

Written By GoMarble

Last updated 7 days ago

What is GoMarble MCP?

GoMarble MCP lets you use GoMarble from AI assistants such as Claude, ChatGPT, Codex and Cursor. Once connected, the assistant can pull reports from your ad and analytics accounts, research competitors' ads, manage your GoMarble agents, and prepare changes to your campaigns for you to approve. It uses the same connected accounts, team permissions and plan as your GoMarble workspace.

Server URL: https://apps.gomarble.ai/mcp-api/mcp

Setup takes about two minutes. See How to connect GoMarble MCP.

Before you start

  • You need a GoMarble account. When you connect, sign in with the same email you use in GoMarble.

  • Connect your platforms in GoMarble under Settings → Integrations. Connections are shared with your GoMarble team, so a teammate's connection works for you too.

  • To make changes, the platform connection needs Write access. For Meta Ads, reconnect with write access. For Google Ads, switch the connection's access level to Write in Settings → Integrations. You don't need to sign in to Google again.

What you can do

Each article below covers one job: what to ask, what you need first, and every tool the assistant uses for it.

I want to…

Read

See how my Meta ads are performing and review creatives

Meta Ads: analyze performance and creatives

Launch, edit or copy Meta campaigns, ad sets and ads

Meta Ads: create, edit and copy ads

Report on Google Ads and research keywords

Google Ads: analyze performance and keywords

Launch Search or Performance Max campaigns, refresh creatives, edit bids and keywords

Google Ads: create and edit campaigns

Report on TikTok campaigns, audiences and ad reviews

TikTok Ads: analyze performance

Launch, edit or copy TikTok campaigns

TikTok Ads: create and edit ads (beta)

Report on LinkedIn Ads or Microsoft Advertising

LinkedIn and Microsoft Ads: analyze performance

Find competitors and see their ads

Competitor ads: research brands and their ads

Check Facebook Page and Instagram posts

Organic social: Facebook Pages and Instagram

Understand site traffic and search performance

Website analytics: GA4 and Search Console

Bring in sales, email or affiliate data

Store, email and affiliate data: Shopify, Klaviyo and impact.com

Query my warehouse or read my files

Your own data: Snowflake and Google Drive

Set up agents that run on a schedule

Creating Agents via MCP: Draft, Review, and Activate

Use GoMarble's memory and playbooks, or connect more data sources

Memory, skills and connectors

How changes work

Tools that change your campaigns have propose in their name. They never change anything on the first try:

  1. The assistant prepares the change. GoMarble checks it and saves it, but sends nothing to the ad platform yet.

  2. You review it. The assistant tells you exactly what will change and asks you to confirm.

  3. The assistant applies it. After you say yes, GoMarble checks the change again, applies it and reports back.

In GoMarble chat you approve with the Approve button on the change card instead.

A few tools act without a separate confirm step. They upload media to TikTok, save a file to Google Drive, or make a shareable copy of a Drive image or video. The assistant uses them only when you ask for that action.

New Meta ads are created paused, and copied TikTok campaigns start paused, so nothing starts spending until you switch it on.

What controls access

Three things decide what the assistant can do:

  1. What you allowed when connecting. When you connect, GoMarble asks what the assistant may access. Read access is available for each platform. Change access is available for Meta Ads and Google Ads. If the assistant later needs access you didn't give, it shares a link to add it.

  2. Your team permissions. Team owners and admins can reach every ad account. Members can only see and change the accounts an admin has granted them. Account lists only show accounts you can access.

  3. Your team's policies. If your team has set limits on what AI can change, for example no budget changes above a set percentage, changes outside those limits are refused. See Setting Agent Limits and Governance Policies.

Plans, credits and limits

  • Your plan's limits on ad spend and number of ad accounts apply the first time the assistant uses a new ad account.

  • AI creative analysis and competitor research use credits. See How AI Usage Limits Work in GoMarble AI.

  • Large Meta and TikTok reports run in the background. If a report isn't ready straight away, the assistant checks back for it.

  • Budgets and bids always use the ad account's own currency.