Prerequisites
- Claude Code installed:
- An Adspirer account (free to start)
- At least one ad platform account: Google Ads, Meta Ads, Amazon Ads, ChatGPT Ads, LinkedIn Ads, or TikTok Ads
- macOS or Linux (Windows requires WSL)
Setup
Install
One command installs the MCP connector, slash commands, skills, and the Performance Marketing Agent together.The
/plugin and /mcp commands below are slash commands — type them directly into the Claude Code input. Do not ask the AI to run them for you (that will cause a “nested session” error).Install the Plugin
Run this directly from the command line:Or type 
/plugin to open the plugin manager. The UI has four tabs — Discover, Installed, Marketplaces, Errors — cycle with Tab.In the Discover tab, search for adspirer (or ads). You’ll see adspirer-ads-agent from claude-community — Anthropic’s community marketplace, enabled by default.- Install for you (user scope) — recommended, available across all your projects
- Install for all collaborators on this repository (project scope)
- Install for you, in this repo only (local scope)
Authenticate with Adspirer
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 adspirer. You’ll see it flagged as “needs attention”./mcp: type /mcp, find plugin:adspirer-ads-agent:adspirer MCP Server in the list, select it, then choose Authenticate.Sign in with your Adspirer account and authorize the requested scopes (campaigns:read/write, reporting:read, accounts:read). New to Adspirer? The browser lands on a quick sign-up page first — create a free account (no credit card) and you’re sent straight back to the authorization screen. Return to Claude Code — you’ll see “Authentication successful”.Set Up Your Brand Workspace
CLAUDE.md brand workspace file.
Verify Your Setup
Run a test prompt:You’re connected. Claude Code now has access to 400+ advertising tools from your terminal.
Brand Workspace
When you run/adspirer:setup, the agent bootstraps a brand-specific workspace:
- Connects to Adspirer — verifies your ad platform connections
- Scans your folder — reads any brand docs (
.md,.txt,.csv,.yaml,.json,.pdf) for voice, audience, and budget context - Pulls live data — campaign performance, search terms, benchmarks from all connected platforms
- Creates
CLAUDE.md— a brand context file with connected platforms, performance snapshot, KPI targets, and brand guidelines
/adspirer:setup.
Your brand folder can contain docs or be completely empty — the agent builds context from your live ad platform data either way. More docs = better brand context = better ad copy and recommendations.
Slash Commands
The plugin includes 5 slash commands that trigger proven workflows:| Command | What it Does |
|---|---|
/adspirer:setup | Bootstrap a brand workspace — connect accounts, scan docs, pull data, create CLAUDE.md |
/adspirer:performance-review | Cross-platform performance scorecard with KPI comparison |
/adspirer:write-ad-copy | Brand-voice ad copy from real keyword and performance data |
/adspirer:wasted-spend | Find and fix wasted spend across all platforms |
/adspirer:refresh-brand-context | Re-scan docs and update CLAUDE.md with latest data |
What You Can Do
400+ tools across 6 ad platforms. Here’s what matters:| Platform | Tools | Key Capabilities |
|---|---|---|
| Google Ads | 147 | Keyword research with real CPC data, Search & PMax campaigns, wasted spend analysis, budget optimization, ad extensions, asset management |
| Amazon Ads | 61 | Sponsored Products, Brands & Display, ASIN/keyword targeting, ACOS & ROAS analytics, budget recommendations |
| LinkedIn Ads | 55 | Sponsored content, lead gen forms, B2B targeting (job titles, industries, seniority), creative performance analysis |
| Meta Ads | 54 | Image/video/carousel campaigns, audience targeting, creative fatigue detection, placement optimization |
| TikTok Ads | 37 | In-feed campaigns, asset validation, performance analysis |
| ChatGPT Ads | 31 | Pay-per-click chat-card ads inside ChatGPT responses, launch orchestrator, conversions (pixel + CAPI); created paused |
Example Prompts
What to actually say once you’re set up:Google Search Campaign
Google Search campaign with keyword research grouped by intent.
Google PMax Campaign
Performance Max campaign across all Google channels.
Meta Ads Campaign
Meta image campaign with audience targeting and creative copy.
LinkedIn Ads Campaign
LinkedIn B2B campaign targeting senior data leaders.
Cross-Platform Audit
Multi-platform audit with prioritized action list and savings estimate.
Safety Features
Adspirer’s agent skills enforce safety rules to prevent accidental spend:- All campaigns created PAUSED: You review before they go live
- User confirmation required: Claude asks before any action that affects spend
- Read-before-write: Skills force research and validation before campaign creation
- Connection status checks: Always verifies you’re managing the right account first
- No automatic retries: If a campaign creation fails, Claude won’t retry without asking
Troubleshooting
”Nested session” error when installing
If you seeError: Claude Code cannot be launched inside another Claude Code session, you’re asking the AI to install the plugin instead of typing the slash command yourself. The /plugin command must be typed directly into the Claude Code input — don’t ask Claude to run them for you.
Plugin not showing after install
Run/reload-plugins after installing, or restart Claude Code. Then verify via either:
/plugin→ Installed tab — you should see adspirer listed/mcp— you should see plugin:adspirer-ads-agent:adspirer MCP Server
/plugin marketplace update claude-community.
Authentication keeps failing
Clear your browser cache or try a different browser. The OAuth flow uses PKCE for security — some browser extensions can interfere. Disable ad blockers temporarily.MCP server not found
Run/mcp and look for plugin:adspirer-ads-agent:adspirer MCP Server. If it’s missing, run /reload-plugins or restart Claude Code. If it’s still missing, re-run /plugin install adspirer-ads-agent@claude-community.
Tools not working after connecting
Check your Adspirer account status at adspirer.ai. Free accounts get 15 tool calls/month. If you’ve hit the limit, upgrade to Plus (99/mo for 600 calls).Skills not loading
Verify the skills directory exists:Slash commands not available
If/adspirer:setup isn’t recognized, the plugin may not be installed. Run:
FAQ
Do I need to know MCP to use this?
Do I need to know MCP to use this?
No. MCP (Model Context Protocol) is the plumbing — you don’t interact with it directly. You just talk to Claude in plain English. The MCP connection happens behind the scenes.
What's the difference between Claude Code and Claude Cowork / Claude Desktop?
What's the difference between Claude Code and Claude Cowork / Claude Desktop?
Claude Code is Anthropic’s terminal/CLI developer tool — you run
claude in a shell, it works inside your codebase, optimized for software-engineering workflows. There’s also a Claude Code desktop / IDE-side surface.Claude Cowork is a completely different product — a brand-aware workspace mode inside the Claude desktop app (and on claude.ai). You open a folder, Claude reads its docs, and you collaborate with it on the work in that folder.Both support Adspirer through MCP, but they’re separate apps. Use Claude Code if you live in the terminal. Use Claude Cowork if you want a brand-aware workspace with folder context.What does the plugin install?
What does the plugin install?
The
adspirer-ads-agent plugin installs: the MCP server connection, 5 slash commands (setup, performance-review, write-ad-copy, wasted-spend, refresh-brand-context), a performance marketing agent, and the ad campaign management skill file.Can I manage multiple ad accounts?
Can I manage multiple ad accounts?
Yes. Adspirer supports multiple accounts per platform. Use the
switch_primary_account tool to change which account you’re managing, or specify the account ID in your prompts.How much does this cost?
How much does this cost?
Adspirer pricing is based on tool calls, not ad spend. Free tier: 15 calls/month. Plus: 99/mo for 600 calls. Max: $199/mo for 3,000 calls. See the full pricing breakdown.
Is my data safe?
Is my data safe?
Yes. Adspirer uses OAuth 2.1 with PKCE — we never see your passwords. Your ad account credentials live with Google/Meta/LinkedIn/TikTok. We only get read/write permissions you explicitly authorize. You can revoke access anytime from your ad platform’s security settings.