Skip to main content
Glama
hunterInt

AdvertiserLeads MCP server

by hunterInt

AdvertiserLeads MCP server

Ask Claude, ChatGPT, Cursor or any MCP client which ecommerce brands just started running Meta ads, which ones are scaling, and what each brand's store runs on, then go straight to research and outreach in the same chat.

AdvertiserLeads checks ecommerce brands' US Meta ads every day and turns the changes into lead signals:

Signal

Meaning

newly_advertising

The brand's first ad is recent and we found no older ones in the Ad Library

scaling

Its number of live ads is growing

struggling

Its ads are being cut back or dropping off

stopped

It stopped advertising

Each brand also comes with its store platform (Shopify and others) and the tracking pixels and marketing tools on its site: Meta, Google Ads, GA4, GTM, TikTok, Pinterest, Snapchat, Reddit, Bing, Klaviyo, Triple Whale, Northbeam, Elevar, Attentive and Postscript.

Any store, any category. Brand lookups and store checks work on any ecommerce domain you give them, whatever it sells. The daily signal feed covers a growing list of categories (automotive aftermarket, supplements, skincare, pet, home & kitchen, with more added every month). See Coverage.

This repository holds the setup guide, config snippets and registry metadata. The server itself is hosted by AdvertiserLeads, so there's nothing to install or run.

Status: early. The endpoint, tool names and limits below are v1 and may still change before launch.

Connect

Endpoint

https://advertiserleads.com/mcp

Transport

Streamable HTTP

Auth

Optional. Sign in with your AdvertiserLeads account over OAuth 2.1 (Claude, ChatGPT, Claude Code and other OAuth-capable clients), or send Authorization: Bearer al_... with an API key from Settings. Without either it works anonymously, with lower limits.

Signing in and an API key give the same result: your account's plan and limits. When an anonymous client hits a limit that an account raises, the server answers 401 with a WWW-Authenticate challenge, so clients that support OAuth offer to sign in and then retry. You can see and disconnect signed-in apps under Connected apps in Settings.

Claude Code

claude mcp add --transport http advertiserleads https://advertiserleads.com/mcp

It starts anonymously. To sign in, run /mcp in Claude Code, pick advertiserleads and choose Authenticate; your browser opens the AdvertiserLeads sign-in page.

Or use an API key instead of signing in:

claude mcp add --transport http advertiserleads https://advertiserleads.com/mcp --header "Authorization: Bearer al_YOUR_KEY"

Claude (claude.ai and the desktop app)

  1. Open Settings → Connectors and choose Add custom connector.

  2. Name it AdvertiserLeads and paste https://advertiserleads.com/mcp as the URL. Leave the OAuth client fields empty.

  3. In a chat, turn it on from the tools menu.

Claude uses the tools anonymously at first. When you hit a limit an account raises, Claude shows a Connect button; sign in with your AdvertiserLeads email and Claude retries the call with your plan.

ChatGPT

  1. Open Settings → Apps & Connectors → Advanced settings and turn on Developer mode (Plus, Pro, Business, Enterprise or Edu).

  2. Back in Apps & Connectors, choose Create, name it AdvertiserLeads, paste https://advertiserleads.com/mcp, and pick OAuth. ChatGPT registers itself; no client ID or secret is needed.

  3. Sign in with your AdvertiserLeads email when asked, then select it from the + menu under Developer mode in a chat.

Cursor

Add this to ~/.cursor/mcp.json (or .cursor/mcp.json in a project). See examples/cursor-mcp.json.

{
  "mcpServers": {
    "advertiserleads": {
      "url": "https://advertiserleads.com/mcp",
      "headers": { "Authorization": "Bearer al_YOUR_KEY" }
    }
  }
}

VS Code (GitHub Copilot agent mode)

Add this to .vscode/mcp.json. VS Code asks for the key once and stores it securely. See examples/vscode-mcp.json.

{
  "inputs": [
    {
      "type": "promptString",
      "id": "advertiserleads-key",
      "description": "AdvertiserLeads API key (starts with al_)",
      "password": true
    }
  ],
  "servers": {
    "advertiserleads": {
      "type": "http",
      "url": "https://advertiserleads.com/mcp",
      "headers": { "Authorization": "Bearer ${input:advertiserleads-key}" }
    }
  }
}

Anything else

Any client that supports remote MCP servers over Streamable HTTP can use https://advertiserleads.com/mcp, signed in or with the optional Authorization header.

For OAuth clients, the server follows the MCP authorization spec:

Protected resource metadata

https://advertiserleads.com/.well-known/oauth-protected-resource/mcp

Authorization server metadata

https://advertiserleads.com/.well-known/oauth-authorization-server

Client registration

Dynamic Client Registration (RFC 7591) or a Client ID Metadata Document URL

Flow

Authorization code with PKCE (S256 only), rotating refresh tokens, revocation (RFC 7009)

Redirect URIs

Any https URI, an app's own URI scheme, or a loopback http://localhost / http://127.0.0.1 address on any port

Scope

mcp

Related MCP server: Facebook Ads Library MCP Server

Tools

Tool

What it does

Inputs

search_signals

Today's lead signals: brands that are newly advertising, scaling, struggling or stopped

niche, signal, min_ads, platform (store platform), pixel (tracking pixel or tool), q (text search), limit, offset

lookup_brand

One brand by domain: when it started advertising, live ads and trend

domain

check_store

A site's store platform and the tracking pixels and marketing tools it loads

domain

list_niches

The niches we track, with their ids for search_signals

none

Without signing in or on the free plan, search_signals only filters by niche; signal, min_ads, platform, pixel and q need a paid plan.

Coverage

  • lookup_brand and check_store work for any store, in any category. Give them a domain and they check it, even if we've never seen it before.

  • search_signals covers the categories we crawl every day:

    Niche

    id

    Automotive aftermarket

    auto_aftermarket

    Supplements

    supplements

    Skincare

    skincare

    Pet

    pet

    Home & kitchen

    home_kitchen

    A new niche starts returning results once it tracks 50 confirmed stores, and we add new niches every month. list_niches always returns the current list.

  • Don't see yours? Request a niche and we'll email you when it's live.

What you get on each plan

The server follows the same plan rules as the website, so it never shows more than your plan does there.

Not signed in, no key

Free account

Paid plans

search_signals

Masked brands: signal, niche, ad counts, channels and store are visible; name, domain and Ad Library link are hidden. Only the niche filter applies

Masked, as on the free feed. Only the niche filter applies

Full rows, counted toward your plan's monthly export rows. Every filter applies

lookup_brand

Advertising since, live ads and trend

Full result for 5 new domains a day

Full result; Pro and up also get ad history

check_store, list_niches

Yes

Yes

Yes

Lookups of brands we haven't seen before cost a live Ad Library check, so they have a daily limit. Plans and pricing: Free, Starter $49, Pro $99, Agency $249 a month, and custom Data / API plans.

Example prompts

Swap in your own category or list of domains; the brand and store tools aren't limited to the niches below.

Anyone

  • "Here are 20 stores I'm prospecting: [domains]. Which ones run Meta ads right now, since when, and is their ad count going up or down?"

  • "Is this brand still advertising? Check brand.com and tell me what store platform and marketing tools it uses."

Agencies

  • "Find automotive aftermarket brands that started advertising on Meta this week. Keep the Shopify stores with Klaviyo installed, and draft a three-line intro email for each offering to take over their Meta ads."

  • "Which skincare brands are scaling right now with more than 10 live ads? Group them by store platform."

  • "Find pet brands that just started running Meta ads and use the TikTok pixel too. Those already test new channels, so draft a pitch for our TikTok Shop service."

UGC creators

  • "List supplement brands that are newly advertising and still have under 5 live ads. Those are the ones that need more creative. Write me a short DM pitching a UGC test package to each."

  • "Look up gymshark.com and tell me how long they've been advertising and whether their ad count is going up."

SaaS and app sellers

  • "Find Shopify stores in home & kitchen that are scaling but don't have Klaviyo. Draft an email pitching our email-marketing app."

  • "Check these five domains and tell me which ones run the TikTok pixel and which use Triple Whale or Northbeam."

Lenders and revenue-based financing

  • "Which brands across all niches are scaling fastest this week? Those may need working capital for inventory. Give me a shortlist with store platform and live ad counts."

  • "Show me skincare brands that stopped advertising in the last month, and check which of them are still on Shopify."

About the data

  • Ads come from the Meta Ad Library, US ads only, checked daily. Busier brands are checked daily; quieter ones every 3 or 7 days.

  • "Newly advertising" is checked against the brand's full ad history, so a brand that paused and came back isn't counted as new.

  • Store platform and pixels come from loading the brand's own site.

More at advertiserleads.com.

License

The docs and config snippets in this repository are MIT licensed. See LICENSE. The license doesn't cover the AdvertiserLeads service or its data.

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    B
    maintenance
    Meta (Facebook/Instagram) Ads MCP server for ad performance reporting, audience analysis, and competitor ad research.
    41
    MIT