Content
# 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](https://tally.so/r/np6rYy)
PS: Join our [Twitter community](https://twitter.com/i/communities/1937504082635170114) for all things MCP
---
## Example Prompts
```plaintext
How many ads is 'AnthropicAI' running? What’s their split across video and image?
```
```plaintext
What messaging is 'AnthropicAI' running right now in their ads?
```
```plaintext
Do a deep comparison to the messaging between 'AnthropicAI', 'Perplexity AI' and 'OpenAI'. Give it a nice forwardable summary.
```
> Don't want to deal with code? [Try our no-code version](https://tally.so/r/np6dzB)
---
## 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](https://scrapecreators.com/)
### Steps
1. **Clone this repository**
```bash
git clone https://github.com/trypeggy/facebook-ads-library-mcp.git
cd facebook-ads-library-mcp
```
2. **Obtain an API token from Scrape Creators**
Sign up [here](https://scrapecreators.com/)
3. **Connect to the MCP server**
Copy the below json with the appropriate `{{PATH}}` values and `{{API KEY}}`:
```json
{
"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
```
**For Smithery:**
To install Facebook Ads Library for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@trypeggy/facebook-ads-library-mcp):
```bash
npx -y @smithery/cli install @trypeggy/facebook-ads-library-mcp --client claude
```
4. **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
1. Claude sends requests to the Python MCP server
2. The MCP server queries the ScrapeCreator API through tools
3. 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](https://modelcontextprotocol.io/quickstart/server#claude-for-desktop-integration-issues). The documentation includes helpful tips for checking logs and resolving common issues.
---
## Feedback
Your feedback will be massively appreciated. Please [tell us](mailto:feedback@usegala.com) which features on that list you like to see next or request entirely new ones.
---
## License
This project is licensed under the MIT License.
[](https://smithery.ai/server/@trypeggy/facebook-ads-library-mcp)
