Manage ads from your AI agent with LazyAds MCP

If you already brief work in Cursor, Claude Desktop, Hermes, or another MCP client, opening a separate ads console just to pause a campaign is the wrong interface. The verbs are the same every time — list, inspect, pause, raise a budget, attach a creative — and they belong on the agent that already has your context.

LazyAds.ai exposes those verbs through a hosted MCP server. Point the client at https://mcp.lazyads.ai/mcp, send an API key on every request, and the agent works against the ad accounts you connected in Lazy Ads. This post is the practical setup: protocol, client snippets, the 33-tool bridge versus the 45-tool suite, and what managing ads from an agent actually includes today.

What MCP changes about running ads

Model Context Protocol is a standard way for an AI client to call tools on a remote server. The client does not scrape an ads UI or store your platform passwords. It sends a named tool call — list_campaigns, pause_resume_campaign, set_campaign_budget — and the server performs the action against accounts you authorized.

That split matters because the work is spread across nine network consoles, each with its own objects, budgets, and approval queues. An agent that can only see one tab is not managing a program. An agent that can call a shared tool list against a unified account graph can.

Lazy Ads is the connector and the dashboard. Your agent is the operator. On BYOA the agent brings its own reasoning. On Starter and above, the same MCP connection also includes Lazy Ads AI tools so the platform can draft, score, and analyze — still through the agent, still as tool calls you can read in the transcript.

If you need the plan math, read Bring your own agent ads. For the definition vs closed-team / spend-tax shapes, see What BYOA means for ads. For Approve vs Hands-off on the same write path, see AI ad approval workflow.

The hosted endpoint

Production lives at https://mcp.lazyads.ai/mcp. Authenticate with your API key on every request.

Generate a key under Settings → API on any paid plan (BYOA, Starter, Growth, or Scale). The free path does not include MCP. If you are still evaluating, start with onboarding and competitor ad browse; subscribe to BYOA or Starter when you want a key.

Connect Cursor, Claude Desktop, or Windsurf

Most desktop MCP clients take a JSON server block. Streamable HTTP is the production path:

{
  "mcpServers": {
    "lazyads": {
      "url": "https://mcp.lazyads.ai/mcp",
      "headers": {
        "Authorization": "Bearer your-api-key"
      }
    }
  }
}

Replace the placeholder with a key from Settings → API. After a restart, the client should list Lazy Ads tools. If it does not, confirm the header (Authorization or X-API-Key) and that the plan is paid.

Useful first prompts are boring on purpose: “Which ad platforms am I connected to?”, “List my Lazy Ads campaigns with the latest synced metrics,” “Sync performance for every linked campaign.” Those calls exercise list_platform_connections, list_campaigns, and sync_all_campaign_performance — bridge tools every paid plan shares.

Connect Hermes

Hermes uses YAML, and Lazy Ads publishes a skill so the server feels native instead of like a raw tool dump. The walkthrough is on the Hermes page: copy SKILL.md into ~/.hermes/skills/lazyads/, add the server to config.yaml, restart.

mcp_servers:
  lazyads:
    url: "https://mcp.lazyads.ai/mcp"
    headers:
      Authorization: "Bearer your-api-key"
    description: "LazyAds MCP — nine-network ad management"

Same protocol: Streamable HTTP, Bearer or X-API-Key on every request. The skill is optional but worth it — it keeps BYOA workflows from calling Starter-only tool names. The sample conversation on /hermes is a shape, not a performance report. Your numbers will be whatever your ad accounts actually produced.

33 bridge tools on BYOA, 45 on Starter+

Every paid plan, including BYOA, gets the bridge: 33 tools that create, edit, pause, and monitor campaigns on connected accounts and sync results into the dashboard. Starter, Growth, and Scale add the AI tools for a full suite of 45.

The bridge is the operations layer:

• Create: create_manual_campaign, create_manual_ad_set, create_manual_ad, create_meta_ad_creative
• Import and update: import_platform_campaign, update_manual_campaign, duplicate_campaign
• Live controls: pause_resume_campaign, pause_resume_ad, pause_resume_ad_set, set_campaign_budget, set_ad_set_budget, update_ad_set_targeting, update_ad_set_bid, add_ad_set_keywords
• Inventory: list_live_platform_campaigns, list_campaigns, get_ad_details, list_platform_connections, list_platform_audiences, list_audiences, list_creatives, attach_creative_to_ad
• Sync and billing: sync_campaign_performance, sync_all_campaign_performance, check_platform_billing, connect_chatgpt_ads, get_recent_notifications
• Analytics: get_campaign_performance, get_ad_spend_summary, get_breakdown_data, get_best_performing_creative, compare_campaigns

If you already have a strategy in the agent — a brief, a budget, a creative URL — the bridge is enough to push that work onto a connected network, then pull performance back into one dashboard.

Starter+ adds the platform’s own brain: build_ai_campaign and get_campaign_build_status; chat_with_lazy_ads; get_optimization_suggestions, get_audience_suggestions, get_creative_score; generate_creative (quota and cost enforced); competitor tools (list_competitors, search_competitor_ads, get_competitor_analysis, scan_competitor_ads); and get_ai_activity.

Those twelve AI tools are why Starter is a different product from BYOA, not a bigger quota on the same product. BYOA is “your agent, our connector.” Starter+ is “your agent, plus Lazy Ads AI, on the same wire.” Browse the full list on the MCP page.

Nine networks

Lazy Ads is built around nine ad networks: Meta (Facebook and Instagram), Google, TikTok, LinkedIn, Reddit, Apple, Bing, ChatGPT, and Snapchat. You still need your own ad accounts.

A working session, without invented results

A useful first hour:

1. Confirm connections with list_platform_connections. If ChatGPT is missing, connect_chatgpt_ads attaches an Ads Manager API key.
2. Pull live objects with list_live_platform_campaigns, then import_platform_campaign for anything you want on the unified dashboard.
3. sync_all_campaign_performance so the dashboard and the agent see the same numbers.
4. Read get_ad_spend_summary and get_breakdown_data before you touch budgets.
5. Pause or resume at campaign, ad set, or ad granularity. Change daily budget where the platform supports it (Meta ABO, TikTok, LinkedIn, and Reddit are called out for ad-set budgets; Google, Bing, and Apple take keyword adds).
6. On Starter+, if you want the platform to draft structure, call build_ai_campaign and poll get_campaign_build_status. Review the draft. Launch only on networks that are actually connected and writable.

Nothing in that list requires a spreadsheet or a pasted scoreboard. The metrics you see are the metrics your platforms already have, synced in.

Plans, keys, and what free actually includes

MCP is a paid-plan feature. BYOA is the cheapest way onto the wire: $19/month billed annually, or $24/month month-to-month, with the 33-tool bridge and no Lazy Ads AI usage on our side. Starter at $79/month annual ($99 monthly) is the first plan with the full 45-tool MCP server, AI campaign creation, and daily analysis. Growth ($199/month annual, $249 monthly) and Scale ($399/month annual, $499 monthly) keep full MCP and raise spend caps, analysis frequency, creative quotas, and competitor tracking. REST API access starts at Growth, not on BYOA or Starter.

The free path is onboarding plus competitor ad browse. Free accounts do not receive AI tokens, an MCP key, or a generated campaign strategy. If a prompt asks Lazy Ads to “just build me a strategy” on a free workspace, the honest answer is onboarding plus competitor ad browse, then BYOA or Starter on the pricing page when you are ready.

FAQ

Does LazyAds MCP work with Cursor, Claude, and Hermes?

Yes. Any MCP-compatible client that can call a Streamable HTTP server can use https://mcp.lazyads.ai/mcp. Cursor, Claude Desktop, Windsurf, and Hermes are the setups we document. Hermes also has a skill file and YAML block.

What is the difference between 33 tools and 45 tools?

The 33 are the bridge: create, edit, pause, monitor, sync, and analyze against connected ad accounts. The extra 12 on Starter+ are Lazy Ads AI tools — campaign builds, in-product chat, creative generation, scoring, optimization notes, and competitor analysis. BYOA is bridge-only. Starter and above are the full suite.

Do I still need native ad accounts?

Yes. Lazy Ads does not mint Meta, Google, or TikTok accounts for you. You connect advertiser accounts you already have. The MCP server acts on those connections. Lazy Ads is built around nine ad networks: Meta (Facebook and Instagram), Google, TikTok, LinkedIn, Reddit, Apple, Bing, ChatGPT, and Snapchat.

Can I use MCP on the free tier?

No. API keys are created under Settings → API on paid plans. Free users can complete onboarding and browse competitor ads. To manage campaigns from Cursor, Claude, or Hermes, subscribe to BYOA for the bridge or Starter for full MCP plus Lazy Ads AI.

Start with the agent you already have

Read the tool list on /mcp. If your client is Hermes, follow /hermes.

• Compare BYOA and Starter on /pricing.
• Or start at lazyads.ai: finish onboarding and browse competitor ads, then pick BYOA or Starter on pricing when you are ready.