Manage all your ad campaigns from the terminal. One command to connect, 190+ tools to use.Documentation Index
Fetch the complete documentation index at: https://www.adspirer.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
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
Two ways to connect. Manual MCP Setup is the recommended path — one command, works on every Claude Code install. The Plugin Install path bundles the connector with slash commands, skills, and a Performance Marketing Agent, but plugin discovery has been removed from the terminal CLI in recent Claude Code builds (still available on Claude Code desktop / IDE-side). If/plugin doesn’t show Adspirer, use Manual MCP Setup.
- Manual MCP Setup (Recommended)
- Plugin Install (slash commands + agent)
Add the MCP Server
Run this command in your terminal:Next time you ask Claude Code about your ad accounts, it’ll prompt you to sign in. Your browser opens automatically for OAuth 2.1 authorization with PKCE.
Sign In to Adspirer
Approve the requested scopes (campaigns:read/write, reporting:read, accounts:read) and link your Google Ads, Meta Ads, LinkedIn Ads, and/or TikTok accounts. Return to your terminal — you’ll see “Authentication successful”.
Add Agent Skills (Optional)
The skill files give Claude proven advertising workflows (campaign creation, performance review, wasted-spend audit).
Verify Your Setup
Run a test prompt:You’re connected. Claude Code now has access to 190+ 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
190+ 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 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-plugins-official.
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-ads-agent:adspirer MCP Server. If it’s missing, run /reload-plugins or restart Claude Code.
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 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.