Mcp Meta Ad Library Monitor

No install snippet on purpose. A working MCP config is a command, its arguments and an environment block — the last two are where API keys live, so this catalogue never stores them and cannot publish them. Follow the link above for the authors' own instructions.

An MCP server that finds a company's active Facebook and Instagram ads through the Meta Ad Library API. It wraps the Mamba Labs Meta Ad Library Monitor actor on Apify and returns Clay-ready flat JSON rows to any MCP client.

What it does

Give it a company name or domain and your own Meta access token, and it searches the Meta Ad Library and returns one flat row per ad: creative text, headline, delivery dates, the Meta surfaces the ad ran on, and Meta's permanent snapshot URL for the rendered ad.

Read the coverage first, because it decides whether this tool is any use to you. It reads Meta's Ad Library Graph API, which is the only route Meta sanctions, and that API publishes two things: every ad delivered to an audience in the EU, whatever the ad is about, and social issue, election and politics ads worldwide. So an EU heavy list gets good coverage of ordinary commercial advertising, while a US or UK list of ordinary product ads mostly comes back not_found. That is Meta's dataset rather than a fault in the lookup, and every row carries a coverage note saying what the search could have found. Impressions and spend exist for political ads only and arrive as bands, so a null there is not zero spend.

All of the searching runs on Apify. This package is a thin client that calls the actor and hands back the result unchanged.

Quick start

You need Node.js 18 or newer and an Apify account with an API token.

Add this to your Claude Desktop config:

{
  "mcpServers": {
    "mamba-meta-ad-library-monitor": {
      "command": "npx",
      "args": ["-y", "@mambalabsdev/mcp-meta-ad-library-monitor"],
      "env": {
        "APIFY_TOKEN": "your-apify-token"
      }
    }
  }
}

Get your token at https://console.apify.com/account/integrations, paste it in, and restart Claude Desktop. The find_meta_ads tool will be available.

You also need your own Meta app access token, free to create at developers.facebook.com. It is passed as a tool argument rather than an environment variable, so the model supplies it per call.

Prerequisites

Node.js 18 or newer
An Apify account with an API token
Your own Meta app access token, free at developers.facebook.com. The Ad Library API is not open, so this is required.
A verified identity on your Meta account if you want political and issue ad data. That is Meta's requirement, not ours.

Example prompts

"Is gymshark.com running Facebook ads in the EU right now? Here is my Meta token."
"Show me the last 25 active ads for this company across EU audiences."
"Find video ads only for this advertiser, active and inactive."
"Search the Meta Ad Library for this brand in the UK and tell me what the coverage note says."