Run1Ads: live Meta ads consultant

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Live Meta ads consultant for e-commerce. Checks ads, Pixel and store hourly, then gives the one fix.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Run1Ads: live Meta ads consultant": {
      "url": "https://run1ads.ai/mcp/rpc",
      "transport": "streamable-http"
    }
  }
}

Measured tools (17)

• list_brands read-only

  List the brands this Run1Ads account can open, with each brand id, name and whether Meta is connected. Use it first when the user manages more than one brand or names a brand, then pass brand_id to the other tools. Every other tool uses the most recently updated brand when brand_id is left out.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_today read-only

  Start here for "what should I do today?" or "what's wrong with my Meta ads?". Returns today's brief: the one fix to do first, other findings ranked by buyers lost (each with its item_key, the number behind it and exact steps), what changed, what is working and the live check status. It summarises the other tools; use get_performance for full numbers, get_live_alerts for every alert, get_sales_funnel for each funnel step. Also returns the Today screen: needs_you_now (critical live alerts, shown first), the headline (for example "3 fixes could lift your ROAS from 1.9x to about 2.6x", all estimates) and up to 3 fixes with problem, fix and worth. Pass an item_key to add_to_fix_list or send_paused_draft. Saved data from the latest hourly check.

  Parameters:

  • brand_id — string — Brand id from list_brands. Leave it out to use your most recently updated brand.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_performance read-only

  Use for questions about results and goals: "what's my ROAS?", "how much did I spend?", "am I on track this month?". Returns saved Meta ads totals (spend, revenue, ROAS, purchases, click rate, cost per click, frequency) and this month's ROAS goal with the gap to it. For where buyers drop out use get_sales_funnel; for per ad tiredness use get_ad_fatigue. Saved data, refreshed by the hourly check.

  Parameters:

  • brand_id — string — Brand id from list_brands. Leave it out to use your most recently updated brand.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_sales_funnel read-only

  Use for "where am I losing buyers?" or "people click but don't buy". Returns each step from ad click to purchase as how many in 1,000 move on, the e-commerce benchmark per 1,000, above or below, the trend, and which step loses the most buyers. For totals like spend and ROAS use get_performance; for why visitors leave the store use get_store_checks. Saved data, refreshed by the hourly check.

  Parameters:

  • brand_id — string — Brand id from list_brands. Leave it out to use your most recently updated brand.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_live_alerts read-only

  Use for "is anything broken right now?" or "any alerts?". Returns when the hourly live check last ran, today so far, open alerts with critical first (for example spend with no sales, a rejected ad, a broken Pixel or store) and, unless include_resolved is false, alerts resolved in the last 7 days. Each alert says why it matters and how to fix it. get_today shows only the top items; this shows them all. Saved data, checked every hour.

  Parameters:

  • brand_id — string — Brand id from list_brands. Leave it out to use your most recently updated brand.
  • include_resolved — boolean — Include alerts resolved in the last 7 days.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_store_checks read-only

  Use for questions about the store and tracking, not the ads: "is my Pixel working?", "does my store work in the Instagram browser?", "why do visitors from my ads leave?". Returns whether the store works inside the Instagram and Facebook app browser, whether Add to Cart shows on mobile, whether the Meta Pixel fired, five store scores out of 100, the weakest product pages, and the "Problems to fix" for visitors from Meta ads (landing pages they leave straight away, app layers or buttons that ignore taps, store script errors, weak campaigns, slow pages), each with the numbers, why it matters, fix steps and example visits, plus where they leave. Also the top 3 causes of "Why visitors are not buying" (all of them: get_why_no_buy). For funnel rates use get_sales_funnel; for each campaign's visit to cart funnel use get_campaign_funnels. Saved data from the latest daily store walk and daily visitor review.

  Parameters:

  • brand_id — string — Brand id from list_brands. Leave it out to use your most recently updated brand.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_campaign_funnels read-only

  Use for "which campaign sends the best visitors?", "which landing page is weakest?" or "where do visitors from each campaign drop out?". Returns, per campaign (utm_campaign or campaign id, plus visits not tagged with a campaign) for the last 7 and 30 days: visits, the share who left straight away (one page, no scroll past the first quarter), who viewed a product, reached the cart and reached checkout (or "not visible" when the checkout runs on a separate Shopify checkout page), pages per visit, the top landing page, the weakest step, and which campaign is best and weakest. Same table as the app's Funnel by campaign. For Meta's own funnel use get_sales_funnel. Saved data from the daily visitor review.

  Parameters:

  • brand_id — string — Brand id from list_brands. Leave it out to use your most recently updated brand.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_why_no_buy read-only

  Use for "why are visitors from my Meta ads not adding to cart, not checking out or not buying?". Returns the stage strip from visit to product, add to cart, checkout and purchase (with counts, or "not visible" when we cannot see that step yet), the biggest drop against the e-commerce benchmark, and the likely causes ranked by buyers lost (about), each with its stage, how likely it is (high, medium, low), what we saw with the numbers, the likely cause, 2 to 4 fix steps and what would confirm it. Covers traffic and targeting, ad to page promise, technical problems (in app browser, speed, pop ups, failed adds, sold out products, the Pixel), the product page, cart and checkout friction, measurement gaps and the Meta account. Also lists what we cannot see yet and how to see it (for example the optional Shopify checkout pixel). Same as the app's "Why visitors are not buying". Saved data from the daily visitor review, computed on demand when missing.

  Parameters:

  • brand_id — string — Brand id from list_brands. Leave it out to use your most recently updated brand.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_ad_fatigue read-only

  Use for "which ads are getting tired?" or "should I refresh my creative?". Returns each ad's frequency, click rate and its change, and hook rate, highest frequency first, so you can see which ads people have seen too often. For the copy and video content itself use get_ad_copy_review; for account totals use get_performance. Saved data, refreshed by the hourly check.

  Parameters:

  • brand_id — string — Brand id from list_brands. Leave it out to use your most recently updated brand.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_ad_copy_review read-only

  Use for "is my ad copy good?" or "why do viewers skip my video?". Returns a review of ads already running: first line, headline, call to action and link, with a score and specific issues, plus video ads from the last 7 days with hook rate, hold rate, where viewers drop off, a visual review of the frames and fix steps. For which ads are tired use get_ad_fatigue. Saved data from the latest review.

  Parameters:

  • brand_id — string — Brand id from list_brands. Leave it out to use your most recently updated brand.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_audiences read-only

  Use for "who is buying?", "which placement works best?" or "is my custom audience big enough?". Returns buyers in the period, saved custom audiences with size and whether each is big enough to deliver, and results split by placement (Instagram, Facebook, Reels, Stories). For overall ROAS use get_performance; for funnel drop offs use get_sales_funnel. Saved data from the latest Meta read.

  Parameters:

  • brand_id — string — Brand id from list_brands. Leave it out to use your most recently updated brand.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_competitor_changes read-only

  Use for "what are my competitors doing?". Returns recent changes in the brand's chosen competitors' Meta ads: who changed what (number of ads, angle, format) and when. Competitors are set in the Run1Ads app. Saved data, refreshed weekly.

  Parameters:

  • brand_id — string — Brand id from list_brands. Leave it out to use your most recently updated brand.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_fix_list read-only

  Use for "what have I committed to?" or "did my fix work?". Returns the fixes the user chose to do, filtered by status (open, done or all, default all), each with its fix_id and, once newer data is saved, whether the tracked number moved after the fix was marked done. Use the fix_id with mark_fix_done. For new findings use get_today.

  Parameters:

  • status — string
  • brand_id — string — Brand id from list_brands. Leave it out to use your most recently updated brand.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• add_to_fix_list

  Add a fix to the brand's Run1Ads fix list. Pass item_key from get_today to add that finding with its steps and the number to track, or pass your own title. Writes to Run1Ads only. Nothing changes in Meta or on your store.

  Parameters:

  • how — array — Steps to apply it.
  • why — string
  • title — string — Your own fix title, if not using item_key.
  • pillar — string — funnel, journey, fatigue, content, audience, strategy or general.
  • brand_id — string — Brand id from list_brands. Leave it out to use your most recently updated brand.
  • item_key — string — The key of a finding from get_today (for example vc_atc or fatigue).

  Hints: read-only no · destructive no · idempotent no · open-world no

• mark_fix_done

  Mark a fix on the fix list as done. Run1Ads records the number at that moment so it can show whether the fix worked once newer data is saved. Writes to Run1Ads only.

  Parameters:

  • fix_id (required) — integer — The fix id from get_fix_list.
  • brand_id — string — Brand id from list_brands. Leave it out to use your most recently updated brand.

  Hints: read-only no · destructive no · idempotent yes · open-world no

• ask_consultant read-only

  Ask the Run1Ads consultant a question about this brand in plain English. It answers from the saved account data only, with exact steps you can apply. It advises only and never changes anything. Up to 10 questions per brand per day, shared with the app.

  Parameters:

  • question (required) — string
  • brand_id — string — Brand id from list_brands. Leave it out to use your most recently updated brand.

  Hints: read-only yes · destructive no · idempotent no · open-world no

• send_paused_draft

  Send one finding from get_today to the brand's own Meta ad account as a PAUSED campaign and ad set, so you can finish and switch it on yourself in Ads Manager. Nothing spends. Only findings marked draftable can be sent. Only use this when the user has clearly asked for it, and pass confirm true. Without confirm it returns a preview and sends nothing.

  Parameters:

  • item_key (required) — string — The key of a draftable finding from get_today (fatigue, creative_copy, placement or lookalike).
  • confirm — boolean — Must be true, and only after the user explicitly asked to send this draft.
  • brand_id — string — Brand id from list_brands. Leave it out to use your most recently updated brand.
  • objective — string
  • daily_budget_usd — number — Daily budget saved on the paused draft. It does not spend until you switch the draft on.

  Hints: read-only no · destructive no · idempotent no · open-world yes

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.