Hosting

Remote, hosted by GoMarble

Transport

Streamable HTTP

Endpoint

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

Authentication

OAuth sign-in with GoMarble account; connected integrations and workspace permissions govern data/action access.

Requirements

• GoMarble account
• Connect desired advertising/data sources in GoMarble integrations
• Claude Code, Codex, ChatGPT, or supported MCP client; OAuth browser login
• Free tier is documented read-only; write actions require a plan/access that supports them

Setup steps

1. Install the GoMarble plugin from its official marketplace in Claude Code or Codex; Codex then runs `codex mcp login gomarble`. For ChatGPT install official GoMarble plugin and sign in when prompted.
2. Authenticate with work email at apps.gomarble.ai and connect required ad accounts/data sources in Settings > Integrations.
3. Check team account permissions: View permits analysis; Act is required even to propose changes on that account. Turn on write access for the AI connection only if intended.
4. Use analysis/diagnostics first. GoMarble says changes are validated as dry runs and require approval; new campaigns start paused by default.
5. Refresh/reload the client if connector tools are missing. Remove an old custom `marketing-agent`/SSE connector if the new official plugin creates duplicates.

187 exact tool identifiers documented in official GoMarble MCP workflow articles. The roster reflects the published workflow set and may vary by connected platforms, permissions, plan, and feature availability.

• ads_library_analyze_ad

  Full details of specific ads, including duplicate versions, a sign that a brand is scaling an ad.

  01
• ads_library_discover_ads

  Searches ads across the whole library by keyword and filters.

  02
• ads_library_find_competitors

  Researches a brand from its website or name and suggests competitors and product keywords.

  03
• ads_library_get_ads_by_brand_id

  A brand's ads, live or past, filtered by format.

  04
• ads_library_get_brand_analytics

  A brand's ad stats and trends over a date range.

  05
• ads_library_search_brands

  Finds a brand by website domain or name.

  06
• bing_ads_get_change_history

  Account change history and its effect on performance.

  07
• bing_ads_get_performance

  Performance at account, campaign, ad group, keyword or ad level.

  08
• bing_ads_keyword_ideas

  Keyword ideas with search volume, competition and bids. Works for the US, UK, Canada, Australia, France and Germany, in English, French or German.

  09
• bing_ads_list_accounts

  Your Microsoft Advertising accounts. Start here.

  10
• bing_ads_list_ad_groups

  Ad groups in a campaign.

  11
• bing_ads_list_ads

  Ads in an ad group.

  12
• bing_ads_list_budgets

  Budgets in an account.

  13
• bing_ads_list_campaigns

  Campaigns in an account.

  14
• bing_ads_list_keywords

  Keywords in an ad group and their settings.

  15
• discover_connectors

  Finds the right connector for a data source you mention (for example Notion or HubSpot), tells you whether it's connected, and gives you a link to connect it.

  16
• facebook_analyze_ad_creative_by_id_or_url

  AI review of a creative's visuals, messaging and hook, by ad ID or by image/video link. Uses AI credits. Only appears on plans that include creative analysis.

  17
• facebook_fetch_pagination_url

  Gets the next or previous page of a Meta Ads result.

  18
• facebook_get_activities_by_adaccount

  The account's change history (budget, targeting and status changes). Covers the last 7 days by default, or any date range you ask for.

  19
• facebook_get_ad_creative_details

  A creative's text, links and asset setup. No AI analysis.

  20
• facebook_get_adaccount_insights

  Performance data (spend, results, ROAS and more) at account, campaign, ad set or ad level, with breakdowns. Fetches up to 5 pages of results on its own.

  21
• facebook_get_adset_details

  An ad set's settings: targeting, budget, optimization goal and frequency caps.

  22
• facebook_get_async_adaccount_insights

  Runs a large insights request in the background. Returns results within about 30 seconds, or a report ID the assistant checks back on.

  23
• facebook_get_campaign_details

  A campaign's settings: objective, budget, status and dates.

  24
• facebook_get_details_of_ad_account

  Account currency, balance and status, plus a snapshot of the top 10 ads.

  25
• facebook_list_ad_accounts

  Lists the Meta ad accounts you can reach and whether each one is connected for read or write. Start here.

  26
• facebook_list_ads

  Ads, filtered by campaign, ad set or status.

  27
• facebook_list_adsets

  Ad sets, filtered by campaign or status.

  28
• facebook_list_campaigns

  Campaigns in an account, filtered by status or objective.

  29
• facebook_list_custom_audiences

  Custom, lookalike and saved audiences.

  30
• facebook_list_pixels

  The Meta Pixels on an ad account.

  31
• facebook_list_product_catalogs

  Product catalogs you can use for catalog ads.

  32
• facebook_list_product_sets

  Product sets inside a catalog.

  33
• facebook_page_fetch_pagination_url

  Gets the next or previous page of a Pages result.

  34
• facebook_page_get_info

  A Page's profile: followers, category and link.

  35
• facebook_page_get_insights

  Page-level metrics.

  36
• facebook_page_get_post_comments

  Comments on a post.

  37
• facebook_page_get_post_insights

  Metrics for individual posts.

  38
• facebook_page_list

  Facebook Pages you manage, including Pages shared with you through Business Manager. Start here.

  39
• facebook_page_list_posts

  A Page's posts.

  40
• facebook_propose_clone_ad

  Copies an ad.

  41
• facebook_propose_clone_ad_creative

  Copies an ad creative.

  42
• facebook_propose_clone_adset

  Copies an ad set.

  43
• facebook_propose_clone_campaign

  Copies a campaign.

  44
• facebook_propose_create_campaign_structure

  Launches a campaign, an ad set and its ads in one step, or adds a new ad set or new ads to existing ones. Sales objective only, one ad set per launch. New ads are created paused so you can switch them on when ready.

  45
• facebook_propose_update_ad_creatives

  Edits one or more ad creatives.

  46
• facebook_propose_update_ads

  Edits one or more ads, for example switching them on or off.

  47
• facebook_propose_update_adsets

  Edits one or more ad sets, for example status, budget, bid or targeting.

  48
• facebook_propose_update_campaigns

  Edits one or more campaigns, for example status, name or budget.

  49
• facebook_search_targeting

  Finds interest, behavior and demographic targeting options and their IDs.

  50
• google_ads_get_change_logs

  Recent account changes and how performance moved afterwards, up to 30 days back.

  51
• google_ads_get_currency

  The account's currency. The assistant checks it before any budget or bid change.

  52
• google_ads_keyword_discover

  Keyword ideas from seed keywords or a web page, with search volume, competition and bid ranges.

  53
• google_ads_keyword_metrics

  Historical metrics and forecasts for a list of keywords.

  54
• google_ads_list_accounts

  Google Ads accounts you can reach, including accounts under a manager account. Start here.

  55
• google_ads_propose_create_asset

  Adds sitelinks, structured snippets or ad group images at account, campaign or ad group level.

  56
• google_ads_propose_create_campaign_structure

  Launches a Search campaign with an ad group and its ads in one step, or adds a new ad group or new ads to existing ones. One ad group per launch.

  57
• google_ads_propose_create_experiment

  Sets up an experiment on an existing Search campaign, with a control and a test version.

  58
• google_ads_propose_create_negative_keyword_list

  Creates shared negative keyword lists and can attach them to campaigns.

  59
• google_ads_propose_create_pmax_asset_group

  Creates a standard Performance Max campaign with its first asset group, or adds an asset group to an existing PMax campaign. Retail (Merchant Center) and travel PMax are not supported.

  60
• google_ads_propose_update_adgroups

  Edits one or more ad groups.

  61
• google_ads_propose_update_ads

  Edits one or more ads.

  62
• google_ads_propose_update_asset

  Edits existing sitelinks, structured snippets or images, or pauses and re-enables them. It does not delete assets.

  63
• google_ads_propose_update_bid_modifiers

  Changes bid adjustments and ad schedules on campaigns or ad groups.

  64
• google_ads_propose_update_campaigns

  Edits one or more campaigns, for example status or budget.

  65
• google_ads_propose_update_experiment

  Ends an experiment, turns the test version into its own campaign, or applies its changes back to the original campaign.

  66
• google_ads_propose_update_negative_keyword_list

  Renames a negative keyword list, adds or removes keywords, attaches or detaches campaigns, or removes the list.

  67
• google_ads_propose_update_pmax_asset_group

  Edits PMax asset groups: swap headlines, descriptions, images and YouTube videos, or change final URLs, audience signals and status.

  68
• google_ads_run_gaql

  Runs any Google Ads Query Language (GAQL) query: campaigns, keywords, search terms, ads, conversions and more. The main Google Ads reporting tool.

  69
• google_analytics_get_active_users

  Active and new users by day.

  70
• google_analytics_get_device_metrics

  Device and browser breakdown.

  71
• google_analytics_get_events

  Event counts by event name.

  72
• google_analytics_get_page_views

  Page views by page path.

  73
• google_analytics_get_traffic_sources

  Traffic by source and medium.

  74
• google_analytics_get_user_behavior

  Engagement: session duration and bounce rate.

  75
• google_analytics_list_properties

  Your GA4 accounts and properties. Start here.

  76
• google_analytics_run_report

  A custom report with any mix of metrics and dimensions. The most flexible GA4 tool.

  77
• google_drive_prepare_media_url

  Makes a public, hard-to-guess copy of a Drive image or video on GoMarble's media storage so it can be used in ads (for example Performance Max). The link does not expire. Your original file and its sharing settings don't change.

  78
• google_drive_read_file

  Reads a Google Doc, Sheet, Slides deck or text file as text. Large files are read in parts.

  79
• google_drive_search_files

  Finds Drive files by name or content.

  80
• google_drive_upload_from_url

  Saves a file from a public web link into your Drive. The saved file stays private. Up to 100 MB.

  81
• gsc_batch_url_inspection

  Inspects up to 100 URLs at once.

  82
• gsc_check_indexing_issues

  Checks up to 100 URLs for indexing problems and groups them by issue.

  83
• gsc_compare_search_periods

  Compares two date ranges, for example this week against last week.

  84
• gsc_get_advanced_search_analytics

  The same data with extra filters for device, country and search appearance.

  85
• gsc_get_performance_overview

  A summary of clicks, impressions and trends, with top queries and pages.

  86
• gsc_get_search_analytics

  Clicks, impressions, CTR and average position by query, page, country or device. Up to 25,000 rows per request.

  87
• gsc_get_search_by_page_query

  The search queries that bring traffic to one page.

  88
• gsc_get_site_details

  Verification details and status for a site.

  89
• gsc_get_sitemap_details

  One sitemap's errors and warnings.

  90
• gsc_get_sitemaps

  The sitemaps submitted for a site.

  91
• gsc_inspect_url

  Index status, mobile usability and rich results for one URL.

  92
• gsc_inspect_url_enhanced

  A more detailed inspection of one URL, including AMP status.

  93
• gsc_list_properties

  The Search Console sites you can reach. Start here.

  94
• gsc_list_sitemaps_enhanced

  Sitemaps with an error analysis and a suggested fix list.

  95
• impact_get_conversion_details

  Individual conversions with order ID, payout, status and clearing dates.

  96
• impact_get_invoice

  One invoice, with line items for each partner.

  97
• impact_get_partner_spend

  Conversions and commission spend by partner or program.

  98
• impact_get_report_metadata

  A report's filters and columns, checked before running it.

  99
• impact_list_accounts

  The impact.com accounts connected to your team. Start here. The other impact.com tools need the account ID it returns.

  100
• impact_list_invoices

  Partner invoices, newest first.

  101
• impact_list_partners

  The affiliate partners working with your brand.

  102
• impact_list_programs

  Your programs (campaigns) and their IDs.

  103
• impact_list_reports

  The reports available to your account.

  104
• impact_run_report

  A performance report (clicks, actions, revenue and cost) for a date range. The main impact.com reporting tool.

  105
• instagram_discover_business

  Public profile and engagement stats for any Business or Creator account, by username.

  106
• instagram_get_account_insights

  Account-level metrics.

  107
• instagram_get_media_comments

  Comments on a post.

  108
• instagram_get_media_insights

  Views, reach, likes, comments, shares and saves for each post.

  109
• instagram_get_profile_info

  Profile details: followers, bio, website and post count.

  110
• instagram_list_accounts

  Instagram Business accounts linked to your Facebook Pages. Start here.

  111
• instagram_list_media

  Posts, reels, videos and stories.

  112
• instagram_list_tagged_media

  Posts where other accounts tagged you.

  113
• klaviyo_get_account_details

  Account details and settings.

  114
• klaviyo_get_campaign

  One campaign's details.

  115
• klaviyo_get_campaign_report

  Campaign performance: opens, clicks and conversions.

  116
• klaviyo_get_campaigns

  Campaigns by channel (email or SMS).

  117
• klaviyo_get_catalog_items

  Products in your Klaviyo catalog.

  118
• klaviyo_get_email_template

  An email template's HTML.

  119
• klaviyo_get_events

  Events, filtered by profile, metric or date.

  120
• klaviyo_get_flow

  One flow's details.

  121
• klaviyo_get_flow_report

  Flow performance: opens, clicks and conversions.

  122
• klaviyo_get_flows

  Your automation flows.

  123
• klaviyo_get_list

  One list, with an optional profile count.

  124
• klaviyo_get_lists

  Your subscriber lists.

  125
• klaviyo_get_metric

  One metric's details.

  126
• klaviyo_get_metrics

  The metrics your account tracks. Used to pick the conversion metric for reports.

  127
• klaviyo_get_profile

  One profile, including its subscriptions.

  128
• klaviyo_get_profiles

  Subscriber profiles.

  129
• klaviyo_get_segment

  One segment, with an optional profile count.

  130
• klaviyo_get_segments

  Your audience segments.

  131
• klaviyo_list_shops

  Your connected Klaviyo accounts. Start here.

  132
• linkedin_get_ad_analytics

  Impressions, clicks, spend and conversions, split by campaign, creative or other dimensions.

  133
• linkedin_get_ad_campaign_groups

  Campaign groups, filtered by status or name.

  134
• linkedin_get_campaigns

  Campaigns, filtered by status, type or campaign group.

  135
• linkedin_get_targeting_entities

  Targeting options such as industries, job titles, companies and skills.

  136
• linkedin_list_ad_accounts

  Your Campaign Manager ad accounts. Start here.

  137
• load_skill

  Loads GoMarble's analysis playbooks, for example how to audit a Meta account or launch a Google Ads campaign, so the assistant follows them.

  138
• manage_agents

  Create, list, update, pause, resume, run or delete GoMarble agents.

  139
• recall_memory

  Looks up what GoMarble remembers about your accounts: past changes, baselines, decisions and preferences. Needs a plan that includes Account Knowledge.

  140
• shopify_get_all_details_by_gid

  Full details of one product, order or customer.

  141
• shopify_list_customers_by_query

  Customers that match a search, with order stats. No personal details are returned.

  142
• shopify_list_orders_by_query

  Orders (date and value) that match a search.

  143
• shopify_list_products_by_query

  Products that match a search.

  144
• shopify_list_shops

  Your connected Shopify stores. Start here.

  145
• shopify_run_analytics_query

  Runs a ShopifyQL query covering sales, sessions, customer cohorts and inventory. The main Shopify reporting tool.

  146
• snowflake_execute_query

  Runs a SQL query on your Snowflake warehouse.

  147
• tiktok_fetch_pagination

  Collects every page of a TikTok list result.

  148
• tiktok_get_account_details

  Currency, time zone, balance and status.

  149
• tiktok_get_account_finance

  Balances and budgets for accounts under a Business Center, or one account's active ad group quota.

  150
• tiktok_get_ad_creative_url

  Direct links to an ad's video or image.

  151
• tiktok_get_ad_review_info

  Review status and rejection reasons for up to 100 ads.

  152
• tiktok_get_adgroups

  Ad groups with targeting and optimization settings.

  153
• tiktok_get_ads

  Ads with creative and tracking settings.

  154
• tiktok_get_async_report

  Runs large or long date-range reports in the background.

  155
• tiktok_get_audience_report

  Performance by age, gender and location.

  156
• tiktok_get_automated_rules

  Automated rules set up in TikTok Ads Manager, and their results.

  157
• tiktok_get_basic_report_enhanced

  Performance metrics such as impressions, clicks, spend and ROAS. Daily breakdowns cover up to 30 days; other breakdowns up to 365 days.

  158
• tiktok_get_campaigns

  Campaigns with budget, objective and status.

  159
• tiktok_get_change_log

  Change history for campaigns, ad groups and ads.

  160
• tiktok_get_creative_report

  Performance for each video, image or instant page.

  161
• tiktok_get_identities

  The TikTok identities you can run ads as. Needed before creating most ads.

  162
• tiktok_get_music

  Music you can use in carousel ads.

  163
• tiktok_get_offline_event_sets

  Offline event sets.

  164
• tiktok_get_reach_frequency

  Reach & Frequency estimates, contracts and delivery time zones.

  165
• tiktok_get_smart_creative

  The images and videos Smart Creative is combining for an ad group.

  166
• tiktok_get_smart_plus

  Smart+ campaigns, ad groups and ads.

  167
• tiktok_get_split_test

  Split test (A/B test) results and the winning version.

  168
• tiktok_list_ad_accounts

  TikTok ad accounts you can reach, with recent spend. Start here.

  169
• tiktok_list_audiences

  Custom or saved audiences.

  170
• tiktok_list_business_centers

  The Business Centers you can reach.

  171
• tiktok_list_catalogs

  Catalogs, product sets, products or TikTok Shop stores.

  172
• tiktok_list_custom_conversions

  Custom conversions for a pixel or app.

  173
• tiktok_list_pixels

  Pixels and their events, or offline event sets.

  174
• tiktok_propose_copy_campaign

  Copies a campaign with its ad groups and ads. The copy is created paused unless you ask for it to be on.

  175
• tiktok_propose_create_campaign_structure

  Launches a campaign, ad group and ads in one step.

  176
• tiktok_propose_manage_reach_frequency

  Creates, edits or cancels a Reach & Frequency order. Your account must be approved by TikTok for Reach & Frequency.

  177
• tiktok_propose_manage_review_and_events

  Appeals a rejected ad, or creates or edits an offline event set.

  178
• tiktok_propose_manage_smart_creative

  Creates Smart Creative ads, updates their materials, or turns individual materials on or off.

  179
• tiktok_propose_manage_smart_plus

  Creates or edits Smart+ campaigns, ad groups and ads, including status and budget, or copies a Smart+ campaign.

  180
• tiktok_propose_manage_split_test

  Creates, reschedules or ends a split test between two existing ad groups or campaigns.

  181
• tiktok_propose_update_adgroups

  Edits one or more ad groups.

  182
• tiktok_propose_update_ads

  Edits one or more ads.

  183
• tiktok_propose_update_campaigns

  Edits one or more campaigns.

  184
• tiktok_search_interests

  Finds interest and behavior targeting IDs.

  185
• tiktok_search_targeting

  Finds location targeting: countries, regions, cities, DMAs and postcodes.

  186
• tiktok_upload_asset

  Uploads a video or image to the account's asset library from a link or an existing file, ready for new ads.

  187

This server’s available tools can vary by account, permissions, or configuration. The list shown is not its full runtime catalog.

• Available tools depend on connected platforms and permission level; TikTok write actions are marked beta in current connection docs. ChatGPT plan/workspace settings can constrain read/write access.

• official publisher documentation

  Official connection guide documents clients, OAuth URL, connected account scopes, and permission limits.

• official publisher documentation

  Official product page reports 400+ unique dynamic tools and plan-dependent access.

• official publisher documentation

  Publisher or maintainer documentation reviewed 2026-10-28T19:30:00.000Z; capability and connection information recorded, with exact protocol tool identifiers added only when the source publishes them.

Documentation checked 2026-10-28T19:30:00.000Z. Connection has not been runtime tested.