Skip to content

hypd-ai/hypd-ai-ads

v1.0.0MIT

Read-only paid-media analysis for Google Ads, Meta (Facebook) Ads, Microsoft Ads, LinkedIn Ads, Google Analytics (GA4), Search Console and Merchant Center in plain language, plus keyword and competitor research and landing-page checks. HYPD reports on your accounts and never changes your campaigns.

GitHubOpen Website

HYPD: manage paid media safely with AI

HYPD AI: Paid Ads & Analytics for Hermes

Read-only paid-media analysis in plain language for Google Ads, Meta (Facebook) Ads, Microsoft Ads, LinkedIn Ads, Google Analytics (GA4), Search Console and Merchant Center, plus keyword and competitor research and landing-page checks.

Read-only. HYPD reports on your accounts and never changes your campaigns, budgets or ads.

Install

hermes plugins install hypd-ai-ads

Or straight from this repository:

hermes plugins install HYPD-AI/hypd-hermes-plugin

Then start a new session. On the first HYPD tool call, a browser window opens to sign in to HYPD.

Requirements

  • A HYPD account: sign up at app.hypd.ai and connect at least one ad account on the Sources page.
  • Node.js 20.18.1 or newer with npm. The plugin's connector runs a pinned mcp-remote@0.1.49 through npx, which handles the HYPD sign-in.

Without Node

Add HYPD as a native MCP server instead. Hermes then signs in without the connector:

hermes mcp add hypd --url https://mcp.hypd.ai/mcp --auth oauth

What's included

SkillWhat it does
hypd-getting-startedConnect HYPD and your ad accounts; fixes for sign-in problems
hypd-toolsHow HYPD's tools work and the rules they enforce
hypd-overviewWhat HYPD can do and typical questions
hypd-workflowsReady-made analyses: account audit, wasted spend, negative keywords, keyword research, performance-drop diagnosis, monthly client report, Merchant Center feed checks, Meta diagnosis, creative and competitor analysis, landing-page audit

Try: "Audit my Google Ads account", "Where am I wasting spend?", "Why did performance drop last week?"

Security and data

  • Network endpoints. npx downloads the pinned mcp-remote@0.1.49 from the npm registry on first run. After that the only destination is HYPD's own server, https://mcp.hypd.ai (MCP endpoint /mcp, plus OAuth /authorize, /token and /register).
  • Credentials. OAuth 2.1 with PKCE in your browser. No API keys, and nothing to put in .env. mcp-remote stores its tokens in ~/.mcp-auth on your machine. Your ad-platform credentials stay with HYPD and never pass through the plugin.
  • Read-only. No tool creates, edits, pauses or deletes anything in any connected platform.
  • No telemetry from the plugin. The plugin adds no hooks, scripts or analytics of its own. HYPD's server processes your tool calls to answer them, as described in the Privacy Policy.

Report security issues privately: see SECURITY.md.

Links

Website · Dashboard · Documentation · Privacy Policy · Terms · Support: contact@hypd.ai

License

MIT