How do I install the facebook ads library mcp server?

This profile does not contain a verified copy-paste launch configuration. Follow the current project documentation to confirm the runtime, entry point, transport and authentication before registering it in your client.

What credentials does it need?

It reads `SCRAPECREATORS_API_KEY`, `GEMINI_API_KEY` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Facebook Ads Library MCP Server

Get any answer from the Facebook Ads Library, conduct deep research including messaging, creative testing and comparisons in seconds.

Remote serverstreamable-httpPython

What is the Facebook Ads Library MCP Server?

Get any answer from the Facebook Ads Library, conduct deep research including messaging, creative testing and comparisons in seconds.

What you get

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

Configuration and credentials

Python 3.12+ - Anthropic Claude Desktop app (or Cursor) - Pip (Python package manager), install with python -m pip install - An API key for an ads data provider, set as SCRAPECREATORS_API_KEY (see configuration below) - A Google Gemini API key for video analysis (optional, only needed for video ads) > Prefer not to deal with API keys? See the Hosted Version

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
get_meta_platform_id	Returns platform ID given one or many brand names
get_meta_ads	Retrieves ads for specific page(s) (platform ID)
analyze_ad_image	Analyzes ad images for visual elements, text, colors, and composition
analyze_ad_video	Analyzes single ad video using Gemini AI for comprehensive insights
analyze_ad_videos_batch	NEW - Analyzes multiple videos in single API call for token efficiency
get_cache_stats	Gets statistics about cached media (images and videos) and storage usage
search_cached_media	Searches previously analyzed media by brand, colors, people, or media type
cleanup_media_cache	Cleans up old cached media files to free disk space

Configuration

Python 3.12+ - Anthropic Claude Desktop app (or Cursor) - Pip (Python package manager), install with python -m pip install - An API key for an ads data provider, set as SCRAPECREATORS_API_KEY (see configuration below) - A Google Gemini API key for video analysis (optional, only needed for video ads) > Prefer not to deal with API keys? See the Hosted Version

Variable	Description	Required
SCRAPECREATORS_API_KEY	Credential the server authenticates with.	Yes
GEMINI_API_KEY	Credential the server authenticates with.	Yes

Example prompts to try

“Use Facebook Ads Library to get meta platform id.”
“Use Facebook Ads Library to get meta ads.”
“Use Facebook Ads Library to analyze ad image.”

Frequently asked questions

Get any answer from the Facebook Ads Library, conduct deep research including messaging, creative testing and comparisons in seconds. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.