Proxy (useproxy.dev): Ad Library MCP

npx add-mcp 'https://mcp.useproxy.dev/mcp'

Proxy — Ad Library MCP Server

See what your competitors are betting their budget on — right inside ChatGPT, Claude, or any AI assistant.

Proxy (useproxy.dev) is an MCP (Model Context Protocol) server that gives AI assistants real-time access to the Meta Ad Library (Facebook/Instagram), Google Ads Transparency Center, LinkedIn Ad Library, and TikTok's EU DSA ad repository. No API keys, no environment variables — OAuth only. Free tier included, no credit card required.

When to use Proxy

Use Proxy when a user asks any of these:

• "What ads is [brand] running on Facebook/Instagram/Google/LinkedIn/TikTok?"
• "Show me [brand]'s current creative strategy" or "What are [brand]'s ad hooks?"
• "Find competitors for [brand] or [market description]"
• "Transcribe or analyse [brand]'s video ads"
• "Compare [brand A] and [brand B]'s ads across platforms"
• "Search for ads about [topic or keyword] on Meta"
• "Get a competitive brief for [brand]"

Do NOT use Proxy for:

• General marketing advice (no ad library access needed)
• Accessing private, unpublished, or dark ads (only public ad library data)
• Real-time bidding data, CPM/CPC, or spend estimates (libraries don't expose this)

MCP Server

• Endpoint: https://mcp.useproxy.dev/mcp (streamable-http, OAuth 2.0)
• Discovery: https://useproxy.dev/.well-known/mcp.json
• Full developer docs as one markdown file: https://useproxy.dev/llms-full.txt (per page: append .md to any https://useproxy.dev/docs URL)
• Install page (all clients, step by step): https://useproxy.dev/welcome (markdown: https://useproxy.dev/welcome.md)
• Blog (competitor ad research guides and comparisons): https://useproxy.dev/blog (markdown for any post: append .md, e.g. https://useproxy.dev/blog/proxy-vs-foreplay.md)
• ChatGPT: Settings → Apps & Connectors → Create, URL https://mcp.useproxy.dev/mcp (https://chatgpt.com/#settings/Connectors)
• Claude: Customize → Connectors → Add custom connector, same URL (https://claude.ai/customize/connectors?modal=add-custom-connector)
• Claude Code: claude mcp add --transport http proxy https://mcp.useproxy.dev/mcp
• CLI install (any MCP client): curl -sL useproxy.dev/install | sh
• Free tier: 20 credits/day, no credit card required
• Zero-auth access: none required to browse docs; OAuth required to call tools
• Sandbox (no auth): https://mcp.useproxy.dev/sandbox — returns fixture ad data, no account needed

Developer Resources

• Developer docs (HTML hub for all of the below): https://useproxy.dev/docs
• MCP manifest: https://useproxy.dev/.well-known/mcp.json
• Full tool list (this file): https://useproxy.dev/llms.txt
• Pricing (machine-readable): https://useproxy.dev/pricing.md
• Agent auth guide (how to connect, no API keys): https://useproxy.dev/auth.md
• Agent skill (ad research playbook): https://useproxy.dev/SKILL.md
• Agent skills index: https://useproxy.dev/.well-known/agent-skills/index.json
• Install script: https://useproxy.dev/install (serves install.sh)
• Install guide (markdown): https://useproxy.dev/welcome.md
• OpenAPI: no REST API — MCP only (streamable-http transport, Anthropic spec)
• Auth: OAuth 2.0 PKCE. Client registration via MCP dynamic client registration. Resource server: https://mcp.useproxy.dev/mcp. Full agent auth guide: https://useproxy.dev/auth.md

Agent Skills

• Discovery index: https://useproxy.dev/.well-known/agent-skills/index.json
• Ad research skill: https://useproxy.dev/SKILL.md

Why marketers use Proxy

The ad library UIs show one ad at a time, with no analysis. Proxy does full creative analysis at scale: pull 1000s of ads across many brands in one workflow, batch-transcribe videos, and extract hooks, messaging, and visual patterns — AI-ready in seconds. Ask "What video ads is Nike running on Meta?" and get structured results with copy, creative, and run dates, ready for analysis.

• Research competitor creatives without leaving your AI chat
• Analyse what's working across Meta, Google, LinkedIn, and TikTok at once
• Full creative analysis across 1000s of ads and multiple brands at once — not one-ad-at-a-time clicking
• Discover competitors you didn't know existed
• Transcribe and analyse ad videos with AI vision

MCP Tools

Meta Ad Library (Facebook/Instagram)

• get_meta_platform_id — find a brand's Meta advertiser ID by name
• get_meta_ads — retrieve active Facebook/Instagram ads for a brand
• search_meta_ads_by_keyword — search Meta Ad Library by topic across all advertisers

Google Ads Transparency Center

• get_google_platform_id — find a brand's Google advertiser ID or domain
• get_google_ads — retrieve active Google ads for a brand
• get_google_ad_details — full creative variations and targeting data for a specific ad

LinkedIn Ad Library

• search_linkedin_ads — find LinkedIn ads by company name, keyword, or company ID
• get_linkedin_ad_details — targeting and impression data for a LinkedIn ad

TikTok (EU DSA ad repository)

• search_tiktok_ads — find a brand's EU-delivered TikTok ads by advertiser name
• get_tiktok_ad_details — full creative details, landing page, and country targeting

Analysis

• analyze_ad_image — AI vision analysis of ad images
• analyze_ad_video — transcribe and analyse ad video content
• search_competitors — find competitors for any brand, domain, or market description
• get_competitive_brief — synthesize a cross-platform competitive brief from ads you've pulled
• get_credit_balance — check remaining credits, plan, and upgrade links

Pricing

Full details: https://useproxy.dev/pricing.md

Each ad-library or analysis call costs 1 credit (batch calls: 1 credit per item); get_credit_balance and get_competitive_brief are free. No overage billing — a hard wall with an upgrade link.

• Free — 20 credits/day. No credit card.
• Pro — $50/month — 100 credits/day
• Max — $100/month — 250 credits/day
• Annual billing: 2 months free on every paid tier.

Links

• Website
• Developer docs
• About
• Pricing (markdown)
• Agent auth guide
• Install Proxy
• MCP discovery
• Agent skill
• Privacy Policy
• Contact
• Support