AdWhispr
Converse com os anúncios do Meta (Facebook/Instagram) de qualquer marca dentro do Claude — pesquise a biblioteca de anúncios de um concorrente, descubra seus anúncios de maior duração, extraia ganchos/formatos e clone anúncios vencedores para sua própria marca.
Documentação
adwhispr-mcp-server
Research any brand's ads, clone the winners, and launch them — from a chat. This connects Claude (or any MCP client) to AdWhispr — the full loop in one conversation:
- Research a competitor's ad library (Meta + TikTok) and surface their longest-running, proven winners
- Clone the winning creative — image or video — for your own brand
- Launch it as a real campaign: Google Search and Performance Max (GA), TikTok (GA), Meta (beta)
"Find the longest-running ad from my biggest competitor, clone it for my brand, and launch it on TikTok with a $50/day budget."
It's a thin, open-source bridge to the AdWhispr remote MCP server (https://adwhispr.com/api/mcp). Sign-in happens automatically through your browser the first time.
Install (Claude Desktop) — 3 steps
npx adwhispr-mcp-server config
- Run the command above. It adds AdWhispr to your Claude Desktop config.
- Fully quit and reopen Claude Desktop.
- Start a chat — a browser window opens once to sign in to AdWhispr. Done.
Then try:
"Search AdWhispr for Nike's longest-running ads." "What hooks is Hims using in their Meta ads?" "Clone Cal AI's top ad for my brand at example.com." "Launch that clone on Google as a Search campaign, $30/day, paused."
Manual setup
Prefer to edit the config yourself? Add this to claude_desktop_config.json:
{
"mcpServers": {
"adwhispr": {
"command": "npx",
"args": ["-y", "adwhispr-mcp-server", "serve"]
}
}
}
Config file location:
- macOS
~/Library/Application Support/Claude/claude_desktop_config.json - Windows
%APPDATA%\Claude\claude_desktop_config.json - Linux
~/.config/Claude/claude_desktop_config.json
Other MCP clients
Any MCP client that runs a stdio command works — point it at npx -y adwhispr-mcp-server serve, or connect directly to the remote endpoint https://adwhispr.com/api/mcp if your client supports remote MCP servers with OAuth (Claude.ai, ChatGPT developer mode, Cursor, Claude Code).
Tools (38)
Research — competitor intelligence
| Tool | What it does |
|---|---|
find_competitors | Find brands verified to be actively advertising right now in your niche, ranked by live ad count — no guessing. |
search_brands | Find brands tracked in AdWhispr by name (returns ad counts + IDs). |
add_brand | Start tracking a new competitor brand (kicks off ad-library ingestion). |
get_brand_ads | A brand's ads with hooks, formats, days-running, and creative links. |
get_brand_stats | Aggregated stats: ad counts, hook/format distributions, spend ranges. |
search_ads | Semantic search across a brand's ads by concept ("before/after", "social proof"). |
compare_brands | Compare 2–3 brands side by side. |
generate_brief | Competitive brief for a brand: longevity curve, top hooks, format mix, verdict. |
research_tiktok_ads | Research a competitor's TikTok ads (video, thumbnails, run dates). |
research_keywords | Google keyword intelligence: volume, competition, CPC ranges. |
research_competitor_keywords | The keywords a competitor's domain ranks and bids on. |
get_my_brand / save_my_brand / clear_my_brand | Remember your own product/brand so research and clones are personalized. |
add_product / list_my_products / remove_product | Your product catalog — powers per-product ads (Shopify import supported). |
Creative — clone the winners as image or video
| Tool | What it does |
|---|---|
clone_ad | Clone a competitor's winning Meta ad for your brand — a real generated image for image ads, a video for video ads. |
clone_tiktok_ad | Same, for a TikTok ad. |
clone_video_ad | Full video-ad clone with selectable model tiers (Seedance / Veo / Kling) — cheap drafts to premium finals. |
clone_from_script | Generate a video ad from your own script. |
clone_from_concept | Generate a video ad from a plain-English concept or brief. |
revise_video_brief | Tweak the shot list / brief before anything renders. |
approve_video_clone | Approve the brief to kick off the render (the confirm step — nothing generates until you do). |
check_video_status | Poll a video render and get the finished file. |
list_my_creatives | Your generated creatives, ready to launch. |
Launch & manage — real campaigns
| Tool | What it does |
|---|---|
connect_ad_account | OAuth-connect your Google, TikTok, or Meta ad account. |
list_ad_accounts / list_campaigns | See what's connected and what's running. |
launch_search_campaign | Launch a Google Search campaign (GA). |
launch_pmax_campaign | Launch a Google Performance Max campaign, assets auto-generated (GA). |
launch_tiktok_campaign | Launch a TikTok video campaign (GA). |
launch_campaign / launch_cloned_ad | Launch a cloned creative in one step (Meta execution is beta). |
get_account_performance | Real performance from your connected account. |
update_budget / pause_campaign / resume_campaign | Manage what's live. |
Campaigns are created paused by default with an explicit confirm step before anything spends — and video renders wait on approve_video_clone, so no credits burn until you say go. AdWhispr never fabricates performance metrics — competitor research reports only signals that can be verified (days-running, not made-up ROAS).
Pricing
Flat monthly plans with a generous call allowance — no per-call overage billing, ever.
- Free — 15 agent calls/month, unlimited tracked brands, 1 free clone. No card.
- Pro — $39/mo ($31/mo billed annually): 150 agent calls/month, 10 image clones + 10 video credits/month, launch on Google, TikTok & Meta, ad-script generation, competitor playbook, weekly new-ad alerts.
- Agency — $149/mo ($119/mo billed annually): 3,000 agent calls/month, 50 image clones + 40 video credits/month, team seats, cross-brand comparison, client-ready reports.
Video generation spends video credits (draft tiers cost the least, premium finals the most); extra clone and credit packs are available if you run dry.
Full limits + trial at adwhispr.com/upgrade.
How it works
Claude Desktop launches npx -y adwhispr-mcp-server serve, which runs mcp-remote pointed at https://adwhispr.com/api/mcp. That bridges Claude's local stdio transport to the AdWhispr server over HTTP and handles the OAuth login. Your ad data and account live on AdWhispr; this package stores nothing.
To point at a different server (self-hosting/testing), set ADWHISPR_MCP_URL.
Troubleshooting
AdWhispr doesn't appear in Claude after install.
Fully quit Claude Desktop (not just close the window) and reopen it — config is only read on startup. Confirm the entry exists in claude_desktop_config.json (paths above). On macOS/Linux make sure npx is on your PATH; if Claude can't find it, set the command to the absolute path from which npx.
The browser sign-in window never opens, or login loops.
The first tool call opens a browser to authorize via OAuth. If it doesn't appear, check that your default browser can open and that no firewall is blocking localhost callbacks. Clearing the stale auth cache fixes most loops:
rm -rf ~/.mcp-auth
Then restart Claude Desktop and trigger a tool call again.
"Authentication required" or tools return an auth error.
Your AdWhispr session expired or wasn't completed. Re-run the sign-in (clear ~/.mcp-auth as above), or sign in directly at adwhispr.com first, then retry.
A tool returns an upgrade / out-of-quota / "locked clone" message. That's expected on the Free tier (15 agent calls/month, 1 free clone, video credits are paid-plan only). The message includes an unlock link — open it to upgrade or buy a credit pack. Relay the link as-is; the clone is generated and waiting behind it.
add_brand says a brand isn't found, or search_brands returns nothing.
add_brand resolves brands from the public ad library by name — try the exact brand name as it appears on Facebook. After adding, ingestion runs in the background (~40s) before ads are queryable. search_brands only returns brands already tracked on your account.
A launch tool says an ad account isn't connected.
Run connect_ad_account first — it returns an OAuth link to connect Google, TikTok, or Meta. Campaigns are created paused; nothing spends until you confirm.
Node / npx errors on launch.
Use Node 18+ (node --version). If an old cached package is misbehaving, force a fresh copy: npx -y adwhispr-mcp-server@latest serve.
Connecting a non-Claude-Desktop client.
Point any stdio MCP client at npx -y adwhispr-mcp-server serve, or connect directly to the remote endpoint https://adwhispr.com/api/mcp if your client supports remote MCP servers with OAuth.
Still stuck? Open an issue at github.com/adwhispr/mcp-server/issues or email basil@adwhispr.com.
Links
- Website: https://adwhispr.com/connect?ref=mcp_directory
- Claude plugin: https://github.com/adwhispr/claude-plugin
- Blog / guides: https://adwhispr.com/blog
- Issues: https://github.com/adwhispr/mcp-server/issues
License
MIT © AdWhispr