Facebook Ads Library MCP Server

This is a Model Context Protocol (MCP) server for the Facebook Ads Library.

With this you can search Facebook's public ads library for any company or brand, see what they're currently running and analyze their advertising. You can analyse ad images/text, get video links, compare companies' strategies, and get insights into what's working in their campaigns.

Here's an example of what you can do when it's connected to Claude.

Placeholder image

To get updates on this and other projects we work on enter your email here

Example Prompts

Coming soon - example prompts will be added here

Don't want to deal with code? Try our no-code version

Installation

Prerequisites

Python 3.12+
Anthropic Claude Desktop app (or Cursor)
Pip (Python package manager), install with python -m pip install
An access token for Scrape Creators

Steps

Clone this repository

git clone https://github.com/trypeggy/facebook-ads-library-mcp.git
cd facebook-ads-library-mcp

Obtain an API token from Scrape Creators

Sign up here

Connect to the MCP server

Copy the below json with the appropriate {{PATH}} values and {{API KEY}}:

{
  "mcpServers": {
    "fb_ad_library": {
      "command": "python",
      "args": [
        "{{PATH_TO_SRC}}/fb_ad_library_mcp/src/mcp_server.py",
        "--scrapecreators-api-key",
        "{{YOUR_SCRAPECREATORS_API_KEY}}"
      ]
    }
  }
}

For Claude Desktop:

Save this as claude_desktop_config.json in your Claude Desktop configuration directory at:

~/Library/Application Support/Claude/claude_desktop_config.json

For Cursor:

Save this as mcp.json in your Cursor configuration directory at:

~/.cursor/mcp.json

Restart Claude Desktop / Cursor

Open Claude Desktop and you should now see the Facebook Ads Library as an available integration.

Or restart Cursor.

Technical Details

Claude sends requests to the Python MCP server
The MCP server queries the ScrapeCreator API through tools
Data flows back through the chain to Claude

Available MCP Tools

This MCP server provides tools for interacting with Facebook Ads library objects:

Tool Name	Description
`get_meta_platform_id`	Returns platform ID given one or many brand names
`get_meta_ads`	Retrieves ads for a specific page (platform ID)

Troubleshooting

For additional Claude Desktop integration troubleshooting, see the MCP documentation. The documentation includes helpful tips for checking logs and resolving common issues.

Feedback

Your feedback will be massively appreciated. Please tell us which features on that list you like to see next or request entirely new ones.

License

This project is licensed under the MIT License.

License Python

Facebook Ads Library MCP Server