Prerequisites
- Claude Code installed:
- An Adspirer account (free to start)
- At least one ad platform account: Google Ads, Meta Ads, LinkedIn Ads, or TikTok Ads
- macOS or Linux (Windows requires WSL)
Setup
Install
- Plugin Install (Recommended)
- Manual MCP Setup
Important: 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).Restart Claude Code
Close and reopen Claude Code to load the new plugin. The plugin won’t appear in
/mcp until you restart.Authenticate with Adspirer
- Type
/mcpto open the MCP server list - Find plugin:adspirer:adspirer — it will show ⚠ needs authentication
- Select it and press Enter to authenticate
- Your browser opens — sign in with your Adspirer account and authorize access
- Connect your ad platforms when prompted
- Return to Claude Code — run
/mcpagain to confirm it shows ✓ connected
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 100+ 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
100+ tools across 4 ad platforms. Here’s what matters:| Platform | Tools | Key Capabilities |
|---|---|---|
| Google Ads | 39 | Keyword research with real CPC data, Search & PMax campaigns, wasted spend analysis, budget optimization, ad extensions, asset management |
| LinkedIn Ads | 28 | Sponsored content, lead gen forms, B2B targeting (job titles, industries, seniority), creative performance analysis |
| Meta Ads | 20 | Image/video/carousel campaigns, audience targeting, creative fatigue detection, placement optimization |
| TikTok Ads | 4 | In-feed campaigns, asset validation, performance analysis |
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 commands must be typed directly into the Claude Code input — don’t ask Claude to run them for you.
Plugin not showing in /mcp after install
You need to restart Claude Code after running /plugin install adspirer. Close and reopen Claude Code, then type /mcp — you should see plugin:adspirer:adspirer in the list.
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
If you used the plugin, run/mcp and look for plugin:adspirer:adspirer. If it’s missing, you may need to restart Claude Code or re-install the plugin.
If you used the manual method, check your MCP config:
https://mcp.adspirer.com/mcp.
Tools not working after connecting
Check your Adspirer account status at adspirer.ai. Free accounts get 10 tool calls/month. If you’ve hit the limit, upgrade to Plus (75/mo for 100 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 or Claude Code wasn’t restarted. 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 Desktop?
What's the difference between Claude Code and Claude Desktop?
Claude Code is the terminal-based developer tool. Claude Desktop is the GUI app with chat and Cowork modes. Both support Adspirer through MCP. Use Claude Code if you live in the terminal. Use Claude Desktop if you prefer a visual interface.
What does the plugin install?
What does the plugin install?
The Adspirer 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: 10 calls/month. Plus: 75/mo for 100 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.