Skip to main content

adspirer

❖ Communityv1.0.0★ 1

Tools · by Adspirer · added

Create, analyze, and optimize campaigns across Google Ads, Meta Ads, TikTok Ads, LinkedIn Ads, Amazon Ads, ChatGPT Ads, and Microsoft Ads through the hosted Adspirer MCP. Portable Agent Plugins v1 package with fourteen paid-media workflow skills and approval safeguards; OAuth uses pinned mcp-remote@0.1.49 over npx stdio, so Node.js 20.18.1+ and npm are required.

Open in Hermes Desktop
hermes plugins install adspirer
Repository ↗Reviewed source @ 4688c38 ↗Documentation ↗

README

From the reviewed commit 4688c38 ↗; it updates when the author re-pins.

Adspirer for Hermes Agent

Create, analyze, and optimize paid-media campaigns from Hermes Agent. This portable Agent Plugins v1 package connects Hermes to Adspirer's hosted MCP service and includes workflow skills for Google Ads, Meta Ads, TikTok Ads, LinkedIn Ads, Amazon Ads, and ChatGPT Ads.

Install

After the plugin is accepted into the Hermes catalog:

hermes plugins install adspirer --no-enable
hermes plugins enable adspirer

Until then, install directly from the official Adspirer repository:

hermes plugins install Adspirer/adspirer-hermes-plugin --no-enable
hermes plugins enable adspirer

Start a new Hermes session or run /reload-mcp. The first connection opens a browser for Adspirer sign-in; complete the authorization and return to Hermes. Connect or reconnect advertising accounts at adspirer.ai/connections.

The plugin requires Node.js 20.18.1 or newer with npx available on PATH. Hermes launches the exactly pinned mcp-remote@0.1.49 package as a local stdio-to-HTTP OAuth bridge; no global npm installation is required.

Try it

Open a brand or project directory and ask Hermes:

  • "Set up this folder as my Adspirer brand workspace."
  • "Review the last 30 days across every connected ad platform."
  • "Find wasted spend and show me the changes you recommend."
  • "Create a Google Search campaign for this landing page with a $50 daily budget."
  • "Write three Meta ad variants in the brand voice from BRAND.md."

For first-time setup, load the bundled adspirer-setup skill. Hermes exposes portable skills under a namespaced installed-plugin identifier; use skills_list to find the full qualified name.

Safety contract

Adspirer manages advertising accounts that can spend real money. The bundled skills require the agent to:

  • inspect the live account before proposing a write;
  • show the exact budget and request explicit approval before spending or moving money;
  • create new campaigns paused;
  • verify every create or update by reading it back; and
  • prefer reversible actions and confirm destructive operations.

Authentication and advertising-platform authorization remain scoped to the user's Adspirer account. This repository contains no access tokens, API keys, ad-platform credentials, or customer data.

Included components

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

The package follows the published Agent Plugins v1 specification. Hermes discovers the root plugin.json, mcp.json, and immediate child directories under skills/.

Included skills

Skill Purpose
adspirer-agent Safety contract and routing for paid-media work
adspirer-setup Connect Adspirer and build BRAND.md and STRATEGY.md
adspirer-mcp MCP tool discovery, router calls, account IDs, quotas, and budget units
adspirer-launch Plan and create paused campaigns
adspirer-performance-review Cross-platform performance reporting and diagnosis
adspirer-optimize Wasted-spend analysis and approval-gated optimization
adspirer-creative Platform-aware ad-copy and creative workflows
adspirer-google-ads Google Ads campaign guidance
adspirer-meta-ads Meta Ads campaign guidance
adspirer-tiktok-ads TikTok Ads campaign guidance
adspirer-linkedin-ads LinkedIn Ads campaign guidance
adspirer-amazon-ads Amazon Ads campaign guidance
adspirer-chatgpt-ads ChatGPT Ads campaign guidance
adspirer-docs Adspirer product, plan, connection, and troubleshooting documentation

Authentication

The plugin intentionally stores no credentials in mcp.json. On first connection, the pinned mcp-remote bridge discovers Adspirer's OAuth metadata, opens the browser login, completes the PKCE exchange, and stores the resulting tokens locally in ~/.mcp-auth/mcp-remote-0.1.49/. To reauthorize, remove only the Adspirer entry from that versioned token directory and run /reload-mcp, or use the Hermes connector UI when available.

Why a bridge? Agent Plugins v1 does not have a portable field for declaring OAuth on a remote MCP entry. Hermes supports OAuth for native MCP configuration, but its portable plugin translator cannot currently carry that setting. The pinned bridge preserves one-command plugin installation while using Adspirer's hosted server and standards-based OAuth flow.

Scheduled reviews

Hermes can run recurring advertising reviews through its cronjob tool. Attach the relevant Adspirer skill and use a project work directory so scheduled runs can read BRAND.md and STRATEGY.md. A scheduled run consumes Adspirer tool calls like an interactive session; weekly is the recommended default for performance reviews.

Development

Validate the package with the same admission command used by the Hermes catalog:

hermes plugins validate .

Before releasing, test installation from a clean Hermes profile, complete the browser login triggered by the first MCP connection, confirm all fourteen skills load, and run at least one read-only MCP call.

Support and security

Licensed under the MIT License.

← Back to the catalog · catalog built Oct 14, 2026