Omneky

App-only Range-GET chunk for widget blob: autoplay assembly. Not for the model. Used when poll cannot inline a full ``data:video`` (size/timeout). Claude's media-src allows ``blob:`` (KB-0038).

fetch_video_chunk

Commit a scraped product draft into the catalogue with the chosen fields and images. Not ``upsert_brand_product``. ## When to use - A scrape draft is ready to save (fields and selected images chosen) ## When not to use - Not for a hand-built product (use ``create_product`` / ``upsert_brand_product``) ## Intent keywords finalize scrape, save catalogue draft, product import

finalize_scraped_product

Queue a new static image ad for the signed-in user's brand. Starts an async Creative Brief render and returns a ``job_id`` quickly — it does **not** wait for the finished image. ## Host widget (preferred) This tool declares an MCP Apps progress/preview UI. When the host opens that widget, do **not** ask the user to "check back", and do **not** call ``get_generation_status`` in a loop — the widget polls and shows the image. ## Text-only hosts (no widget) Share the ``job_id``, stop the turn, and on the user's follow-up call ``get_generation_status(job_id, kind="image")`` **once**. When the job is complete this returns the finished image **inline as an image** (plus a link) — just present it; do not describe it as a URL. Follow ``next_action``. Do **not** poll in the same turn. ## When to use - Net-new product / lifestyle / campaign image ads - Redesigns or concept variants grounded in brand + product context - Not for editing an existing finished ad (use ``edit_image``) and not for video (use ``generate_product_video``) ## Required inputs (typical) - ``brand_id``, ``brand_name``, ``company_id``, ``user_id`` — resolve via ``list_brands`` / ``get_brand_details`` / ``get_current_user`` - ``ad_concept`` — the full creative prompt (product, offer, visual direction, copy cues). This is the prompt field; do not invent a separate ``prompt`` arg - ``gpt_ad_gen_id`` — unique job key: ``<short-slug>-<uuid4>``. Never reuse across variants or retries ## Recommended optional inputs - ``aspect_ratio`` — one of ``1:1`` (default / feed), ``4:5``, ``9:16`` (Stories/Reels/TikTok), ``16:9`` - ``user_assets`` / product imagery when the brief needs a specific product shot - ``headline`` / ``subheadline`` / ``cta`` when the user already chose copy ## Agent flow (public connector) 1. Ask whether the ad is for a **specific product** or the **brand in general**. If product-specific, resolve via ``list_brand_products`` / ``get_product_details`` (or ask which product) and gather product imagery. If brand-general, use ``get_brand_details`` identity/assets and skip product selection. 2. Confirm aspect ratio(s) and ad goal with the user if missing. 3. Call this tool once per distinct creative concept (for multiple placements, generate once at a primary ratio, then ``resize_ad`` for each remaining ratio in one parallel tool round). 4. If a generation widget appears, briefly confirm the job is running and let the widget finish — do not narrate a manual status loop. 5. If no widget appears, share ``job_id`` and wait for the user to ask for status. This is a paid render: it deducts **5 credits** when the job is submitted. If the account is short on credits the tool returns a ``credit_insufficient`` result and does **not** start the render — relay that to the user and do not retry until they top up. Confirm intent before calling. ## Intent keywords image ad, static ad, paid-media creative, Meta ad creative, Facebook ad, Instagram ad, Google image ad, TikTok static, catalogue creative, product shot

generate_image_ad

Queue a multi-scene product video commercial for the signed-in brand. Starts an async Creative Brief multi-scene render and returns a ``job_id`` quickly — it does **not** wait for the finished clip (typical wall clock 3–7 minutes). ## Host widget (preferred) This tool declares an MCP Apps progress/preview UI. When the host opens that widget, do **not** ask the user to "check back", and do **not** call ``get_generation_status`` in a loop — the widget polls and shows the video (or an open link if in-iframe playback is blocked). ## Text-only hosts (no widget) Share the ``job_id``, stop the turn, and on the user's follow-up call ``get_generation_status(job_id, kind="video")`` **once**. Deliver ``assets.url`` / ``assets.video_url`` when complete. Follow ``next_action``. Do **not** poll in the same turn. ## When to use - Short product commercials / multi-beat narrative videos - After ``fetch_product_video_narratives`` when a narrative has been selected - Prefer this over single-shot product motion when the story needs multiple scenes or is longer than ~8 seconds ## Prerequisites 1. Product name + 1–3 product image URLs 2. A chosen narrative (from ``fetch_product_video_narratives``) including narrative / script / segments / music_direction / hook_strategy as required by the tool schema 3. ``brand_id``, ``company_id``, and a fresh ``job_id`` (``<slug>-<uuid4>``) ## Orientation Derive from the brief's aspect ratio: - ``9:16`` → ``portrait`` - ``16:9`` → ``landscape`` - ``1:1`` → ``square`` ## Agent flow (public connector) 1. Confirm product vs brand-general intent; for brand-general creatives use ``generate_image_ad`` instead. Gather product + images; confirm aspect / duration / creative prompt. 2. ``fetch_product_video_narratives`` → present options → wait for selection. 3. Call this tool with the selected narrative + imagery + orientation. 4. If a generation widget appears, briefly confirm the job is running and let the widget finish — do not narrate a manual status loop. 5. If no widget appears, share ``job_id`` and wait for the user to ask for status; then ``get_generation_status`` **once** and follow ``next_action``. This is a paid render: it deducts **30 credits** when the job is submitted. If the account is short on credits the tool returns a ``credit_insufficient`` result and does **not** start the render — relay that to the user and do not retry until they top up. ## Intent keywords product video, multi-scene commercial, TikTok video ad, Reels video, paid-media video

generate_product_video

Custom conversion / property definitions available on the brand for launch or reporting. Also listed as ``get_custom_properties``; both names invoke the same tool. ## When to use - Need a custom conversion event or property before a launch ## When not to use - Not performance metrics ## Intent keywords custom conversions, conversion events, pixel events

get_ad_custom_properties

List ad sets / ad groups under a campaign (targeting, budget, status). Typically scoped with ``campaign_id`` (and ``ad_group_ids`` when known). An unscoped brand-wide list may return ``status=timeout``. ## When to use - Inspect ad sets before adding ads or changing targeting/budget ## When not to use - Not for creating an ad set (use ``launch_*`` with ``campaign_spec``) ## Intent keywords ad sets, ad groups, Meta ad set, Facebook ad set, campaign structure

get_ad_groups

List ads in an ad set (creative, status, destination). ## When to use - Inspect live ads before pause, delete, or a new launch into the same set ## When not to use - Not for creating an ad (use ``launch_*`` with ``ad_group_spec``) ## Intent keywords ads, creatives in flight, Meta ads, Facebook ads, ad objects

get_ads

Fetch one Omneky brand record by id (name, company, basic fields). ## When to use - Look up a known ``brand_id`` before analytics or launches ## When not to use - Not for logo, colors, copy, or creative assets (use ``get_brand_details``) - Not for listing every brand (use ``list_brands``) ## Intent keywords brand record, brand_id, advertiser

get_brand

Fetch brand identity used for ads: logo, colors, copy, company_id, and creative assets. ## When to use - Need brand look-and-feel for a launch or creative brief - Need ``company_id`` or brand assets after ``list_brands`` ## When not to use - Not for product SKUs (use ``list_brand_products``) - Not for ROAS / CTR / spend (use analytics tools) ## Intent keywords brand book, logo, colors, brand assets, company_id

get_brand_details

Fetch one Omneky brand record by id (name, company, basic fields). Also listed as ``get_brand``; both names invoke the same tool. ## When to use - Look up a known ``brand_id`` before analytics or launches ## When not to use - Not for logo, colors, copy, or creative assets (use ``get_brand_details``) - Not for listing every brand (use ``list_brands``) ## Intent keywords brand record, brand_id, advertiser

get_brand_summary

Name lookup for campaigns and ad groups — useful when matching user language to ids. ## When to use - Resolve a campaign or ad-set name the user said out loud ## When not to use - Not a full entity listing with status/budget (use ``get_campaigns`` / ``get_ad_groups``) ## Intent keywords campaign names, ad set names, name lookup

get_campaign_ad_group_names

List paid-media campaigns for a brand and channel (Meta/Facebook, Google, TikTok, LinkedIn, Reddit): ids, status, budget. ## When to use - Inspect existing campaigns before launching, pausing, or reporting ## When not to use - Not for creating a campaign (use the matching ``launch_*`` tool) ## Intent keywords campaigns, Meta campaigns, Facebook campaigns, Google campaigns, TikTok, LinkedIn, Reddit

get_campaigns

Current budget / spend snapshot for a paid-media channel on the brand. ## When to use - Check how much is allocated or spent on Meta, Google, TikTok, LinkedIn, or Reddit ## When not to use - Not the historical ROAS/CTR series (use ``get_daily_metrics``) ## Intent keywords budget, spend, channel budget, media spend, Meta, Google, TikTok

get_channel_budget

Whether the brand's Meta/Facebook, Google, TikTok, LinkedIn, or Reddit ad account is connected and launchable. ## When to use - Before any ``launch_*`` call, to see which paid-media channels are linked ## When not to use - Not campaign performance ## Intent keywords ad account connected, Meta Business, Google Ads link, TikTok ads manager, LinkedIn Campaign Manager, Reddit ads

get_channel_connection_status

Peek at an existing image or video generation ``job_id``. Does not start a render. Returns status and, when complete, asset URLs plus a ``next_action``. Typical use is a single call per user ask. ## When to use - User has a ``job_id`` from an Omneky image/video generation and asks whether it is ready - No host widget is already polling the job ## When not to use - Not for starting a new image or video (those tools live on the full Omneky connector) - Not a substitute for analytics (ROAS / CTR) ## Intent keywords job status, generation ready, creative job_id, render status

get_generation_status

Return the signed-in Omneky user's identity from the session JWT (``user_id``, email, company). Needed as ``user_id`` on several analytics and creative calls. ## When to use - A later tool needs ``user_id`` (``get_trending``, daily metrics, image ad generation) - The host needs to know who is signed in ## When not to use - Not a substitute for ``list_brands`` or brand performance data ## Intent keywords user id, signed-in user, session identity, omneky account

get_current_user

Custom conversion / property definitions available on the brand for launch or reporting. ## When to use - Need a custom conversion event or property before a launch ## When not to use - Not performance metrics ## Intent keywords custom conversions, conversion events, pixel events

get_custom_properties

Day-by-day paid-media time series for a brand and date range: spend, impressions, clicks, CTR, conversions, ROAS, and related metrics. Use for charts and period totals. ``selected_conversion_metric_value`` is the brand's configured goal and varies per channel. Totals across channels mix incompatible goals; group by channel or use a named metric (purchases, clicks, …). ## When to use - User asks how ads performed over time (this week, last month) - Need a chart of spend, ROAS, CTR, CPA, or conversions - Compare daily paid-media performance ## When not to use - Not for a ranked breakdown by campaign/creative/channel (use ``get_dimension_summary``) - Not for what rose or fell vs the prior period (use ``get_trending``) - Not a SQL / warehouse query (there is no ``run_sql_query`` on this surface) - Not a score / lift endpoint ## Intent keywords ROAS, CTR, CPA, CPC, CPM, spend, impressions, clicks, conversions, daily metrics, time series, paid media performance, Meta, Facebook, Google Ads, TikTok, LinkedIn, Reddit

get_daily_metrics

Ranked paid-media breakdown by a dimension — creative, campaign, ad set, ad, channel, or similar — with spend, ROAS, CTR, and conversions. Use for 'which ads/campaigns are winning'. ``selected_conversion_metric_value`` is the brand's configured goal and varies per channel. Totals across channels mix incompatible goals; group by channel or use a named metric (purchases, clicks, …). ## When to use - Which creatives, campaigns, or channels have the best ROAS / CTR - Ranked leaderboard of paid-media entities - Breakdown of Meta, Google, TikTok, LinkedIn, or Reddit performance ## When not to use - Not for a day-by-day chart (use ``get_daily_metrics``) - Not for what changed vs last period (use ``get_trending``) - Not a SQL / warehouse query (there is no ``run_sql_query`` on this surface) - Not a score / lift endpoint ## Intent keywords ROAS, CTR, spend, creative breakdown, campaign performance, channel mix, Meta ads, Facebook ads, Google Ads, TikTok ads, LinkedIn ads, Reddit ads, paid media

get_dimension_summary

Ranked paid-media breakdown by a dimension — creative, campaign, ad set, ad, channel, or similar — with spend, ROAS, CTR, and conversions. Use for 'which ads/campaigns are winning'. Also listed as ``get_dimension_summary``; both names invoke the same tool. ``selected_conversion_metric_value`` is the brand's configured goal and varies per channel. Totals across channels mix incompatible goals; group by channel or use a named metric (purchases, clicks, …). ## When to use - Which creatives, campaigns, or channels have the best ROAS / CTR - Ranked leaderboard of paid-media entities - Breakdown of Meta, Google, TikTok, LinkedIn, or Reddit performance ## When not to use - Not for a day-by-day chart (use ``get_daily_metrics``) - Not for what changed vs last period (use ``get_performance_movers``) - Not a SQL / warehouse query (there is no ``run_sql_query`` on this surface) - Not a score / lift endpoint ## Intent keywords ROAS, CTR, spend, creative breakdown, campaign performance, channel mix, Meta ads, Facebook ads, Google Ads, TikTok ads, LinkedIn ads, Reddit ads, paid media

get_performance_breakdown

What rose or fell versus the prior period for a brand's paid-media metrics (spend, ROAS, CTR, conversions, and similar). Also listed as ``get_trending``; both names invoke the same tool. ``selected_conversion_metric_value`` is the brand's configured goal and varies per channel. Totals across channels mix incompatible goals; group by channel or use a named metric (purchases, clicks, …). ## When to use - What is trending up or down in ad performance - Winners and losers vs last week / last period ## When not to use - Not for a full ranked table (use ``get_performance_breakdown``) - Not for a daily time series (use ``get_daily_metrics``) - Not a SQL / warehouse query (there is no ``run_sql_query`` on this surface) - Not a score / lift endpoint ## Intent keywords trending, period-over-period, ROAS change, CTR change, paid media winners, Meta, Facebook, Google, TikTok

get_performance_movers

Full catalogue record for one product: name, description, images, and URL. Ground a product-specific ad or video in this data. Also listed as ``fetch_product_details``; both names invoke the same tool. ## When to use - Need imagery and copy for a known ``product_id`` ## When not to use - Not for listing every product (use ``list_brand_products``) ## Intent keywords product details, product images, catalogue item, SKU

get_product_details

AI creative / media recommendations for a brand based on recent paid-media performance. May return ``status=timeout`` or truncated; a tighter date window is typical. ## When to use - User asks what to try next, which creatives to scale, or recommendations ## When not to use - Not raw metrics (use ``get_dimension_summary`` / ``get_daily_metrics``) - Not a launch or generate-creative action ## Intent keywords recommendations, scale winners, creative advice, paid media insights

get_recommendations

Resolve TikTok location ids required on TikTok ad-group targeting. TikTok launches need this pre-call. ## When to use - User wants a TikTok traffic, conversions, leads, or video-views ad ## When not to use - Not for Meta, Google, LinkedIn, or Reddit targeting ## Intent keywords TikTok locations, TikTok geo, TikTok targeting, location_ids

get_tiktok_location_ids

What rose or fell versus the prior period for a brand's paid-media metrics (spend, ROAS, CTR, conversions, and similar). ``selected_conversion_metric_value`` is the brand's configured goal and varies per channel. Totals across channels mix incompatible goals; group by channel or use a named metric (purchases, clicks, …). ## When to use - What is trending up or down in ad performance - Winners and losers vs last week / last period ## When not to use - Not for a full ranked table (use ``get_dimension_summary``) - Not for a daily time series (use ``get_daily_metrics``) - Not a SQL / warehouse query (there is no ``run_sql_query`` on this surface) - Not a score / lift endpoint ## Intent keywords trending, period-over-period, ROAS change, CTR change, paid media winners, Meta, Facebook, Google, TikTok

get_trending

Resolve Google Ads country targeting fragments for Demand Gen (``targeting_fragments``). ## When to use - Launching a Google Demand Gen ad that needs country targeting ## When not to use - Not Performance Max (PMax uses ``link_url`` / automatic places) ## Intent keywords Google Demand Gen, Google Ads countries, targeting_fragments, YouTube, Discover

google_country_search

Confirm this Omneky MCP connector is reachable. Returns a simple ok status and server identity. Not a source of advertising data. ## When to use - Connectivity / smoke check that the Omneky connector responds ## When not to use - Not for paid-media performance, ROAS, CTR, catalogue, or launches (use the analytics, catalogue, or ``launch_*`` tools) - Not for application deployment, DNS records, hosting, or infrastructure administration ## Intent keywords omneky health, connector status, ping, reachability

health_check

Classify a product-page URL before scrape: single product vs listing/category. Skip scrape on listing pages. ## When to use - User pastes a product or category URL to import into the catalogue ## When not to use - Not the scrape itself (use ``scrape_product_from_url`` after this confirms a single product) ## Intent keywords product URL, PDP, scrape check, catalogue import

identify_product_from_url

Launch a Google Ads paid-media Demand Gen (YouTube / Gmail / Discover) ad for the signed-in brand. Creates or extends Campaign → Ad Set (ad_group) → Ad on the connected Google account. Can start a new campaign or add to an existing campaign/ad set via ``campaign_spec`` / ``ad_group_spec``. New launches typically start paused. Resolve countries with ``google_country_search`` / ``search_google_countries`` and pass ``adset_spec_fragment`` values as ``targeting_fragments``. ## When to use - User wants Google Demand Gen, YouTube, Discover, or Gmail ads ## When not to use - Not for reading ROAS, CTR, spend, or other performance (use ``get_dimension_summary`` / ``get_daily_metrics`` / ``get_trending``) - Not for pausing, resuming, or changing budget/targeting on an existing entity (use ``set_ad_entity_status`` / ``set_ad_budget`` / ``update_ad_targeting``) - Not for deleting a campaign, ad set, or ad (use ``delete_*``) - Not for application deployment, DNS records, hosting, or infrastructure administration ## Intent keywords Google Demand Gen, YouTube ads, Discover, Gmail ads, Google Ads, paid media

launch_google_demand_gen_ad

Launch a Google Ads paid-media Performance Max (PMax / Shopping+) ad for the signed-in brand. Creates or extends Campaign → Ad Set (ad_group) → Ad on the connected Google account. Can start a new campaign or add to an existing campaign/ad set via ``campaign_spec`` / ``ad_group_spec``. New launches typically start paused. ## When to use - User wants Google Performance Max, PMax, or Shopping-style paid search/display ## When not to use - Not for reading ROAS, CTR, spend, or other performance (use ``get_dimension_summary`` / ``get_daily_metrics`` / ``get_trending``) - Not for pausing, resuming, or changing budget/targeting on an existing entity (use ``set_ad_entity_status`` / ``set_ad_budget`` / ``update_ad_targeting``) - Not for deleting a campaign, ad set, or ad (use ``delete_*``) - Not for application deployment, DNS records, hosting, or infrastructure administration ## Intent keywords Google Ads, Performance Max, PMax, Shopping, Google conversions, YouTube, Search, Display, paid media

launch_google_performance_max_ad

Launch a LinkedIn paid-media brand-awareness ad for the signed-in brand. Creates or extends Campaign → Ad Set (ad_group) → Ad on the connected LinkedIn account. Can start a new campaign or add to an existing campaign/ad set via ``campaign_spec`` / ``ad_group_spec``. New launches typically start paused. ``start_date`` is required when creating a new campaign group. Location targeting from ``targeting_search`` / ``search_ad_targeting`` must include a ``urn:li:adTargetingFacet:locations`` entry or the API returns 400. ## When to use - User wants LinkedIn brand-awareness or B2B reach ads ## When not to use - Not for reading ROAS, CTR, spend, or other performance (use ``get_dimension_summary`` / ``get_daily_metrics`` / ``get_trending``) - Not for pausing, resuming, or changing budget/targeting on an existing entity (use ``set_ad_entity_status`` / ``set_ad_budget`` / ``update_ad_targeting``) - Not for deleting a campaign, ad set, or ad (use ``delete_*``) - Not for application deployment, DNS records, hosting, or infrastructure administration ## Intent keywords LinkedIn ads, B2B awareness, LinkedIn Campaign Manager, paid media

launch_linkedin_brand_awareness_ad

Launch a LinkedIn paid-media conversions / ROAS-style ad for the signed-in brand. Creates or extends Campaign → Ad Set (ad_group) → Ad on the connected LinkedIn account. Can start a new campaign or add to an existing campaign/ad set via ``campaign_spec`` / ``ad_group_spec``. New launches typically start paused. ``start_date`` is required when creating a new campaign group. Location targeting from ``targeting_search`` / ``search_ad_targeting`` must include a ``urn:li:adTargetingFacet:locations`` entry or the API returns 400. ## When to use - User wants LinkedIn conversion or lead-to-revenue campaigns ## When not to use - Not for reading ROAS, CTR, spend, or other performance (use ``get_dimension_summary`` / ``get_daily_metrics`` / ``get_trending``) - Not for pausing, resuming, or changing budget/targeting on an existing entity (use ``set_ad_entity_status`` / ``set_ad_budget`` / ``update_ad_targeting``) - Not for deleting a campaign, ad set, or ad (use ``delete_*``) - Not for application deployment, DNS records, hosting, or infrastructure administration ## Intent keywords LinkedIn conversions, B2B ROAS, LinkedIn ads, paid media

launch_linkedin_conversions_ad

Launch a LinkedIn paid-media engagement (reactions, comments, followers) ad for the signed-in brand. Creates or extends Campaign → Ad Set (ad_group) → Ad on the connected LinkedIn account. Can start a new campaign or add to an existing campaign/ad set via ``campaign_spec`` / ``ad_group_spec``. New launches typically start paused. ``start_date`` is required when creating a new campaign group. Location targeting from ``targeting_search`` / ``search_ad_targeting`` must include a ``urn:li:adTargetingFacet:locations`` entry or the API returns 400. ## When to use - User wants LinkedIn engagement or thought-leadership ads ## When not to use - Not for reading ROAS, CTR, spend, or other performance (use ``get_dimension_summary`` / ``get_daily_metrics`` / ``get_trending``) - Not for pausing, resuming, or changing budget/targeting on an existing entity (use ``set_ad_entity_status`` / ``set_ad_budget`` / ``update_ad_targeting``) - Not for deleting a campaign, ad set, or ad (use ``delete_*``) - Not for application deployment, DNS records, hosting, or infrastructure administration ## Intent keywords LinkedIn engagement, followers, social engagement, B2B ads

launch_linkedin_engagement_ad

Launch a LinkedIn paid-media website-visits / traffic ad for the signed-in brand. Creates or extends Campaign → Ad Set (ad_group) → Ad on the connected LinkedIn account. Can start a new campaign or add to an existing campaign/ad set via ``campaign_spec`` / ``ad_group_spec``. New launches typically start paused. ``start_date`` is required when creating a new campaign group. Location targeting from ``targeting_search`` / ``search_ad_targeting`` must include a ``urn:li:adTargetingFacet:locations`` entry or the API returns 400. ## When to use - User wants LinkedIn traffic / website-visit campaigns ## When not to use - Not for reading ROAS, CTR, spend, or other performance (use ``get_dimension_summary`` / ``get_daily_metrics`` / ``get_trending``) - Not for pausing, resuming, or changing budget/targeting on an existing entity (use ``set_ad_entity_status`` / ``set_ad_budget`` / ``update_ad_targeting``) - Not for deleting a campaign, ad set, or ad (use ``delete_*``) - Not for application deployment, DNS records, hosting, or infrastructure administration ## Intent keywords LinkedIn traffic, website visits, B2B clicks, LinkedIn ads

launch_linkedin_website_visits_ad

Launch a Meta / Facebook / Instagram paid-media brand-awareness / reach ad for the signed-in brand. Creates or extends Campaign → Ad Set (ad_group) → Ad on the connected Meta/Facebook account. Can start a new campaign or add to an existing campaign/ad set via ``campaign_spec`` / ``ad_group_spec``. New launches typically start paused. ## When to use - User wants Meta/Facebook reach or brand-awareness campaigns ## When not to use - Not for reading ROAS, CTR, spend, or other performance (use ``get_dimension_summary`` / ``get_daily_metrics`` / ``get_trending``) - Not for pausing, resuming, or changing budget/targeting on an existing entity (use ``set_ad_entity_status`` / ``set_ad_budget`` / ``update_ad_targeting``) - Not for deleting a campaign, ad set, or ad (use ``delete_*``) - Not for application deployment, DNS records, hosting, or infrastructure administration ## Intent keywords Meta awareness, Facebook reach, brand awareness, impressions, paid media

launch_facebook_awareness_ad

Launch a Meta / Facebook / Instagram paid-media lead-generation ad for the signed-in brand. Creates or extends Campaign → Ad Set (ad_group) → Ad on the connected Meta/Facebook account. Can start a new campaign or add to an existing campaign/ad set via ``campaign_spec`` / ``ad_group_spec``. New launches typically start paused. Set ``lead_gen_form_id`` on ad specs for native Meta lead forms. ## When to use - User wants Meta/Facebook/Instagram lead ads or instant forms ## When not to use - Not for reading ROAS, CTR, spend, or other performance (use ``get_dimension_summary`` / ``get_daily_metrics`` / ``get_trending``) - Not for pausing, resuming, or changing budget/targeting on an existing entity (use ``set_ad_entity_status`` / ``set_ad_budget`` / ``update_ad_targeting``) - Not for deleting a campaign, ad set, or ad (use ``delete_*``) - Not for application deployment, DNS records, hosting, or infrastructure administration ## Intent keywords Meta lead ads, Facebook lead form, Instagram leads, lead gen, paid media

launch_facebook_leads_ad

Launch a Meta / Facebook / Instagram paid-media sales / conversions (purchases, ROAS) ad for the signed-in brand. Creates or extends Campaign → Ad Set (ad_group) → Ad on the connected Meta/Facebook account. Can start a new campaign or add to an existing campaign/ad set via ``campaign_spec`` / ``ad_group_spec``. New launches typically start paused. ## When to use - User wants to run Meta, Facebook, or Instagram conversion/sales ads - Catalog or sales-objective paid media on Facebook ## When not to use - Not for reading ROAS, CTR, spend, or other performance (use ``get_dimension_summary`` / ``get_daily_metrics`` / ``get_trending``) - Not for pausing, resuming, or changing budget/targeting on an existing entity (use ``set_ad_entity_status`` / ``set_ad_budget`` / ``update_ad_targeting``) - Not for deleting a campaign, ad set, or ad (use ``delete_*``) - Not for application deployment, DNS records, hosting, or infrastructure administration ## Intent keywords Meta ads, Facebook ads, Instagram ads, sales, conversions, purchases, ROAS, catalogue sales, Advantage+, paid media

launch_facebook_sales_ad

Launch a Meta / Facebook / Instagram paid-media traffic / landing-page clicks ad for the signed-in brand. Creates or extends Campaign → Ad Set (ad_group) → Ad on the connected Meta/Facebook account. Can start a new campaign or add to an existing campaign/ad set via ``campaign_spec`` / ``ad_group_spec``. New launches typically start paused. ## When to use - User wants Meta/Facebook traffic ads to a site or landing page ## When not to use - Not for reading ROAS, CTR, spend, or other performance (use ``get_dimension_summary`` / ``get_daily_metrics`` / ``get_trending``) - Not for pausing, resuming, or changing budget/targeting on an existing entity (use ``set_ad_entity_status`` / ``set_ad_budget`` / ``update_ad_targeting``) - Not for deleting a campaign, ad set, or ad (use ``delete_*``) - Not for application deployment, DNS records, hosting, or infrastructure administration ## Intent keywords Meta traffic, Facebook clicks, landing page, link clicks, paid media

launch_facebook_traffic_ad

Launch a Meta / Facebook / Instagram paid-media video-views / ThruPlay ad for the signed-in brand. Creates or extends Campaign → Ad Set (ad_group) → Ad on the connected Meta/Facebook account. Can start a new campaign or add to an existing campaign/ad set via ``campaign_spec`` / ``ad_group_spec``. New launches typically start paused. ## When to use - User wants Meta/Facebook/Instagram video-view campaigns ## When not to use - Not for reading ROAS, CTR, spend, or other performance (use ``get_dimension_summary`` / ``get_daily_metrics`` / ``get_trending``) - Not for pausing, resuming, or changing budget/targeting on an existing entity (use ``set_ad_entity_status`` / ``set_ad_budget`` / ``update_ad_targeting``) - Not for deleting a campaign, ad set, or ad (use ``delete_*``) - Not for application deployment, DNS records, hosting, or infrastructure administration ## Intent keywords Meta video views, Facebook ThruPlay, Instagram Reels ads, video views

launch_facebook_video_views_ad

Launch a Reddit paid-media awareness / reach ad for the signed-in brand. Creates or extends Campaign → Ad Set (ad_group) → Ad on the connected Reddit account. Can start a new campaign or add to an existing campaign/ad set via ``campaign_spec`` / ``ad_group_spec``. New launches typically start paused. Reddit ``bid_value`` is microcurrency (dollars × 1,000,000); $5/day is ``5000000``. ## When to use - User wants Reddit awareness or community-reach ads ## When not to use - Not for reading ROAS, CTR, spend, or other performance (use ``get_dimension_summary`` / ``get_daily_metrics`` / ``get_trending``) - Not for pausing, resuming, or changing budget/targeting on an existing entity (use ``set_ad_entity_status`` / ``set_ad_budget`` / ``update_ad_targeting``) - Not for deleting a campaign, ad set, or ad (use ``delete_*``) - Not for application deployment, DNS records, hosting, or infrastructure administration ## Intent keywords Reddit ads, Reddit awareness, community ads, paid media

launch_reddit_awareness_ad