{"_id":"adwhispr-mcp-server","_rev":"2-9bc4d5f76736bfe0f8543e3cb17b6c7f","name":"adwhispr-mcp-server","dist-tags":{"latest":"0.2.0"},"versions":{"0.1.0":{"name":"adwhispr-mcp-server","version":"0.1.0","keywords":["mcp","model-context-protocol","claude","claude-desktop","anthropic","adwhispr","meta-ads","facebook-ads","ad-library","ad-spy","competitor-research","ad-intelligence","marketing"],"author":{"name":"AdWhispr"},"license":"MIT","_id":"adwhispr-mcp-server@0.1.0","maintainers":[{"name":"basilnas","email":"bnaserel1@gmail.com"}],"homepage":"https://adwhispr.com","bugs":{"url":"https://github.com/adwhispr/mcp-server/issues"},"bin":{"adwhispr-mcp":"bin/cli.js"},"dist":{"shasum":"530fb8f83a5caa6e6ba0f704d64631379a09db67","tarball":"https://registry.npmjs.org/adwhispr-mcp-server/-/adwhispr-mcp-server-0.1.0.tgz","fileCount":4,"integrity":"sha512-eXng+VLjcVWwqSvEqcKbFUIqA9kGKpIx378EGA8vsWq9N3Avf6YzGal0itmA/hJieePGvKAx0lgduD14aN//8g==","signatures":[{"sig":"MEUCIDsMUcTGBIHtcGgAstzuSadSRIvH9NSpkGIRLlL/E6znAiEAx2TnZjG5fW/rcDyF2KEpdmq8xIq/bmjuRjIJ8gOeoD8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":11716},"engines":{"node":">=18"},"gitHead":"050b663b66cc781d2a4d7474d6fd9d5fa713ad56","scripts":{"start":"node bin/cli.js serve"},"_npmUser":{"name":"basilnas","email":"bnaserel1@gmail.com"},"repository":{"url":"git+https://github.com/adwhispr/mcp-server.git","type":"git"},"_npmVersion":"10.9.3","description":"Connect Claude to AdWhispr — research any brand's Meta ads, find their longest-running winners, and clone the creative. One-command setup for Claude Desktop.","directories":{},"_nodeVersion":"22.18.0","dependencies":{"mcp-remote":"^0.1.38"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/adwhispr-mcp-server_0.1.0_1780401917551_0.3137641961819233","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"adwhispr-mcp-server","version":"0.2.0","description":"Connect Claude to AdWhispr — research any brand's ads (Meta + TikTok), surface their longest-running winners, clone the creative as an image or video for your brand, and launch it on Google, TikTok, or Meta. 38 tools, one-command setup for Claude Desktop.","bin":{"adwhispr-mcp":"bin/cli.js"},"scripts":{"start":"node bin/cli.js serve"},"keywords":["mcp","model-context-protocol","claude","claude-desktop","anthropic","adwhispr","meta-ads","facebook-ads","ad-library","ad-spy","competitor-research","ad-intelligence","marketing","tiktok-ads","google-ads","performance-max","campaign-launch","ad-cloning","ppc"],"homepage":"https://adwhispr.com","bugs":{"url":"https://github.com/adwhispr/mcp-server/issues"},"repository":{"type":"git","url":"git+https://github.com/adwhispr/mcp-server.git"},"author":{"name":"AdWhispr"},"license":"MIT","engines":{"node":">=18"},"dependencies":{"mcp-remote":"^0.1.38"},"_id":"adwhispr-mcp-server@0.2.0","gitHead":"bf333c9e5f141dbe9e79d24273aebaf288006e9e","_nodeVersion":"22.18.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-1uobNsNUofMOjwsze0L+UItbL1ADNZLlz3969D56lX3Edcxgn4sc/zsQK7XSr4cqziO9KV1RGWd6lbJZCDIBOw==","shasum":"c80eaba61bffaa2c6d567f468eab909fcc51d60b","tarball":"https://registry.npmjs.org/adwhispr-mcp-server/-/adwhispr-mcp-server-0.2.0.tgz","fileCount":4,"unpackedSize":18277,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIBLsGaOfivwEWdrL1MUkY0JEG5SxKqhV1wGheZFfJ940AiAz9vJZtEl0rwdwJdmpneuu4YFkzvFGHNg92ngXOSDyRw=="}]},"_npmUser":{"name":"basilnas","email":"bnaserel1@gmail.com"},"directories":{},"maintainers":[{"name":"basilnas","email":"bnaserel1@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/adwhispr-mcp-server_0.2.0_1783696698386_0.29395446675766657"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-02T12:05:17.025Z","modified":"2026-07-10T15:18:18.648Z","0.1.0":"2026-06-02T12:05:17.709Z","0.2.0":"2026-07-10T15:18:18.532Z"},"bugs":{"url":"https://github.com/adwhispr/mcp-server/issues"},"author":{"name":"AdWhispr"},"license":"MIT","homepage":"https://adwhispr.com","keywords":["mcp","model-context-protocol","claude","claude-desktop","anthropic","adwhispr","meta-ads","facebook-ads","ad-library","ad-spy","competitor-research","ad-intelligence","marketing","tiktok-ads","google-ads","performance-max","campaign-launch","ad-cloning","ppc"],"repository":{"type":"git","url":"git+https://github.com/adwhispr/mcp-server.git"},"description":"Connect Claude to AdWhispr — research any brand's ads (Meta + TikTok), surface their longest-running winners, clone the creative as an image or video for your brand, and launch it on Google, TikTok, or Meta. 38 tools, one-command setup for Claude Desktop.","maintainers":[{"name":"basilnas","email":"bnaserel1@gmail.com"}],"readme":"# adwhispr-mcp-server\n\n[![smithery badge](https://smithery.ai/badge/basil/adwhispr)](https://smithery.ai/servers/basil/adwhispr)\n\nResearch any brand's ads, clone the winners, and launch them — from a chat. This connects [Claude](https://claude.ai) (or any MCP client) to **[AdWhispr](https://adwhispr.com/connect?ref=mcp_readme&utm_source=mcp_readme&utm_medium=readme&to=/)** — the full loop in one conversation:\n\n1. **Research** a competitor's ad library (Meta + TikTok) and surface their longest-running, proven winners\n2. **Clone** the winning creative — image or video — for your own brand\n3. **Launch** it as a real campaign: Google Search and Performance Max (GA), TikTok (GA), Meta (beta)\n\n> *\"Find the longest-running ad from my biggest competitor, clone it for my brand, and launch it on TikTok with a $50/day budget.\"*\n\nIt'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.\n\n---\n\n## Install (Claude Desktop) — 3 steps\n\n```bash\nnpx adwhispr-mcp-server config\n```\n\n1. Run the command above. It adds AdWhispr to your Claude Desktop config.\n2. **Fully quit and reopen Claude Desktop.**\n3. Start a chat — a browser window opens once to sign in to AdWhispr. Done.\n\nThen try:\n\n> *\"Search AdWhispr for Nike's longest-running ads.\"*\n> *\"What hooks is Hims using in their Meta ads?\"*\n> *\"Clone Cal AI's top ad for my brand at example.com.\"*\n> *\"Launch that clone on Google as a Search campaign, $30/day, paused.\"*\n\n### Manual setup\n\nPrefer to edit the config yourself? Add this to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"adwhispr\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"adwhispr-mcp-server\", \"serve\"]\n    }\n  }\n}\n```\n\nConfig file location:\n- **macOS** `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows** `%APPDATA%\\Claude\\claude_desktop_config.json`\n- **Linux** `~/.config/Claude/claude_desktop_config.json`\n\n### Other MCP clients\n\nAny 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).\n\n---\n\n## Tools (38)\n\n### Research — competitor intelligence\n\n| Tool | What it does |\n|------|--------------|\n| `find_competitors` | Find brands **verified to be actively advertising right now** in your niche, ranked by live ad count — no guessing. |\n| `search_brands` | Find brands tracked in AdWhispr by name (returns ad counts + IDs). |\n| `add_brand` | Start tracking a new competitor brand (kicks off ad-library ingestion). |\n| `get_brand_ads` | A brand's ads with hooks, formats, days-running, and creative links. |\n| `get_brand_stats` | Aggregated stats: ad counts, hook/format distributions, spend ranges. |\n| `search_ads` | Semantic search across a brand's ads by concept (\"before/after\", \"social proof\"). |\n| `compare_brands` | Compare 2–3 brands side by side. |\n| `generate_brief` | Competitive brief for a brand: longevity curve, top hooks, format mix, verdict. |\n| `research_tiktok_ads` | Research a competitor's TikTok ads (video, thumbnails, run dates). |\n| `research_keywords` | Google keyword intelligence: volume, competition, CPC ranges. |\n| `research_competitor_keywords` | The keywords a competitor's domain ranks and bids on. |\n| `get_my_brand` / `save_my_brand` / `clear_my_brand` | Remember your own product/brand so research and clones are personalized. |\n| `add_product` / `list_my_products` / `remove_product` | Your product catalog — powers per-product ads (Shopify import supported). |\n\n### Creative — clone the winners as image *or* video\n\n| Tool | What it does |\n|------|--------------|\n| `clone_ad` | Clone a competitor's winning Meta ad for your brand — a real generated image for image ads, a video for video ads. |\n| `clone_tiktok_ad` | Same, for a TikTok ad. |\n| `clone_video_ad` | Full video-ad clone with selectable model tiers (Seedance / Veo / Kling) — cheap drafts to premium finals. |\n| `clone_from_script` | Generate a video ad from your own script. |\n| `clone_from_concept` | Generate a video ad from a plain-English concept or brief. |\n| `revise_video_brief` | Tweak the shot list / brief before anything renders. |\n| `approve_video_clone` | Approve the brief to kick off the render (the confirm step — nothing generates until you do). |\n| `check_video_status` | Poll a video render and get the finished file. |\n| `list_my_creatives` | Your generated creatives, ready to launch. |\n\n### Launch & manage — real campaigns\n\n| Tool | What it does |\n|------|--------------|\n| `connect_ad_account` | OAuth-connect your Google, TikTok, or Meta ad account. |\n| `list_ad_accounts` / `list_campaigns` | See what's connected and what's running. |\n| `launch_search_campaign` | Launch a Google Search campaign (GA). |\n| `launch_pmax_campaign` | Launch a Google Performance Max campaign, assets auto-generated (GA). |\n| `launch_tiktok_campaign` | Launch a TikTok video campaign (GA). |\n| `launch_campaign` / `launch_cloned_ad` | Launch a cloned creative in one step (Meta execution is **beta**). |\n| `get_account_performance` | Real performance from your connected account. |\n| `update_budget` / `pause_campaign` / `resume_campaign` | Manage what's live. |\n\nCampaigns 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).\n\n---\n\n## Pricing\n\nFlat monthly plans with a generous call allowance — no per-call overage billing, ever.\n\n- **Free** — 15 agent calls/month, unlimited tracked brands, 1 free clone. No card.\n- **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.\n- **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.\n\nVideo generation spends video credits (draft tiers cost the least, premium finals the most); extra clone and credit packs are available if you run dry.\n\nFull limits + trial at [adwhispr.com/upgrade](https://adwhispr.com/connect?ref=mcp_readme&utm_source=mcp_readme&utm_medium=readme&to=/upgrade).\n\n---\n\n## How it works\n\nClaude Desktop launches `npx -y adwhispr-mcp-server serve`, which runs [`mcp-remote`](https://www.npmjs.com/package/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.\n\nTo point at a different server (self-hosting/testing), set `ADWHISPR_MCP_URL`.\n\n---\n\n## Troubleshooting\n\n**AdWhispr doesn't appear in Claude after install.**\nFully 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`.\n\n**The browser sign-in window never opens, or login loops.**\nThe 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:\n\n```bash\nrm -rf ~/.mcp-auth\n```\n\nThen restart Claude Desktop and trigger a tool call again.\n\n**\"Authentication required\" or tools return an auth error.**\nYour AdWhispr session expired or wasn't completed. Re-run the sign-in (clear `~/.mcp-auth` as above), or sign in directly at [adwhispr.com](https://adwhispr.com) first, then retry.\n\n**A tool returns an upgrade / out-of-quota / \"locked clone\" message.**\nThat'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.\n\n**`add_brand` says a brand isn't found, or `search_brands` returns nothing.**\n`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.\n\n**A launch tool says an ad account isn't connected.**\nRun `connect_ad_account` first — it returns an OAuth link to connect Google, TikTok, or Meta. Campaigns are created paused; nothing spends until you confirm.\n\n**Node / `npx` errors on launch.**\nUse Node 18+ (`node --version`). If an old cached package is misbehaving, force a fresh copy: `npx -y adwhispr-mcp-server@latest serve`.\n\n**Connecting a non-Claude-Desktop client.**\nPoint 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.\n\nStill stuck? Open an issue at [github.com/adwhispr/mcp-server/issues](https://github.com/adwhispr/mcp-server/issues) or email basil@adwhispr.com.\n\n## Links\n\n- Website: https://adwhispr.com/connect?ref=mcp_directory\n- Claude plugin: https://github.com/adwhispr/claude-plugin\n- Blog / guides: https://adwhispr.com/blog\n- Issues: https://github.com/adwhispr/mcp-server/issues\n\n## License\n\nMIT © AdWhispr\n","readmeFilename":"README.md"}