Allows searching and analyzing ads from Google's Ads Transparency Center, including analyzing ad images/text, video ads, comparing companies' advertising strategies, and getting insights into campaign effectiveness.
Used for comprehensive video ad analysis, providing insights into visual storytelling, pacing, and brand messaging techniques in video advertisements.
Google Ads Library MCP Server
This is a Model Context Protocol (MCP) server for the Google Ads Transparency Center.
With this you can search Google's public ads transparency center for any company or brand, see what they're currently running and analyze their advertising. You can analyze ad images/text, analyze video ads with comprehensive insights, 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 subscribe here
PS: Join our Twitter community for all things MCP
Example Prompts
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
A Google Gemini API key for video analysis (optional, only needed for video ads)
Quick Install (Recommended)
Clone and run the install script
git clone https://github.com/trypeggy/google-ads-library-mcp.git cd google-ads-library-mcp # For macOS/Linux: ./install.sh # For Windows: install.batConfigure your API keys
Edit the
.env
file that was created and add your API keys:Get your ScrapeCreators API key at scrapecreators.com
Get your Gemini API key at Google AI Studio (optional, for video analysis)
Follow the displayed MCP configuration
The install script will show you the exact configuration to add to Claude Desktop or Cursor.
Manual Install
If you prefer to install manually:
Clone this repository
git clone https://github.com/trypeggy/google-ads-library-mcp.git cd google-ads-library-mcpInstall dependencies
pip install -r requirements.txtConfigure API keys
Copy the template and configure your API keys:
cp .env.template .env # Then edit .env with your actual API keysTo obtain API keys:
Connect to the MCP server
Add the MCP server configuration to your Claude Desktop or Cursor config:
{ "mcpServers": { "google_ad_library": { "command": "/usr/local/opt/python@3.13/bin/python3", "args": [ "{{PATH_TO_PROJECT}}/google-ads-library-mcp/mcp_server.py" ] } } }Replace
{{PATH_TO_PROJECT}}
with the full path to where you cloned this repository.Note: API keys are automatically loaded from the
.env
file. Command line arguments are still supported and take priority over environment variables if provided.For Claude Desktop:
Save this as
claude_desktop_config.json
in your Claude Desktop configuration directory at:~/Library/Application Support/Claude/claude_desktop_config.jsonFor Cursor:
Save this as
mcp.json
in your Cursor configuration directory at:~/.cursor/mcp.jsonRestart Claude Desktop / Cursor
Open Claude Desktop and you should now see the Google Ads Library as an available integration.
Or restart Cursor.
Technical Details
Claude sends requests to the Python MCP server
The MCP server queries the ScrapeCreators API for Google Ads Transparency Center data
Data flows back through the chain to Claude
Google Ads
This server connects to Google's Ads Transparency Center:
Google Ads: Uses company domain (e.g., "nike.com") or advertiser ID for search
Response Format: Returns ads with format types (text/image/video) and detailed variations
Ad Details: Each ad can have multiple variations with different headlines and descriptions
Regional Data: Includes region-specific statistics and impression data
Tips:
Use company domains (e.g., "nike.com") instead of brand names for searching
Text ads are now supported in addition to image and video ads
Each ad may have multiple variations with different headlines and descriptions
Available MCP Tools
This MCP server provides tools for interacting with Google Ads Transparency Center objects:
Tool Name | Description |
| Retrieves currently running ads for a company from Google Ads Transparency Center (by domain or advertiser ID) |
| Gets detailed information about a specific Google ad, including all variations and regional stats |
| Downloads and analyzes ad images for visual elements, text, colors, and composition |
| Downloads and analyzes ad videos using Gemini AI for comprehensive video insights |
| Gets statistics about cached media (images and videos) and storage usage |
| Searches previously analyzed media by brand, colors, people, or media type |
| Cleans up old cached media files to free disk space |
Troubleshooting
Common Issues
API Key Not Found Error:
Ensure your
.env
file is in the project root directoryIf you don't have a
.env
file, copy it from the template:cp .env.template .env
Check that your API keys are correctly formatted without quotes
Verify the
.env
file containsSCRAPECREATORS_API_KEY=your_key_here
For video analysis, ensure
GEMINI_API_KEY=your_key_here
is also added
Video Analysis Not Working:
Confirm you have a valid Google Gemini API key in your
.env
fileVideo analysis requires the
GEMINI_API_KEY
environment variable
MCP Server Connection Issues:
Verify the path in your MCP configuration points to the correct location
Make sure you've installed all dependencies with
pip install -r requirements.txt
Restart Claude Desktop/Cursor after configuration changes
For additional Claude Desktop integration troubleshooting, see the MCP documentation. The documentation includes helpful tips for checking logs and resolving common issues.
Google Ads Specific Notes:
Use company domains (e.g., "nike.com") instead of brand names for searching
Text ads are now supported in addition to image and video ads
Each ad may have multiple variations with different headlines and descriptions
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
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
This MCP server searches Google's public ads database and uses AI to analyze ad images/videos, with intelligent caching for performance.
Related MCP Servers
- AsecurityFlicenseAqualityAn MCP (Model Context Protocol) server that provides Google search capabilities and webpage content analysis tools. This server enables AI models to perform Google searches and analyze webpage content programmatically.Last updated -11146
- -securityFlicense-qualityMCP server that enables AI assistants to perform SEO automation tasks including keyword research, SERP analysis, and competitor analysis through Google Ads API integration.Last updated -1
- -securityFlicense-qualityAn MCP server that provides access to Google's API Discovery Service, allowing agents to discover and interact with Google APIs through natural language commands.Last updated -
- -securityFlicense-qualityAn MCP server that enables interaction with Google's Display & Video 360 advertising platform API, allowing management of digital advertising campaigns through natural language commands.Last updated -