#advertising #paid-ads #facebook-ads #instagram-ads

Lazyads

Manage ad campaigns across Meta, Google, TikTok, LinkedIn, Reddit, Apple, Bing, ChatGPT, and Snapchat Ads via the hosted LazyAds MCP server. Bridge mode (BYOA) lets your agent create/edit/monitor campaigns without Lazy Ads AI. Full MCP (Starter+) also unlocks Lazy Ads AI builds, creatives, optimisation, and competitor intelligence.

Cameron Wills@camerondwills

Install

openclaw skills install @camerondwills/lazyads

LazyAds Skill

What LazyAds Does

LazyAds is an ad management platform covering 9 platforms: Meta (Facebook/Instagram), Google Ads, TikTok, LinkedIn, Reddit, Apple Ads, Bing Ads, ChatGPT Ads, and Snapchat Ads. Instead of connecting each platform separately, LazyAds exposes everything through a single MCP connection and API key.

Endpoint: https://mcp.lazyads.ai/mcp (Streamable HTTP, MCP 2026-07-28, stateless — no session handshake). Send Authorization: Bearer <api-key> (or X-API-Key) on every request. Per-key rate limits (1-minute window): BYOA 60, Starter 30, Growth 100, Scale 500, Enterprise 1000. Exceeding returns 429 with Retry-After.

Two access modes:

Bridge (BYOA + every paid plan) — 33 tools; your agent supplies strategy/copy; LazyAds is the connector to ad accounts and syncs stats to the dashboard. Never spends Lazy Ads AI credits.
Full MCP (Starter / Growth / Scale / Enterprise) — 47 tools total; bridge plus 14 Lazy Ads AI tools (campaign build, chat, creative generation, optimisation, competitor AI, activity log).

The live catalog with descriptions is at https://lazyads.ai/mcp#tools.

Setup

Sign up at https://lazyads.ai/pricing (BYOA for bridge-only, or Starter+ for full MCP)
Connect your ad platform accounts in the Lazy Ads dashboard (ChatGPT Ads can also be connected with connect_chatgpt_ads using an Ads Manager API key; every other platform uses dashboard OAuth or BYO-key cards)
Generate an API key at Settings → API (https://lazyads.ai/dashboard/settings?tab=api) and store it:
text
```
# ~/.hermes/.env
LAZY_ADS_API_KEY=la_your_api_key
```
Add the server to ~/.hermes/config.yaml (see https://lazyads.ai/hermes):
yaml
```
mcp_servers:
  lazyads:
    url: "https://mcp.lazyads.ai/mcp"
    headers:
      Authorization: "Bearer ${LAZY_ADS_API_KEY}"
```
Local development against a Lazy Ads checkout: http://127.0.0.1:3100/mcp.
Restart Hermes. Confirm with "Which ad platforms am I connected to?" (list_platform_connections).

When to Use This Skill

Load when the user asks about:

Their ad campaigns (performance, status, spend, ROAS, breakdowns)
Creating, importing, pausing, scaling, or building campaigns
Syncing live platform metrics into the Lazy Ads dashboard
Ad-set level controls: budgets, bids, targeting, keywords
Ad creative (browse/attach on any paid plan; generate/score on full MCP)
Competitor ad activity (full MCP for Ad Library search and AI analysis)
Whether an ad account can spend (check_platform_billing)

Bridge MCP Tools (BYOA-safe, 33)

Create and publish

create_manual_campaign — create on Meta/Google/TikTok/LinkedIn/Reddit/Apple/Bing/ChatGPT/Snapchat + Lazy Ads (aiManaged=false; LinkedIn = campaign group)
create_manual_ad_set — ad set / ad group with geo, age, gender, interests, keywords, custom audiences
create_manual_ad — ads with copy/creative (Meta needs create_meta_ad_creative first; others take imageUrl)
create_meta_ad_creative — Meta creative from a public image URL + copy
list_platform_audiences — Meta/TikTok custom audiences to attach via targeting.customAudienceIds
update_manual_campaign — name/objective/daily budget/end date on Lazy Ads + platform
duplicate_campaign — clone a campaign into a new draft

Import and sync

list_live_platform_campaigns — list campaigns directly from a connected ad account
import_platform_campaign — link an existing live campaign into Lazy Ads
sync_campaign_performance / sync_all_campaign_performance — pull live metrics into the unified Lazy Ads dashboard (1–90 days)

Manage live campaigns

list_campaigns — Lazy Ads campaigns with status + latest synced metrics
get_ad_details — full ad set + ad copy + creative details
pause_resume_campaign / pause_resume_ad_set / pause_resume_ad — propagates to the live platform
set_campaign_budget / set_ad_set_budget — daily budgets (ad-set budgets on Meta ABO, TikTok, LinkedIn, Reddit)
update_ad_set_targeting — live audience targeting when the platform API allows it
update_ad_set_bid — manual bid on LinkedIn, TikTok, ChatGPT, or Snapchat (null = LinkedIn auto bid)
add_ad_set_keywords — Google / Bing / Apple search keywords with match types

Analytics

get_campaign_performance / get_ad_spend_summary / get_breakdown_data / get_best_performing_creative / compare_campaigns

Creatives, audiences, and account

list_creatives (lifetime ROAS/spend + predicted scores) / attach_creative_to_ad
list_audiences — audiences currently used across ad sets
list_platform_connections / connect_chatgpt_ads / check_platform_billing
get_recent_notifications

BYOA hierarchy workflow

create_manual_campaign (platform + objective + budget)
create_manual_ad_set (targeting / audiences)
Meta: create_meta_ad_creative → create_manual_ad; others: create_manual_ad with imageUrl
sync_campaign_performance so the Lazy Ads dashboard shows spend/ROAS without logging into each ads manager

Full MCP Tools (Starter+, adds 14)

Campaign build and automation

build_ai_campaign — trigger a full Lazy Ads AI campaign build. Same options as the dashboard and REST POST /api/v1/campaigns/build: platforms, dailyBudgetUsd, objectiveOverride, creativeMix (ai_decide | images_only | videos_only | images_and_videos | existing), preferredCreativeIds, preferredPagePostId, socialContentIds, referenceCreativeIds, customInstructions, skipCompetitorAnalysis, confirmNotPolitical.
get_campaign_build_status — poll build progress (2–5 minutes)
set_campaign_automation — toggle Tracking (dashboard + analysis) and Management (optimizer may edit) on a campaign

AI and optimisation

get_optimization_suggestions — AI analysis with action recommendations
chat_with_lazy_ads — ask the Lazy Ads assistant anything about the account (it can act)
get_creative_score — predicted performance before launch
generate_creative — AI image/video generation (credits + quota enforced)
get_audience_suggestions — AI targeting from a description

Competitor intelligence

list_competitors / search_competitor_ads / get_competitor_analysis / scan_competitor_ads

Activity

get_ai_activity — recent Lazy Ads AI tasks
list_activity — searchable user-facing log: credit charges and campaign/ad-set/ad changes

Example Workflows

BYOA: Manual Campaign Launch

"Create a Meta campaign named Summer Sale with OUTCOME_SALES objective and $40/day, then sync performance after it has data." → create_manual_campaign → create_manual_ad_set → create_meta_ad_creative → create_manual_ad → later sync_campaign_performance

Import what is already running

"Bring my live Google campaigns into Lazy Ads." → list_live_platform_campaigns (platform=google) → import_platform_campaign per id → sync_all_campaign_performance

Morning Campaign Review

"Check my campaigns — anything I should be worried about today?" → list_campaigns + get_campaign_performance (+ get_breakdown_data for the outlier)

Pause Underperformers

"Pause any campaigns where CPA is more than 2× my target for 3+ days" → identify via performance tools, then pause_resume_campaign / pause_resume_ad_set / pause_resume_ad

Full MCP: AI Campaign Build

"Build me a Meta campaign for my best-selling product with $50/day budget" → build_ai_campaign + get_campaign_build_status (Starter+ only)

Pitfalls

BYOA cannot call Lazy Ads AI tools (build_ai_campaign, chat_with_lazy_ads, generate_creative, scan_competitor_ads, etc.); the server answers with a plan error, not an OpenRouter error
Bridge create/update requires a connected platform account in the dashboard; run check_platform_billing before launching spend
Campaign builds (full MCP) take 2–5 minutes — poll with get_campaign_build_status
Creative generation and AI builds consume monthly AI credits on AI plans
LinkedIn and Reddit do not report revenue via API; ROAS can show 0 there
Prefer sync_all_campaign_performance over one sync per campaign to stay under the per-minute rate limit
Do not expect a sticky MCP session — the API key (and any protocol headers your client manages) goes on every call
The REST API and outbound webhooks are Growth+; BYOA/Starter keys are MCP-only