{"_id":"adwhispr-mcp-server","_rev":"4-814b192f04f37172f8f682128f6be620","name":"adwhispr-mcp-server","dist-tags":{"latest":"0.2.2"},"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","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"],"author":{"name":"AdWhispr"},"license":"MIT","_id":"adwhispr-mcp-server@0.2.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":"c80eaba61bffaa2c6d567f468eab909fcc51d60b","tarball":"https://registry.npmjs.org/adwhispr-mcp-server/-/adwhispr-mcp-server-0.2.0.tgz","fileCount":4,"integrity":"sha512-1uobNsNUofMOjwsze0L+UItbL1ADNZLlz3969D56lX3Edcxgn4sc/zsQK7XSr4cqziO9KV1RGWd6lbJZCDIBOw==","signatures":[{"sig":"MEQCIBLsGaOfivwEWdrL1MUkY0JEG5SxKqhV1wGheZFfJ940AiAz9vJZtEl0rwdwJdmpneuu4YFkzvFGHNg92ngXOSDyRw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":18277},"engines":{"node":">=18"},"gitHead":"bf333c9e5f141dbe9e79d24273aebaf288006e9e","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 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.","directories":{},"_nodeVersion":"22.18.0","dependencies":{"mcp-remote":"^0.1.38"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/adwhispr-mcp-server_0.2.0_1783696698386_0.29395446675766657","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"adwhispr-mcp-server","version":"0.2.1","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"],"author":{"name":"AdWhispr"},"license":"MIT","_id":"adwhispr-mcp-server@0.2.1","maintainers":[{"name":"basilnas","email":"hello@adwhispr.com"}],"homepage":"https://adwhispr.com","bugs":{"url":"https://github.com/adwhispr/mcp-server/issues"},"bin":{"adwhispr-mcp":"bin/cli.js"},"dist":{"shasum":"e4ad89a6ee3c78e8683b930ad62c9d17c2c25221","tarball":"https://registry.npmjs.org/adwhispr-mcp-server/-/adwhispr-mcp-server-0.2.1.tgz","fileCount":4,"integrity":"sha512-Y8HP8mGBO/zv1fiP2km71jHx0v2T6PPqEcrpABdeqk3kVtiFcF1eMwT949e4u9k3ktzCRHZrefzfNh7RHqshnA==","signatures":[{"sig":"MEUCIEIsdUw5NHCA3Np7jlO6c/J2OOhoKD/L9P6CnKIk5S2tAiEA3Gz5FijoQQJs413TxF3UNdd7LALYoK61gG96mzkaYFM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQC2UVuKsVpRHaxE1t2c05d1aOjvoZy3+FHMsEaw5bmb5wIgbTKO4C3mmjtaiZsyVdqdXFEbjYeoLAnnud92LAx7UBI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":18256},"engines":{"node":">=18"},"gitHead":"de6d75d2159fbac6b3c0de2584fefc490a7eb965","scripts":{"start":"node bin/cli.js serve"},"_npmUser":{"name":"basilnas","email":"hello@adwhispr.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 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. 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.2.1_1791272698627_0.4279238099771341","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"_id":"adwhispr-mcp-server@0.2.2","bin":{"adwhispr-mcp":"bin/cli.js"},"bugs":{"url":"https://github.com/adwhispr/mcp-server/issues"},"dist":{"shasum":"c5f3cbf89f2828c2b10b7499d07b9c473b5d1c5b","tarball":"https://registry.npmjs.org/adwhispr-mcp-server/-/adwhispr-mcp-server-0.2.2.tgz","fileCount":4,"integrity":"sha512-fwEmKJ+YX1inL0s6O2Ul1BVIHY0eQBFy61mDxfM0zPmDJeSXeLhFb1kobO4eEdK2MZm1dcXe9Y3kgXibBeN2nw==","signatures":[{"sig":"MEUCICXgEuBH1/2Xhxk7YlgaOxUuBz27XtqWKvcz/RqPohryAiEAkjVd7WnPcutW6VglMynRLAh0YbfngbtKx+bnMOuo/oY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIBwcDM14AYc/0B0QtUolsA4Efwdt1ssT4POHplH+pJvPAiBnypdzaRGWbp3IlTAz17Whh3LN5z+WUXLESXoJ79cqdw=="}],"unpackedSize":15840},"name":"adwhispr-mcp-server","author":{"name":"AdWhispr"},"engines":{"node":">=18"},"gitHead":"c3db05f02a1f1f43144a581edeba9b9720d633d8","license":"MIT","scripts":{"start":"node bin/cli.js serve"},"version":"0.2.2","_npmUser":{"name":"basilnas","email":"hello@adwhispr.com"},"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":{"url":"git+https://github.com/adwhispr/mcp-server.git","type":"git"},"_npmVersion":"10.9.3","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. One-command setup for Claude Desktop.","directories":{},"maintainers":[{"name":"basilnas","email":"hello@adwhispr.com"}],"_nodeVersion":"22.18.0","dependencies":{"mcp-remote":"^0.1.38"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/adwhispr-mcp-server_0.2.2_1791274577615_0.9400440781830031"}}},"time":{"created":"2026-06-02T12:05:17.025Z","modified":"2026-10-06T08:16:17.928Z","0.1.0":"2026-06-02T12:05:17.709Z","0.2.0":"2026-07-10T15:18:18.532Z","0.2.1":"2026-10-06T07:44:58.704Z","0.2.2":"2026-10-06T08:16:17.705Z"},"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":{"url":"git+https://github.com/adwhispr/mcp-server.git","type":"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. One-command setup for Claude Desktop.","maintainers":[{"name":"basilnas","email":"hello@adwhispr.com"}],"readme":"# adwhispr-mcp-server\n\n[![smithery badge](https://smithery.ai/badge/basil/adwhispr)](https://smithery.ai/servers/basil/adwhispr)\n\nSee who is running ads in your space, clone a winning ad for your brand, and launch it, all 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=/)**.\n\nThe whole loop happens in one conversation:\n\n1. **Research.** Find the brands advertising in your space right now and see their longest-running ads.\n2. **Clone.** Rebuild a winning ad for your own brand, as an image or a video.\n3. **Launch.** Put it live as a real campaign on Meta, Google, TikTok, X, or ChatGPT Ads, and manage it from the same chat.\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\nThis package is a thin, open-source bridge to the AdWhispr server at `https://adwhispr.com/api/mcp`. Sign-in happens in your browser the first time you use it.\n\n---\n\n## Install (Claude Desktop)\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 so you can sign in to AdWhispr. Done.\n\nThen try:\n\n> *\"Who is running ads in my space?\"*\n>\n> *\"Show me [competitor]'s longest-running ads.\"*\n>\n> *\"Clone a winning ad for my brand.\"*\n>\n> *\"Launch a new campaign from my creatives, paused until I OK it.\"*\n>\n> *\"Optimize my ad spend.\"*\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\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 apps\n\n- **Apps that sign in for you** (Claude.ai, ChatGPT, Cursor, Claude Code, Grok): skip this package and connect straight to `https://adwhispr.com/api/mcp`.\n- **Apps that run a local command:** point them at `npx -y adwhispr-mcp-server serve`.\n- **DeepSeek Harness:** use the plugin [`dsh-plugin-adwhispr`](https://www.npmjs.com/package/dsh-plugin-adwhispr).\n- **Pi:** use [`pi-adwhispr`](https://www.npmjs.com/package/pi-adwhispr).\n\nSetup guides for each app: [adwhispr.com/integrations](https://adwhispr.com/integrations).\n\n---\n\n## What you can do\n\n### Research competitors\n\n- Find the brands confirmed to be advertising in your space right now, ranked by how many ads they are running.\n- See any brand's ads with the hook, format, copy, how long each has been running, and the creative itself.\n- Search a brand's ads by idea, such as \"before and after\" or \"social proof\".\n- Compare brands side by side, or get a written brief on one brand's ad strategy.\n- Research TikTok ads and Google keywords, including the keywords a competitor's site shows up for.\n- Save your own brand and products once, so research and clones are tailored to you.\n\n### Make your own creative\n\n- Clone a competitor's winning image or video ad for your brand.\n- Turn an Instagram reel, a TikTok, or your own video into an ad.\n- Make a video ad from your own script or a plain-English idea.\n- Review and change the script before anything is made. Nothing renders until you approve it.\n\n### Launch and manage campaigns\n\n- Connect your own ad accounts: Meta, Google, TikTok, X, and ChatGPT Ads.\n- Launch campaigns from your creatives, including Google Search and Performance Max.\n- Check real performance from your connected accounts.\n- Change budgets, pause, and resume.\n\nCampaigns are created **paused by default**, so nothing spends until you say go. AdWhispr never makes up performance numbers. Competitor research reports only what can be verified, such as how long an ad has been running.\n\n---\n\n## Pricing\n\nFlat monthly plans. No per-call overage billing.\n\n| Plan | Price | Agent calls / month | Image clones / month | Video credits / month |\n| --- | --- | --- | --- | --- |\n| **Free** | $0 | 15 | 1 free clone | 0 |\n| **Pro** | $39/mo ($31/mo billed annually) | 150 | 10 | 15 |\n| **Plus** | $69/mo ($55/mo billed annually) | 1,000 | 25 | 25 |\n| **Agency** | $149/mo ($119/mo billed annually) | 3,000 | 50 | 40 |\n\nTracked brands are unlimited on every plan. Agency adds team seats.\n\nCurrent plans and limits: [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 runs `npx -y adwhispr-mcp-server serve`, which starts [`mcp-remote`](https://www.npmjs.com/package/mcp-remote) pointed at `https://adwhispr.com/api/mcp`. That connects Claude to the AdWhispr server and handles the browser sign-in. Your sign-in is kept on your own computer in `~/.mcp-auth`. Your ad data and account live on AdWhispr. This package stores nothing else.\n\nTo point at a different server for testing, set `ADWHISPR_MCP_URL`.\n\n---\n\n## Troubleshooting\n\n**AdWhispr does not appear in Claude after install.**\nFully quit Claude Desktop (closing the window is not enough) and reopen it. The config is only read on startup. Confirm the entry exists in `claude_desktop_config.json` (paths above). On macOS and Linux, make sure `npx` is on your `PATH`. If Claude cannot find it, set `command` to the full path from `which npx`.\n\n**The browser sign-in window never opens, or sign-in loops.**\nThe first request opens a browser so you can sign in. If it does not appear, check that your default browser can open and that no firewall is blocking `localhost`. Clearing the saved sign-in fixes most loops:\n\n```bash\nrm -rf ~/.mcp-auth\n```\n\nThen restart Claude Desktop and ask it something again.\n\n**\"Authentication required\", or requests return a sign-in error.**\nYour AdWhispr sign-in expired or was not completed. Clear `~/.mcp-auth` as above and sign in again, or sign in at [adwhispr.com](https://adwhispr.com) first and then retry.\n\n**You see an upgrade or out-of-quota message.**\nThat is expected once you reach your plan's monthly limit. The message includes a link. Open it to upgrade or buy more credits.\n\n**A brand is not found.**\nUse the brand name exactly as it appears on its Facebook page. After a brand is added, its ads take a minute or two to load before you can ask about them.\n\n**A launch says no ad account is connected.**\nAsk the chat to connect your ad account. It gives you a link to connect Meta, Google, TikTok, X, or ChatGPT Ads. Campaigns are created paused, so nothing spends until you confirm.\n\n**Node or `npx` errors on start.**\nUse Node 18 or later (`node --version`). If an old cached copy is misbehaving, force a fresh one: `npx -y adwhispr-mcp-server@latest serve`.\n\nStill stuck? Open an issue at [github.com/adwhispr/mcp-server/issues](https://github.com/adwhispr/mcp-server/issues) or email hello@adwhispr.com.\n\n## Links\n\n- Website: https://adwhispr.com/connect?ref=mcp_directory\n- Setup guides for every app: https://adwhispr.com/integrations\n- Claude plugin: https://github.com/adwhispr/claude-plugin\n- Blog and guides: https://adwhispr.com/blog\n- Issues: https://github.com/adwhispr/mcp-server/issues\n\n## License\n\nMIT © AdWhispr\n","readmeFilename":"README.md"}