All plugins

adwhispr

Research competitor ads, clone the winners, and run campaigns through the hosted AdWhispr MCP. Finds brands verified to be advertising in a niche right now, their longest-running Meta and TikTok ads, Instagram content and Google keyword data; clones a proven ad into a finished image or AI video for your brand (free script approval before any credit is charged); and launches paused campaigns on Meta, Google, TikTok, X and ChatGPT Ads. Portable Agent Plugins v1 package with twenty-four workflow skills; OAuth uses pinned mcp-remote@0.1.49 over npx stdio, so Node.js 20.18.1+ and npm are required. Disclosure — creates and edits real ad campaigns that spend your ad budgets (always created paused, two-step confirm server-side) and renders videos that use paid credits; the AdWhispr server is marked untrusted, so Hermes asks before every write or spend tool and refuses them in cron and headless runs. Sends research queries and your brand assets to adwhispr.com; sign-in is OAuth through npx mcp-remote@0.1.49.

AdWhisprToolsv1.0.1Updated 1 month ago

About

Research competitor ads, clone the winners, and run campaigns through the hosted AdWhispr MCP. Finds brands verified to be advertising in a niche right now, their longest-running Meta and TikTok ads, Instagram content and Google keyword data; clones a proven ad into a finished image or AI video for your brand (free script approval before any credit is charged); and launches paused campaigns on Meta, Google, TikTok, X and ChatGPT Ads. Portable Agent Plugins v1 package with twenty-four workflow skills; OAuth uses pinned mcp-remote@0.1.49 over npx stdio, so Node.js 20.18.1+ and npm are required. Disclosure — creates and edits real ad campaigns that spend your ad budgets (always created paused, two-step confirm server-side) and renders videos that use paid credits; the AdWhispr server is marked untrusted, so Hermes asks before every write or spend tool and refuses them in cron and headless runs. Sends research queries and your brand assets to adwhispr.com; sign-in is OAuth through npx mcp-remote@0.1.49.

AdWhispr for Hermes Agent

Research what is working in any ad market, clone the winners for your own brand, and run the campaigns, all from Hermes Agent. This portable Agent Plugins v1 package connects Hermes to AdWhispr's hosted MCP server and bundles twenty-four workflow skills.

  • Research: find the brands verified to be advertising in your niche right now, their longest-running Meta and TikTok ads, their Instagram content and creator partnerships, and real Google Keyword Planner data in about 180 countries.
  • Cloning: turn a proven ad (a Meta ad, an Instagram reel, a TikTok, or your own video) into a finished image or a finished video with native AI voice, made for your brand and product. Every video script is shown for approval before any credit is charged.
  • Execution: launch and manage campaigns on Meta (Facebook and Instagram), Google (Search and Performance Max), TikTok, X, and ChatGPT Ads. Every campaign is created paused.

Install

After the plugin is accepted into the Hermes catalog:

hermes plugins install adwhispr --no-enable
hermes plugins enable adwhispr

Until then, install directly from this repository:

hermes plugins install adwhispr/adwhispr-hermes-plugin --no-enable
hermes plugins enable adwhispr

Start a new Hermes session or run /reload-mcp. The first connection opens a browser for the AdWhispr sign-in (a free account works, no card); finish it and return to Hermes. Connect ad accounts from chat when you need them: the agent sends you a link to each platform's own consent screen.

The plugin needs Node.js 20.18.1 or newer with npx on PATH. Hermes launches the exactly pinned mcp-remote@0.1.49 package as a local stdio-to-HTTP OAuth bridge; nothing is installed globally.

Try it

  • "Who has the best ads in my niche? My site is example.com."
  • "Show me Gymshark's longest-running ads and what angles they use."
  • "Clone their best video ad for my brand."
  • "Turn this TikTok into an ad for my product: https://www.tiktok.com/@brand/video/123"
  • "What's wasting money in my Google Ads account?"
  • "Launch a Google Search campaign on these keywords at $20 a day."
  • "Run my new video as a Meta ad against my two best images."

Load adwhispr-get-started for a first run, or adwhispr-agent for the safety contract and the map of which skill handles what. Hermes namespaces portable skills under the installed plugin; use skills_list to find the qualified names.

Safety contract

plugin.json marks the AdWhispr server untrusted for Hermes (extensions.com.nousresearch.hermes.servers.adwhispr.trust). Hermes therefore asks you before every AdWhispr tool that is not annotated read-only, and refuses those tools in cron and headless runs. The research and read tools carry MCP readOnlyHint: true on the server, so they run without a prompt.

AdWhispr manages advertising accounts that can spend real money and makes videos that cost credits. The bundled skills require the agent to:

  • create every campaign paused; nothing spends until the user resumes it;
  • use the two-step preview and confirm on every launch, budget, targeting, keyword, and resume call (the server issues a single-use confirm token);
  • render a video only after the user's latest message explicitly approves that script, quoting their words;
  • never ask for passwords, tokens, or API keys in chat (ad accounts connect through browser links);
  • never launch a competitor's media as the user's creative; clones keep the structure and make everything else new.

These rules are enforced by the AdWhispr server (paused creation, confirm tokens, the approval gate) and restated in the skills.

Included components

  • One stdio MCP entry backed by the hosted Streamable HTTP server at https://adwhispr.com/api/mcp
  • Twenty-four research, cloning, and campaign skills
  • OAuth 2.1 with PKCE and dynamic client registration
  • An exact mcp-remote@0.1.49 runtime pin; no bootstrap script, hook, native tool, or self-updater

Included skills

SkillPurpose
adwhispr-agentSafety contract and routing for every AdWhispr job: competitor ad research, ad cloning, and campaign execution on Meta, Google, TikTok, X and ChatGPT Ads
adwhispr-brand-vs-brandPut two brands' ad strategies side by side: ad volume, longevity, format mix, and the angles each leans on
adwhispr-budget-reallocationMove ad budget from losers to winners with evidence and explicit approval
adwhispr-campaign-reviewReview the user's own ad campaign performance and manage running campaigns
adwhispr-chatgpt-adsLaunch and manage ChatGPT ads (OpenAI Ads) from chat: chat-card ads with context-hint targeting inside ChatGPT
adwhispr-clone-image-adClone a competitor's winning image ad into a finished image for the user's brand, tweak it, and launch it as a paused Meta ad
adwhispr-clone-video-adClone a winning video ad into a finished, ready-to-launch video for the user's brand, from a Meta ad, an Instagram reel, a TikTok link, or the user's own video, with a free script approval before any credit is charged
adwhispr-clone-winning-adsTurn a competitor's proven ad into the user's own finished creative and get it live
adwhispr-competitor-keyword-spyFind the Google keywords associated with a competitor's site and where the gaps are
adwhispr-competitor-researchFind which brands in the user's niche are running ads RIGHT NOW and surface their proven winners
adwhispr-creative-fatigue-refreshSpot ad creatives that are wearing out and line up refreshed replacements
adwhispr-get-startedIntroduce AdWhispr and get a new user to their first result in two minutes
adwhispr-google-adsLaunch and manage Google Ads from chat: Search campaigns with real keyword data, Performance Max, call ads, budgets and performance
adwhispr-instagram-researchPull any public Instagram account's organic posts, paid partnerships and UGC creators, ranked by views, likes, comments or recency
adwhispr-keyword-universe-builderBuild a complete keyword universe for any product or topic with real Google Keyword Planner data in ~180 countries and 35 languages
adwhispr-longest-running-adsSurface the ads a brand or niche has kept running the longest \u2014 the closest honest signal to a proven winner
adwhispr-meta-adsLaunch and manage Meta (Facebook and Instagram) ads from chat: single images, carousels, videos, creative tests, retargeting, and radius targeting
adwhispr-new-ad-watchWatch a competitor for newly launched ads and what changed in their library
adwhispr-niche-ad-reportA full advertising report on any niche: who is verified to be running ads right now, how much, and what their proven winners look like
adwhispr-tiktok-adsLaunch and manage TikTok ads from chat, and clone proven TikTok ads into shoot-ready scripts
adwhispr-video-from-scriptMake a finished video ad from the user's own script, or write an original concept from what is winning in their niche and render it
adwhispr-wasted-spend-auditAudit the user's connected ad account for wasted spend: what is running, what is quietly burning budget, and the fixes ranked by dollars at stake
adwhispr-winning-angle-extractorExtract the angles and offers behind a brand's longest-running ads, categorized into reusable patterns
adwhispr-x-adsLaunch and manage X (Twitter) ads from chat: promoted posts, creative tests, keyword and interest targeting, conversions

Authentication

mcp.json stores no credentials. On first connection the pinned mcp-remote bridge discovers AdWhispr's OAuth metadata, opens the browser sign-in, completes the PKCE exchange, and stores the tokens locally in ~/.mcp-auth/mcp-remote-0.1.49/. To sign in again, remove only the AdWhispr entry from that directory and run /reload-mcp.

Why a bridge? Agent Plugins v1 has no portable field for OAuth on a remote MCP entry. Hermes supports OAuth in its native MCP configuration, but the portable plugin translator cannot carry that setting yet, so the pinned bridge keeps installation to one command.

Scheduled work

Hermes can run recurring jobs with its cronjob tool, for example a Monday campaign review (adwhispr-campaign-review) or a weekly look at what a competitor launched (adwhispr-new-ad-watch). Scheduled runs use AdWhispr calls like an interactive session; weekly is a sensible default.

Scheduled runs are read-only. The plugin marks the AdWhispr server untrusted (see below), so Hermes refuses every tool that can write or spend in a cron or headless run. A scheduled brief can report and recommend; launching, budget changes, resuming and video renders happen only in an interactive session where you approve them.

Development

Validate the package with the same admission command the Hermes catalog uses:

hermes plugins validate .

Support and security

Licensed under the MIT License.

README from the reviewed commit 80fd0e8; it updates when the author re-pins.

Developer Mode

Explore built-in Hermes toolsets and actions.

HermesAgent

Developer?

Create a Hermes extension for Desktop or agent workflows.

Developer Section