@rapidbrand/mcp

MCP Server for RapidBrand -- agentic Meta and Google ads research, reporting, campaign drafts, and optimization workflows from any AI assistant.

Quick Start

npx @rapidbrand/mcp

Setup

Environment Variables

• RAPIDBRAND_API_KEY (required) -- Your RapidBrand API key. Generate one from your Account page.
• RAPIDBRAND_BASE_URL (optional) -- Defaults to https://rapidbrand.io.

Cross-platform Google Ad Library search + the nightly board sweep require the backend to be pointed at the Google Transparency scraper service via SCRAPER_URL + SCRAPER_SHARED_SECRET (set on the RapidBrand backend, not in this MCP client). Until it is deployed, search_ad_library with platform: "google" degrades gracefully: it returns { blocked: true } plus any cached board advertisers instead of erroring.

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "rapidbrand": {
      "command": "npx",
      "args": ["-y", "@rapidbrand/mcp"],
      "env": {
        "RAPIDBRAND_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "rapidbrand": {
      "command": "npx",
      "args": ["-y", "@rapidbrand/mcp"],
      "env": {
        "RAPIDBRAND_API_KEY": "your-api-key-here"
      }
    }
  }
}

Unified Ads (Tier 0) — reads + cross-platform Ad Library + competitor board

A small, weak-model-safe surface that covers both Meta and Google with one identical shape. All read or board-track only — no ad mutation (build/optimize live in Tier 1+).

| Tool | Platform | Read/Write | Description | | ------------------------ | ------------ | ------------- | ------------------------------------------------------------------------------------------------------------------------------- | | ads_report | meta, google | read | SAFE breakdown read (account/campaign/ad_group/ad/keyword/search_term/geo/device). Builds Insights/GAQL for you — not raw GAQL. | | ads_query_raw | meta, google | read | Power escape hatch: raw GAQL SELECT (Google) or raw Graph node read (Meta, GET-only). | | search_ad_library | meta, google | read | Unified competitor ad search across Meta Ad Library + Google Transparency; one normalized shape. | | track_advertiser | meta, google | write (board) | Add a Meta page / Google advertiser (AR…) to the board; nightly: true to include in the sweep. | | get_board | both | read | Read the unified competitor board (tracked advertisers, creative counts, last change). | | get_advertiser_changes | both | read | Recent new/removed/changed creatives for a tracked advertiser (from the nightly sweep). | | discover | n/a | read | Router: describe a task → relevant ads tool names + schemas + suggestions (keeps the surface tiny). |

Available Tools

| Tool | Description | | -------------------------------------- | ------------------------------------------------------------------------------------------------ | | list_campaigns | List all ad campaigns | | create_campaign | Create a new campaign from a website URL | | get_campaign | Get campaign details and status | | get_campaign_creatives | Get generated ad creatives for a campaign | | search_ad_library | UNIFIED competitor ad search across Meta Ad Library + Google Transparency (see Tier 0) | | get_ad_accounts | List connected Meta ad accounts | | get_account_overview | Get ad account performance overview | | get_campaign_insights | Get per-campaign performance data | | list_report_definitions | Read saved agency report definitions and white-label readiness | | list_report_shares | Read client report link state without creating or mutating links | | get_managed_account_health | Read sanitized Meta sync/reconnect health without live Facebook API calls | | list_intelligence_alerts | Read proactive RapidBrand intelligence alerts | | list_creative_briefs | Read creative briefs generated from performance intelligence | | get_google_ads_readiness | Check platform credential, user OAuth, customer sync, and action readiness | | get_transparency_provider_readiness | Read saved Google Transparency break-concurrency proof, operating ceiling, and schedule decision | | list_transparency_advertisers | List tracked Google Transparency advertisers and refresh state | | get_transparency_refresh_schedule | Summarize due, running, stale, and failed Transparency refreshes | | get_transparency_advertiser | Read one tracked Transparency advertiser's metadata and schedule | | list_transparency_creatives | List sanitized creative evidence for a tracked Transparency advertiser | | get_transparency_build_evidence | Read draft-input competitor evidence for Google Ads build plans | | list_google_ads_customers | List synced Google Ads customers | | get_google_ads_campaign_snapshot | Read cached Google Ads campaign performance | | list_google_ads_optimization_actions | Review saved Google Ads optimization actions, optionally filtered by status | | apply_google_ads_optimization_action | Preview saved Google Ads actions by default; apply only with confirm: true | | update_google_ads_campaign_status | Preview/apply a direct campaign status change (ENABLED/PAUSED); apply with confirm: true | | update_google_ads_campaign_budget | Preview/apply a direct campaign budget change; apply with confirm: true | | list_google_ads_build_plans | List draft-only Google Ads build plans with manual-review CSV bundles | | create_google_ads_build_plan | Create a draft/export plan and paused CSV bundle; no live campaign creation | | create_brand_bible | Create a brand guide for consistent ads | | list_brand_bibles | List all brand bibles | | gtm_discover | List/describe the 105 underlying Tag Manager operations | | gtm_call | Invoke one Tag Manager operation by name: { operation, params } | | ga4_discover | List/describe the 96 underlying GA4 Admin + Data operations | | ga4_call | Invoke one GA4 operation by name: { operation, params } |

Example Prompts

• "Create a campaign for mybakery.com targeting local dessert lovers"
• "Search Google for personal-injury lawyer ads (platform google)"
• "Report campaign-level spend and conversions for Google customer 1234567890, last 7 days"
• "Track the advertiser AR0987654321 on my board with nightly sweeps"
• "Show my competitor board and what changed for advertiser 12 this week"
• "Which ads tool should I use to compare two competitors' creatives?"
• "Search for Nike running shoe ads in the US"
• "Show me my ad account performance for the last 30 days"
• "List saved report definitions for this RapidBrand managed account"
• "Check whether the default client report has an active share link"
• "Check managed account health for RapidBrand ad account 123"
• "Show me my RapidBrand intelligence alerts"
• "List pending creative briefs without executing them"
• "Check whether my Google Ads account is connected and ready for optimization"
• "What Google Transparency concurrency has RapidBrand proven, and where did it break?"
• "List my tracked Transparency advertisers and which refreshes are due"
• "Show sanitized creative evidence for Transparency advertiser AR123"
• "Get the Transparency build evidence packet before creating a draft Google Ads plan"
• "Explain whether Google Ads is blocked by RapidBrand platform setup, my Google OAuth login, or customer sync"
• "List my Google Ads customers and show the latest campaign snapshot"
• "Review saved Google Ads optimization actions for customer 1234567890"
• "Preview pausing Google Ads campaign 987654321 for customer 1234567890"
• "Preview a Google Ads campaign budget change before I approve it"
• "Preview saved Google Ads action abc123 before applying it"
• "Create a draft-only Google Ads build plan for customer 1234567890"
• "Show the manual-review CSV bundle for my latest Google Ads build draft"
• "List all my campaigns and their status"
• "Create a brand bible for my coffee shop brand"

License

MIT