Allows searching and analyzing the Facebook Ads Library, providing tools to retrieve ads for specific companies or brands, analyze ad content, get video links, and compare advertising strategies.
Provides tools to retrieve platform IDs for brands and access Meta's advertising platform data, enabling detailed analysis of advertising campaigns across Meta's platforms.
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.
https://github.com/user-attachments/assets/a47aa689-e89d-4d4b-9df7-6eb3a81937ee
To get updates on this and other projects we work on enter your email here
Example Prompts
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
- Obtain an API token from Scrape CreatorsSign up here
- Connect to the MCP serverCopy the below json with the appropriate
{{PATH}}
values and{{API KEY}}
:For Claude Desktop:Save this asclaude_desktop_config.json
in your Claude Desktop configuration directory at:For Cursor:Save this asmcp.json
in your Cursor configuration directory at: - Restart Claude Desktop / CursorOpen 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.
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Enables searching and analyzing Facebook's public ads library to see what companies are currently running, including ad images/text, video links, and campaign insights.
Related MCP Servers
- AsecurityAlicenseAqualityEnables searching for Airbnb listings and retrieving detailed accommodation information with direct links to Airbnb pages.Last updated -2JavaScriptMIT License
- -securityFlicense-qualityEnables searching for AI agents by keywords or categories, allowing users to discover tools like coding agents, GUI agents, or industry-specific assistants across marketplaces.Last updated -23Python
- -securityAlicense-qualityMCP server acting as an interface to the Facebook Ads, enabling programmatic access to Facebook Ads data and management features.Last updated -54PythonMIT License
- AsecurityAlicenseAqualityEnables interaction with the French business search API from data.gouv.fr, allowing users to search for French companies by text or geographical criteria and access essential business information.Last updated -23074TypeScriptMIT License