Run1Ads MCP

Run1Ads MCP allows AI assistants like Claude, ChatGPT, and Cursor to connect to the Run1Ads Meta ads consultant service. It enables agents to query ad performance, store health, competitor changes, and receive specific optimization fixes for e-commerce brands running Meta ads, without automatically modifying ad accounts.

Visit Ethera Business LLC

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Vendor evidenceStreamable HTTPNo sign-inEndpoint checked 2026-11-01Operated by Ethera Business LLC

You need:sign in to Run1AdsAdd a custom connector (MCP) in ChatGPT settings where your plan supports it

MCP endpoint (Streamable HTTP)

https://run1ads.ai/mcp/rpc

Vendor documentation

What you can do with it

Query today's top ad fix and ranked findings
Check store funnel performance and pixel health
Review competitor ad changes and audience data
Generate paused ad drafts for user review

Source and maintenance

Vendor evidenceRegistry 1.0.0

mcp-registry: ai.run1ads/consultant@1.0.0 Project website

Protocol and capabilities

Server: run1ads v1.0 · 2026-10-16 · consultant
MCP protocol: 2025-06-18
Tools: 19 advertised
Resources: Not advertised
Resource templates: Not advertised
Prompts: Not advertised

Server-advertised capabilities

{
  "tools": {
    "listChanged": false
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

Run1Ads is a live Meta ads consultant for e-commerce brands. We advise, you decide. Start with list_brands, then get_today for the one fix. The other get_ tools explain the funnel, live alerts, store checks, ad fatigue, ad copy, audiences and competitors. All of these read saved data and change nothing. Run1Ads never creates, launches, edits or pauses anything on its own. The only change it can make in Meta is send_paused_draft, a PAUSED draft in the brand's own ad account, and only call it when the user has clearly asked for it, with confirm true. Talk about ROAS, never margin or break even. Write "Ai", never "AI".

Tools

19 advertised

list_brands

Advertised by the server during the last successful anonymous check.

Advertised 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.

list_brands input schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

list_brands annotations

{
  "title": "List my brands",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

get_today

Advertised by the server during the last successful anonymous check.

Advertised 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.

get_today input schema

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "Brand id from list_brands. Leave it out to use your most recently updated brand."
    }
  },
  "additionalProperties": false
}

get_today annotations

{
  "title": "Today's brief and the one fix",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

get_campaigns

Advertised by the server during the last successful anonymous check.

Advertised read-only

Use for "how are my campaigns doing?", "which campaign should I fix or give more budget?" or "where does each campaign lose buyers?". Returns each campaign (biggest spend first) with its share of budget, spend and ROAS, then every step from ad click to sale (clicked the ad, looked at a product, added to cart, went to checkout, sales) against similar stores, the one step where it loses the most buyers, what to do, the problem, the fix and what it could be worth in dollars. Same view as Campaigns in the Run1Ads app. Explain ROAS in plain words when the user may not know it.

get_campaigns input schema

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "Brand id from list_brands. Leave it out to use your most recently updated brand."
    }
  },
  "additionalProperties": false
}

get_campaigns annotations

{
  "title": "Campaigns from click to sale",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

get_store_fixes

Advertised by the server during the last successful anonymous check.

Advertised read-only

Use for "what should I fix on my website?" or "what on my store is costing me sales?". Returns the problems on the store that cost sales from every campaign, each listed once and ranked by impact, with what we saw, the fix, how long it takes and who does it, and what it could be worth in dollars. Found from visits from the brand's Meta ads, no recordings kept. Same view as Store fixes in the Run1Ads app.

get_store_fixes input schema

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "Brand id from list_brands. Leave it out to use your most recently updated brand."
    }
  },
  "additionalProperties": false
}

get_store_fixes annotations

{
  "title": "Store fixes",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

get_performance

Advertised by the server during the last successful anonymous check.

Advertised 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.

get_performance input schema

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "Brand id from list_brands. Leave it out to use your most recently updated brand."
    }
  },
  "additionalProperties": false
}

get_performance annotations

{
  "title": "Performance and ROAS goal",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

get_sales_funnel

Advertised by the server during the last successful anonymous check.

Advertised 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.

get_sales_funnel input schema

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "Brand id from list_brands. Leave it out to use your most recently updated brand."
    }
  },
  "additionalProperties": false
}

get_sales_funnel annotations

{
  "title": "Sales funnel per 1,000",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

get_live_alerts

Advertised by the server during the last successful anonymous check.

Advertised 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.

get_live_alerts input schema

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "Brand id from list_brands. Leave it out to use your most recently updated brand."
    },
    "include_resolved": {
      "type": "boolean",
      "default": true,
      "description": "Include alerts resolved in the last 7 days."
    }
  },
  "additionalProperties": false
}

get_live_alerts annotations

{
  "title": "Live alerts",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

get_store_checks

Advertised by the server during the last successful anonymous check.

Advertised 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.

get_store_checks input schema

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "Brand id from list_brands. Leave it out to use your most recently updated brand."
    }
  },
  "additionalProperties": false
}

get_store_checks annotations

{
  "title": "Store checks",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

get_campaign_funnels

Advertised by the server during the last successful anonymous check.

Advertised 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.

get_campaign_funnels input schema

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "Brand id from list_brands. Leave it out to use your most recently updated brand."
    }
  },
  "additionalProperties": false
}

get_campaign_funnels annotations

{
  "title": "Funnel by campaign",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

get_why_no_buy

Advertised by the server during the last successful anonymous check.

Advertised 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.

get_why_no_buy input schema

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "Brand id from list_brands. Leave it out to use your most recently updated brand."
    }
  },
  "additionalProperties": false
}

get_why_no_buy annotations

{
  "title": "Why visitors are not buying",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

get_ad_fatigue

Advertised by the server during the last successful anonymous check.

Advertised 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.

get_ad_fatigue input schema

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "Brand id from list_brands. Leave it out to use your most recently updated brand."
    }
  },
  "additionalProperties": false
}

get_ad_fatigue annotations

{
  "title": "Ad fatigue",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

get_ad_copy_review

Advertised by the server during the last successful anonymous check.

Advertised 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.

get_ad_copy_review input schema

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "Brand id from list_brands. Leave it out to use your most recently updated brand."
    }
  },
  "additionalProperties": false
}

get_ad_copy_review annotations

{
  "title": "Ad copy review",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

get_audiences

Advertised by the server during the last successful anonymous check.

Advertised 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.

get_audiences input schema

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "Brand id from list_brands. Leave it out to use your most recently updated brand."
    }
  },
  "additionalProperties": false
}

get_audiences annotations

{
  "title": "Audiences and placements",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

get_competitor_changes

Advertised by the server during the last successful anonymous check.

Advertised read-only

Use for "what are my competitors doing?". Returns recent changes in the brand's chosen competitors' Meta ads as conclusions: what changed, what it means for this brand and what to do (or that nothing is needed). We study their ads so the user does not have to; competitor ads themselves are not shown. Competitors are set in the Run1Ads app.

get_competitor_changes input schema

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "Brand id from list_brands. Leave it out to use your most recently updated brand."
    }
  },
  "additionalProperties": false
}

get_competitor_changes annotations

{
  "title": "Competitor changes",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

get_fix_list

Advertised by the server during the last successful anonymous check.

Advertised 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.

get_fix_list input schema

{
  "type": "object",
  "properties": {
    "status": {
      "enum": [
        "open",
        "done",
        "all"
      ],
      "type": "string",
      "default": "all"
    },
    "brand_id": {
      "type": "string",
      "description": "Brand id from list_brands. Leave it out to use your most recently updated brand."
    }
  },
  "additionalProperties": false
}

get_fix_list annotations

{
  "title": "Fix list",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

add_to_fix_list

Advertised by the server during the last successful anonymous check.

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.

add_to_fix_list input schema

{
  "type": "object",
  "properties": {
    "how": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 8,
      "description": "Steps to apply it."
    },
    "why": {
      "type": "string",
      "maxLength": 1000
    },
    "title": {
      "type": "string",
      "maxLength": 300,
      "description": "Your own fix title, if not using item_key."
    },
    "pillar": {
      "type": "string",
      "description": "funnel, journey, fatigue, content, audience, strategy or general."
    },
    "brand_id": {
      "type": "string",
      "description": "Brand id from list_brands. Leave it out to use your most recently updated brand."
    },
    "item_key": {
      "type": "string",
      "description": "The key of a finding from get_today (for example vc_atc or fatigue)."
    }
  },
  "additionalProperties": false
}

add_to_fix_list annotations

{
  "title": "Add to fix list",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}

mark_fix_done

Advertised by the server during the last successful anonymous check.

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.

mark_fix_done input schema

{
  "type": "object",
  "required": [
    "fix_id"
  ],
  "properties": {
    "fix_id": {
      "type": "integer",
      "description": "The fix id from get_fix_list."
    },
    "brand_id": {
      "type": "string",
      "description": "Brand id from list_brands. Leave it out to use your most recently updated brand."
    }
  },
  "additionalProperties": false
}

mark_fix_done annotations

{
  "title": "Mark fix done",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

ask_consultant

Advertised by the server during the last successful anonymous check.

Advertised 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.

ask_consultant input schema

{
  "type": "object",
  "required": [
    "question"
  ],
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "Brand id from list_brands. Leave it out to use your most recently updated brand."
    },
    "question": {
      "type": "string",
      "maxLength": 1000,
      "minLength": 3
    }
  },
  "additionalProperties": false
}

ask_consultant annotations

{
  "title": "Ask the consultant",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}

send_paused_draft

Advertised by the server during the last successful anonymous check.

Open-world

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.

send_paused_draft input schema

{
  "type": "object",
  "required": [
    "item_key"
  ],
  "properties": {
    "confirm": {
      "type": "boolean",
      "description": "Must be true, and only after the user explicitly asked to send this draft."
    },
    "brand_id": {
      "type": "string",
      "description": "Brand id from list_brands. Leave it out to use your most recently updated brand."
    },
    "item_key": {
      "type": "string",
      "description": "The key of a draftable finding from get_today (fatigue, creative_copy, placement or lookalike)."
    },
    "objective": {
      "enum": [
        "sales",
        "traffic"
      ],
      "type": "string",
      "default": "sales"
    },
    "daily_budget_usd": {
      "type": "number",
      "default": 10,
      "maximum": 500,
      "minimum": 1,
      "description": "Daily budget saved on the paused draft. It does not spend until you switch the draft on."
    }
  },
  "additionalProperties": false
}

send_paused_draft annotations

{
  "title": "Send as a paused draft",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks: 1 of 1 (100%)
Average latency: 592 ms
95th percentile latency: 592 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

Nov 1, 2026, 1:27 PM UTC · probe · passed · 592 ms · metadata changed · 19 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.

Claude Code configuration

claude mcp add --transport http run1ads-mcp https://run1ads.ai/mcp/rpc

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).

Codex configuration

codex mcp add run1ads-mcp --url https://run1ads.ai/mcp/rpc

Cursor

Merge this server into .cursor/mcp.json in your project, then enable run1ads-mcp in your MCP settings.

Cursor configuration

{
  "mcpServers": {
    "run1ads-mcp": {
      "url": "https://run1ads.ai/mcp/rpc"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).

Cline configuration

{
  "mcpServers": {
    "run1ads-mcp": {
      "type": "streamableHttp",
      "url": "https://run1ads.ai/mcp/rpc",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start run1ads-mcp and inspect its tools.

VS Code configuration

{
  "servers": {
    "run1ads-mcp": {
      "type": "http",
      "url": "https://run1ads.ai/mcp/rpc"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.

Gemini CLI configuration

gemini mcp add --transport http run1ads-mcp https://run1ads.ai/mcp/rpc

Claude Desktop

Merge this into claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then restart Claude Desktop.

Claude Desktop configuration

{
  "mcpServers": {
    "run1ads-mcp": {
      "url": "https://run1ads.ai/mcp/rpc"
    }
  }
}

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.

Windsurf configuration

{
  "mcpServers": {
    "run1ads-mcp": {
      "serverUrl": "https://run1ads.ai/mcp/rpc"
    }
  }
}

Let your agent find its tools

Find servers like Run1Ads MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows

See all 1,009

Do you run Run1Ads MCP?

Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.

Claim this listing

Run1Ads MCP

Endpoint and access

What you can do with it

Source and maintenance

Protocol and capabilities

Server-provided instructions

Tools

Prompts

Resources

30-day availability

Maintenance history

Connect from your client

Claude Code

Codex

Cursor

Cline

VS Code

Gemini CLI

Claude Desktop

Windsurf

Let your agent find its tools

Other crm, sales, and marketing servers

Do you run Run1Ads MCP?