Adextract Mcp Server
About
Connect AI assistants to Adextract — search ad libraries across Meta, Google Ads, LinkedIn, and TikTok, plus creative analysis with adreader.
Details
- Author
- ad-vertly
- Downloads
- 250
- Categories
- Marketing, Other, Media
Jump to
- adextract_top_ads_for_brand
- adextract_competitor_benchmark
- adextract_channel_strategy
- adextract_analyze_ad_url
- adextract_schedule_watchlist
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Adextract Mcp ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
The README includes setup instructions such as "command": "npx",.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"adextract mcp server": {
"ad-extract": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.adextract.co/mcp",
"--header",
"Authorization: Bearer YOUR_API_KEY"
]
}
}
}
}McpServers
{
"ad-extract": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.adextract.co/mcp",
"--header",
"Authorization: Bearer YOUR_API_KEY"
]
}
}Adextract MCP Server
Connect AI assistants to Adextract — search ad libraries across Meta, Google Ads, LinkedIn, and TikTok, plus creative analysis with ad_reader.
Hosted endpoint: https://mcp.adextract.co/mcp
---
Installation
Hosted MCP (recommended)
Connect to the Adextract hosted server:
https://mcp.adextract.co/mcp
Get your API key at adextract.co (account → API keys).
Cursor
Add to ~/.cursor/mcp.json or project .cursor/mcp.json:
{
"mcpServers": {
"ad-extract": {
"url": "https://mcp.adextract.co/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
VS Code
Add to .vscode/mcp.json:
{
"servers": {
"ad-extract": {
"type": "http",
"url": "https://mcp.adextract.co/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Claude Web (OAuth)
1. Open Claude → Settings → Connectors → Add custom connector
2. Name: ad-extract
3. URL: https://mcp.adextract.co/mcp
4. Sign in and approve when prompted — no API key in the URL.
Claude Desktop (mcp-remote)
{
"mcpServers": {
"ad-extract": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.adextract.co/mcp",
"--header",
"Authorization: Bearer YOUR_API_KEY"
]
}
}
}
More clients and config paths: docs/CLIENT_SETUP.md
---
Available Tools
| Tool | Platform | Description |
|------|----------|-------------|
| search_meta_ads | Meta | Search Facebook & Instagram ads |
| search_meta_pages | Meta | Discover pages and location IDs |
| get_meta_page_info | Meta | Page transparency and metadata |
| get_meta_ad_details | Meta | EU/UK ad transparency details |
| search_google_ads | Google | Google Ads Transparency Center |
| search_google_ads_advertisers | Google | Advertiser and domain search |
| get_google_ad_details | Google | Creative details |
| get_google_ads_advertiser_info | Google | Advertiser profile from Search ads |
| search_linkedin_ads | LinkedIn | LinkedIn Ad Library |
| search_tiktok_ads | TikTok | TikTok Ads Library |
| search_tiktok_advertisers | TikTok | TikTok advertiser discovery |
| get_tiktok_ad_details | TikTok | Targeting and creative details |
| ad_reader | All | Analyze image/video creatives (format, audience, emotion, archetypes) |
Full reference: docs/TOOLS.md
---
Prompts & Resources
Built-in MCP prompts for common workflows:
- adextract_top_ads_for_brand
- adextract_competitor_benchmark
- adextract_channel_strategy
- adextract_analyze_ad_url
- adextract_schedule_watchlist
Resources include agent skill instructions and prompt-pack references (adextract://skill/main, etc.).
---
Authentication
| Method | Best for |
|--------|----------|
| OAuth 2.0 | Claude Web and OAuth-capable connectors |
| Bearer API key | Cursor, VS Code, Claude Desktop, mcp-remote |
Discovery endpoints:
- https://mcp.adextract.co/.well-known/oauth-protected-resource
- https://mcp.adextract.co/oauth/.well-known/oauth-authorization-server
Server card (registry / client discovery):
- https://mcp.adextract.co/.well-known/mcp.json
---
Example prompts
Show me the latest Nike ads on Facebook in the US.
→ search_meta_ads({ q: "nike", country: "US", active_status: "active" })
Find Google ads for tesla.com from the last 30 days.
→ search_google_ads({ domain: "tesla.com", time_period: "last_30_days" })
Analyze this ad creative URL with ad_reader.
→ ad_reader({ url: "https://..." })
---
Documentation
| Doc | Purpose |
|-----|---------|
| docs/CLIENT_SETUP.md | Per-client configuration |
| docs/TOOLS.md | Tools, prompts, resources |
| docs/TROUBLESHOOTING.md | Common errors and fixes |
| REGISTRY_CHECKLIST.md | Pre-submission checklist |
| SECURITY.md | Security policy |
| SUPPORT.md | How to get help |
---
Links
- Website: adextract.co
- MCP endpoint: https://mcp.adextract.co/mcp
- Repository: github.com/ad-vertly/adextract-mcp-server
Built with ❤️ by Adextract
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
