[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_122":123},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":34,"_35":26,"_36":37,"_38":-5,"_39":-5,"_40":41,"_42":43,"_44":45,"_46":47,"_48":49,"_50":51,"_52":53,"_54":55,"_56":-5,"_57":49,"_58":59,"_60":61,"_62":63,"_64":65,"_66":67,"_68":69,"_70":71,"_72":73,"_74":75,"_76":77,"_78":79,"_80":-5,"_81":-5,"_82":-5,"_83":49,"_84":-5,"_85":59,"_86":87,"_88":89,"_90":91,"_92":93,"_94":95},"apiUrl","https://odel.app/api","creator","ad-vertly","moduleId","adextract-mcp-server","@ad-vertly/adextract-mcp-server","displayName","Adextract MCP","tagline","Search Meta, Google Ads, LinkedIn, and TikTok ad libraries plus creative analysis via MCP.","iconKey","https://avatars.githubusercontent.com/u/226980317?v=4","category","remote","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://mcp.adextract.co/mcp\",\"transport\":\"streamable-http\",\"authType\":\"bearer\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1785212862000,"updatedAt",1788777579000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=io.github.anuragind003%2Fad-extract","sourceVerified",false,"sourceMissingSince","importedAt","upstreamStars",0,"upstreamUpdatedAt",1788114141000,"detectedTransport","streamable-http","detectedAuthType","oauth","probeStatus","ok","lastProbedAt",1788065675000,"githubRepoUrl","https://github.com/ad-vertly/adextract-mcp-server","githubRepoFullName","ad-vertly/adextract-mcp-server","releaseId","ext-ad-vertly-adextract-mcp-server","version","1.0.0","descriptionMarkdown","# Adextract MCP Server\n\n[![MCP](https://img.shields.io/badge/MCP-Streamable%20HTTP-blue)](https://modelcontextprotocol.io/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n\n

\n $\"Adextract$ \n

\n\nAdextract is an MCP (Model Context Protocol) server that gives AI assistants ad intelligence. It searches the ad libraries of **Meta** (Facebook and Instagram), **Google Ads**, **LinkedIn**, and **TikTok**, and analyzes ad creatives with `ad_reader`.\n\n**Hosted endpoint:** `https://mcp.adextract.co/mcp`\n**Free tier:** 50 free searches. Get an API key at [adextract.co](https://adextract.co).\n\n> ⭐ If Adextract helps you, star this repo. It helps other AI developers find it.\n\n---\n\n## Watch the demo\n\n

\n $\"Adextract$ \n

\n\n*Also on [YouTube](https://youtu.be/GjhLeqV3zx8).*\n\n---\n\n## How it works\n\nOne MCP server, one API key, four ad libraries. Your AI assistant talks MCP — Adextract does the searching and analyzing.\n\n

\n $\"Adextract$ \n

\n\n---\n\n## Quickstart\n\n1. Get a free API key at [adextract.co](https://adextract.co) (account → API keys).\n2. Add the server to Cursor with the config below.\n3. Ask your AI: *\"Show me Nike's active Facebook ads in the US\"*.\n\nThere is nothing to install locally. Adextract runs as a hosted MCP server, so it works in any MCP-capable client.\n\n---\n\n## Use cases\n\n- **Competitor ad intelligence** - see what your competitors are running across Meta, Google, LinkedIn, and TikTok.\n- **Creative analysis** - `ad_reader` breaks any ad creative into format, audience, emotion, and archetypes.\n- **Brand monitoring** - track ads for any brand or domain across four ad libraries.\n- **Channel strategy** - built-in MCP prompts turn ad data into channel plans.\n\n---\n\n## Installation\n\n### Hosted MCP (recommended)\n\nConnect to the Adextract hosted server:\n\n```\nhttps://mcp.adextract.co/mcp\n```\n\nGet your API key at [adextract.co](https://adextract.co) (account → API keys).\n\n### Cursor\n\nAdd to `~/.cursor/mcp.json` or project `.cursor/mcp.json`:\n\n```json\n{\n \"mcpServers\": {\n \"ad-extract\": {\n \"url\": \"https://mcp.adextract.co/mcp\",\n \"headers\": {\n \"Authorization\": \"Bearer YOUR_API_KEY\"\n }\n }\n }\n}\n```\n\n### VS Code\n\nAdd to `.vscode/mcp.json`:\n\n```json\n{\n \"servers\": {\n \"ad-extract\": {\n \"type\": \"http\",\n \"url\": \"https://mcp.adextract.co/mcp\",\n \"headers\": {\n \"Authorization\": \"Bearer YOUR_API_KEY\"\n }\n }\n }\n}\n```\n\n### Claude Web (OAuth)\n\n1. Open Claude → **Settings** → **Connectors** → **Add custom connector**\n2. Name: `ad-extract`\n3. URL: `https://mcp.adextract.co/mcp`\n4. Sign in and approve when prompted (no API key in the URL).\n\n### Claude Desktop (`mcp-remote`)\n\n```json\n{\n \"mcpServers\": {\n \"ad-extract\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"mcp-remote\",\n \"https://mcp.adextract.co/mcp\",\n \"--header\",\n \"Authorization: Bearer ***\"\n ]\n }\n }\n}\n```\n\nMore clients and config paths: [docs/CLIENT_SETUP.md](https://github.com/ad-vertly/adextract-mcp-server/blob/main/docs/CLIENT_SETUP.md)\n\n---\n\n## Available Tools\n\n| Tool | Platform | Description |\n|------|----------|-------------|\n| `search_meta_ads` | Meta | Search Facebook & Instagram ads |\n| `search_meta_pages` | Meta | Discover pages and location IDs |\n| `get_meta_page_info` | Meta | Page transparency and metadata |\n| `get_meta_ad_details` | Meta | EU/UK ad transparency details |\n| `search_google_ads` | Google | Google Ads Transparency Center |\n| `search_google_ads_advertisers` | Google | Advertiser and domain search |\n| `get_google_ad_details` | Google | Creative details |\n| `get_google_ads_advertiser_info` | Google | Advertiser profile from Search ads |\n| `search_linkedin_ads` | LinkedIn | LinkedIn Ad Library |\n| `search_tiktok_ads` | TikTok | TikTok Ads Library |\n| `search_tiktok_advertisers` | TikTok | TikTok advertiser discovery |\n| `get_tiktok_ad_details` | TikTok | Targeting and creative details |\n| `ad_reader` | All | Analyze image/video creatives (format, audience, emotion, archetypes) |\n\nFull reference: [docs/TOOLS.md](https://github.com/ad-vertly/adextract-mcp-server/blob/main/docs/TOOLS.md)\n\n---\n\n## Prompts & Resources\n\nBuilt-in MCP prompts for common workflows:\n\n- `adextract_top_ads_for_brand`\n- `adextract_competitor_benchmark`\n- `adextract_channel_strategy`\n- `adextract_analyze_ad_url`\n- `adextract_schedule_watchlist`\n\nResources include agent skill instructions and prompt-pack references (`adextract://skill/main`, etc.).\n\n---\n\n## Authentication\n\n| Method | Best for |\n|--------|----------|\n| **OAuth 2.0** | Claude Web and OAuth-capable connectors |\n| **Bearer API key** | Cursor, VS Code, Claude Desktop, `mcp-remote` |\n\nDiscovery endpoints:\n\n- `https://mcp.adextract.co/.well-known/oauth-protected-resource`\n- `https://mcp.adextract.co/.well-known/oauth-authorization-server/oauth`\n\nServer card (registry / client discovery):\n\n- `https://mcp.adextract.co/.well-known/mcp.json`\n\n---\n\n## Example prompts\n\n```\nShow me the latest Nike ads on Facebook in the US.\n→ search_meta_ads({ q: \"nike\", country: \"US\", active_status: \"active\" })\n\nFind Google ads for tesla.com from the last 30 days.\n→ search_google_ads({ domain: \"tesla.com\", time_period: \"last_30_days\" })\n\nAnalyze this ad creative URL with ad_reader.\n→ ad_reader({ url: \"https://...\" })\n```\n\n---\n\n## FAQ\n\n### What is Adextract?\n\nAdextract is a hosted MCP server that lets AI assistants search the public ad libraries of Meta, Google Ads, LinkedIn, and TikTok, and analyze ad creatives. It works with Claude, Cursor, VS Code, and any MCP-capable client.\n\n### Which ad libraries does it cover?\n\nMeta Ad Library (Facebook and Instagram), Google Ads Transparency Center, LinkedIn Ad Library, and TikTok Ads Library.\n\n### How do I get an API key?\n\nSign up at [adextract.co](https://adextract.co), then go to account → API keys. The key is shown once at creation.\n\n### Is there a free tier?\n\nYes. New accounts get 50 free searches. Paid plans are available at [adextract.co](https://adextract.co).\n\n### What does `ad_reader` do?\n\nIt analyzes any public image or video ad creative and returns structured JSON: format, target audience, emotion (Plutchik/VAD), archetypes, and industry/brand.\n\n### Do I need to run any code locally?\n\nNo. Adextract is a hosted server. You only add a config entry to your client.\n\n### Can I use OAuth instead of an API key?\n\nYes. Claude Web and other OAuth-capable connectors can sign in directly, with no API key in the URL. Other clients use a Bearer API key.\n\n### How is this different from querying the ad libraries directly?\n\nEach ad platform has its own library, API, and access rules. Adextract gives one MCP interface across all four, plus creative analysis, without writing platform-specific code.\n\n---\n\n## Documentation\n\n| Doc | Purpose |\n|-----|---------|\n| [docs/CLIENT_SETUP.md](https://github.com/ad-vertly/adextract-mcp-server/blob/main/docs/CLIENT_SETUP.md) | Per-client configuration |\n| [docs/TOOLS.md](https://github.com/ad-vertly/adextract-mcp-server/blob/main/docs/TOOLS.md) | Tools, prompts, resources |\n| [docs/TROUBLESHOOTING.md](https://github.com/ad-vertly/adextract-mcp-server/blob/main/docs/TROUBLESHOOTING.md) | Common errors and fixes |\n| [REGISTRY_CHECKLIST.md](https://github.com/ad-vertly/adextract-mcp-server/blob/main/REGISTRY_CHECKLIST.md) | Pre-submission checklist |\n| [SECURITY.md](https://github.com/ad-vertly/adextract-mcp-server/blob/main/SECURITY.md) | Security policy |\n| [SUPPORT.md](https://github.com/ad-vertly/adextract-mcp-server/blob/main/SUPPORT.md) | How to get help |\n\n---\n\n## Links\n\n- **Website:** [adextract.co](https://adextract.co)\n- **MCP endpoint:** `https://mcp.adextract.co/mcp`\n- **Repository:** [github.com/ad-vertly/adextract-mcp-server](https://github.com/ad-vertly/adextract-mcp-server)\n\n---\n\n## Community\n\n

\n $\"YouTube\"$ \n $\"Instagram\"$ \n $\"LinkedIn\"$ \n $\"X\"$ \n

\n\n

\n _{Follow us for ad intelligence tips, MCP updates, and what your competitors are running.}\n

\n\n---\n\n

\n $\"Adextract$ \n
\n _{Built with ❤️ by Adextract}\n

\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays","upstream",{"_107":108,"_109":110,"_111":112,"_113":114,"_115":116,"_117":118},"requiredSecrets",[],"tags",[98,99,100,101,102,103,104,105,106],"assets",[],"stats",{"_96":59,"_97":59},"ratingAvg","reviewCount","ad-intelligence","ad-library","ad-spy","ai-agents","competitive-intelligence","google-ads","linkedin-ads","meta-ads","tiktok-ads","topics",[98,99,100,101,102,103,104,119,120,105,121,106],"license","MIT","language","HTML","registryName","io.github.anuragind003/ad-extract","homepage","https://adextract.co","packages",[],"mcp","mcp-server","model-context-protocol","ENV",{"_124":125,"_126":127,"_128":129},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]