Install the Hyper Marketing plugin for Claude Code and run your entire marketing stack from chat.
Run paid ads, organic social, SEO, analytics, and outbound — from your terminal. One plugin install wires up the Hyper MCP and marketing skills so Claude knows how to plan, launch, and report without you stitching tools together.
Use slash commands yourself. Commands like /plugin, /mcp, and
/reload-plugins must be typed into the Claude Code input. If you ask Claude
to run them for you, you’ll hit a “nested session” error.
User scope — available in all your projects (recommended)
Project scope — shared with collaborators on this repo
Local scope — only this repo, only for you
Plugin install — scope selection
3
Reload plugins
After install, reload so skills and the MCP server register:
/reload-plugins
Or quit and reopen Claude Code.
Output after reload — plugins, skills, and MCP loaded
4
Authenticate with Hyper
The plugin’s MCP server needs a one-time OAuth sign-in. Use either path:From the plugin manager (recommended): type /plugin, open the Installed tab, and select hyper-marketing if it shows “needs attention.”
Select the plugin, then choose Authenticate on the Hyper MCP server. Your browser opens — sign in to Hyper and authorize access.
OAuth authorization in the browser
From /mcp: type /mcp, find the Hyper MCP server in the list, select it, then choose Authenticate.
MCP list — Hyper server with Authenticate option
Return to Claude Code — you should see authentication succeed.
5
Verify the install
Type / in Claude Code and look for skills under the hyper-marketing namespace — for example hyper-marketing:google-ads, hyper-marketing:meta-ads, and hyper-marketing:seo-research. You can also open the slash command menu or run /help and check the Commands tab.
Slash commands showing hyper-marketing skills
If you prefer to configure the MCP directly without the plugin:
1
Add the MCP server
Run this in your terminal (outside a nested Claude session):
claude mcp add hyperfx --transport http https://backend.hyperfx.ai/mcp/
2
Authenticate
Start a Claude Code session (claude). You’ll be prompted to sign in to Hyper and authorize access — same OAuth flow as the plugin path (see the OAuth screenshot in the plugin install steps above).
3
Install skills separately
The plugin normally installs skills for you. With manual MCP setup, add them yourself:
app.hyperfx.ai/mcp — add the Hyper toolkit to your MCP server and connect integrations from the same page
Most people start at Apps to link accounts, then use MCP to choose which toolkits and tools Claude Code can access. Each skill declares what it needs at the top — for example, google-ads requires Google Ads, and meta-ads requires Meta Business.
You can connect integrations at any time. If a skill needs something that isn’t connected yet, Claude will tell you which platform to add.
Once connected, Claude Code can run full marketing workflows through Hyper — not just single tools:
Paid campaigns — Set up, launch, and optimize across Meta, Google Ads, TikTok, and Amazon (creatives, targeting, keywords, budgets, tracking, monitoring).
Market research — Find winning angles via Meta Ads Library, Reddit, Instagram, TikTok, YouTube, and competitor sites (hooks, offers, pain points, creative trends).
SEO & content — Connect WordPress, Webflow, Wix, or Ghost, then improve SEO and AI search visibility with keyword research, content briefs, automated posts, and performance tracking.
Organic social — Create and schedule posts across Instagram, TikTok, LinkedIn, Reddit, Pinterest, and X using brand voice, trend research, and generated images or video.
Ecommerce analytics — Connect Shopify, GA4, Search Console, Meta, Google Ads, and TikTok to analyze store performance, find conversion issues, and recommend campaigns, landing pages, and budget shifts.
Copy these into Claude Code as-is, then swap in your brand, URLs, and numbers. The more context you give, the better the skill routing and output. Each example maps to one of the workflows above.
Plan and Launch a Google Search campaign for my B2B SaaS product:- Product: project management tool for remote teams- Site: https://example.com- Audience: team leads and ops managers at companies with 20–200 employees- Budget: $75/day- Geo: US and CanadaBefore creating anything:1. Research keywords with real search volume and CPC estimates2. Group keywords by intent (branded, competitor, feature-based, problem-aware)3. Propose 2 ad groups with 3 responsive search ads each4. List negative keywords to add on day onePause all campaigns until I approve the structure and copy.
Claude should pull keyword data through Hyper, draft ad groups and RSAs, and leave campaigns paused for your review.
Use the Meta Ads Library to research competitors in the DTC skincare space:- Keywords: "anti-aging serum", "retinol", "vitamin C serum"- Countries: US- Pull the last 50 active ads across the top 5 advertisers by volume- For each advertiser, summarize: primary hooks, offer types (discount vs bundle vs free shipping), creative format mix (static vs video vs carousel), and how long ads have been runningEnd with 5 creative angles we should test, grounded in what's working in the library.
Run an SEO audit on https://example.com:- Focus on commercial pages (pricing, product, comparisons)- Pull top keyword opportunities we're not ranking for yet- Flag technical issues that block crawling or indexing- Check AI search visibility (how we're cited in AI Overviews / chat-style results if data is available)Deliver a prioritized action list: quick wins this week, medium effort this month, and larger projects. Estimate impact where you can.
Create and schedule a week of organic social content for my DTC skincare brand:- Brand voice: clean, science-backed, approachable — never alarmist or overly salesy- Core message: "gentle retinol that works for sensitive skin"- Site: https://example.comBefore writing anything:1. Research what's trending on TikTok, Instagram, Reddit, and X around retinol, sensitive skin, and night routines — note hooks and formats that are getting engagement2. Pull competitor or category posts if useful for angle ideas (don't copy)Then build platform-native content for the week (Mon–Fri):- **Instagram** — 1 Reel concept + 1 carousel (5 slides)- **TikTok** — 1 short video script (15–30 sec) with on-screen text beats- **LinkedIn** — 1 thought-leadership post for our founder (plain text + optional doc/carousel outline)- **Reddit** — 1 value-first post draft for r/SkincareAddiction (no hard sell; follow sub rules)- **Pinterest** — 2 pin concepts with titles, descriptions, and image prompts- **X** — 3 posts (mix of tip thread + product mention + engagement question)For each piece: full copy, hashtags where appropriate, suggested post time, and image or video generation prompts (or generate assets if those tools are connected).Do not publish or schedule anything — deliver a review doc I can approve platform by platform.
Claude should route through organic social skills (instagram, tiktok, linkedin, etc.) plus image-generation or video-generation for assets, and research skills for trend discovery.
Audit my Shopify store performance for the last 30 days and recommend what to change in paid media:- Store: https://example.myshopify.com- Pull GA4: sessions, add-to-cart, purchases, and revenue by channel (organic, paid social, paid search, email, direct)- Compare to the prior 30 days — flag any channel where conversion rate dropped more than 15%- If Meta and Google Ads are connected, summarize spend, ROAS, and CPA by campaign- Identify top landing pages with high traffic but low purchase rateEnd with a prioritized list: budget shifts, campaign pauses, and 3 landing-page tests. Pause or reduce spend recommendations only — don't change live budgets without my approval.
Claude should use analytics-insights plus ad platform skills when those integrations are connected.
Build a marketing agent on Hyper called "Claude Code Test Agent":- Scope: own weekly performance reporting and competitor monitoring- Assign tasks for Monday performance digest and Friday competitor scan- Attach skills for analytics-insights and competitor-intel- Use tools appropriate for GA4, Google Ads, and Meta if those integrations are connectedShow me what you created and link to it in Hyper when done.
You asked Claude to run /plugin or /mcp instead of typing it yourself. Slash commands must go directly into the Claude Code input — not through a prompt to the model.
Skills aren't showing up after install
Run /reload-plugins, or restart Claude Code. Then type / and look for the hyper-marketing: namespace, or run /help and check the Commands tab.If skills are still missing, confirm the plugin is enabled: /plugin → Installed tab → hyper-marketing.
Plugin or MCP shows 'needs authentication'
Open /plugin → Installed → hyper-marketing → Authenticate, or use /mcp → select the Hyper server → Authenticate.If the browser flow fails, try a private window or disable ad blockers temporarily. You can also reconnect from app.hyperfx.ai/mcp.
A skill says the MCP isn't connected
Run /plugin list to confirm hyper-marketing is enabled. Re-authenticate the Hyper MCP server via /mcp or the Installed tab in /plugin.
A skill says an integration isn't connected
Connect the platform at app.hyperfx.ai/apps, or from app.hyperfx.ai/mcp if you’re managing connections there. Each skill lists required integrations at the top of its instructions.
Manual MCP — server not found
Check your MCP config:
cat ~/.claude/mcp.json
You should see a hyperfx entry pointing at https://backend.hyperfx.ai/mcp/. Re-run the claude mcp add command if it’s missing.
No. MCP is the connection layer — you talk to Claude in plain language. The plugin configures the Hyper MCP server for you.
What's the difference between this and Connect to Claude (desktop)?
Connect to Claude covers Claude’s chat app (connectors UI). This page is for Claude Code — the terminal CLI with plugins, slash commands, and project-scoped skills.
Can I use the plugin and manual MCP setup together?
Pick one path to avoid duplicate MCP entries. The plugin is recommended — it installs skills and keeps the MCP config in sync.
How do I invoke a skill directly?
Type the skill path in Claude Code, for example /hyper-marketing:google-ads, then describe what you want. You can also just ask in natural language; Claude routes to the right skill when the task matches.
