Skip to main content

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.

​
What Is Adspirer?

Adspirer is an server that connects AI assistants to advertising platforms. It gives your AI (Claude, ChatGPT, Perplexity, Cursor, Codex) access to 190+ tools for managing Google Ads, Meta Ads, LinkedIn Ads, and TikTok Ads through natural language.Instead of logging into 4 different ad platforms, you describe what you want — “find wasted spend across all platforms” or “create a Google Search campaign for my SaaS” — and your AI handles it.
Both. At the core, Adspirer is an MCP server that provides 190+ advertising tools. On top of that, it ships a performance marketing agent — a specialized AI agent with brand awareness, strategy persistence, and proven workflows.
  • Tools only: Connect the MCP server and use raw tools. Good for quick queries.
  • Agent + tools: Install the full plugin (agent, skills, slash commands). The agent follows proven workflows, remembers your brand, and persists strategic decisions.
See Agent Skills Overview for details.
Traditional tools have dashboards you click through. Adspirer is different in two ways:
  1. Natural language interface. You describe what you want. No dashboards, no button hunting, no learning a new UI.
  2. AI-native workflows. The agent researches your competitors, pulls real keyword data, writes brand-voice ad copy, and creates campaigns — all in one conversation.
It’s not a dashboard replacement. It’s an AI-powered advertising manager that connects directly to your ad platforms.
Any MCP-compatible AI client. Currently supported with setup guides:
ClientAgent SupportSetup Guide
Claude CodeFull (subagent + skills)Guide
ClaudeSkill uploadGuide
CursorFull (subagent + rules)Guide
CodexFull (agent config + skills)Guide
ChatGPTTools onlyGuide
WindsurfComing soonGuide
OpenClawBundled skillGuide
PerplexitySkill uploadGuide
ManusSkills (GitHub import)Guide

​
How It Works

Through OAuth 2.1 with PKCE — the same standard used by banking apps. When you connect a platform:
  1. Your browser opens to Google/Meta/LinkedIn/TikTok’s login page
  2. You sign in with your existing credentials (Adspirer never sees your password)
  3. You authorize specific permissions (read campaigns, create ads, etc.)
  4. Adspirer receives a scoped access token — not your password
You can revoke access anytime from your ad platform’s security settings. See Security.
No. Multiple safety layers prevent unauthorized spending:
  • All campaigns are created in PAUSED status — you review before anything goes live
  • The agent always asks before any action that affects spend
  • Skills enforce a read-before-write pattern — research and validation happen before creation
  • Adspirer never retries a failed campaign creation automatically
  • Budget guardrails from your brand context file are checked before spend-affecting actions
(Model Context Protocol) is an open standard created by Anthropic that allows AI assistants to connect to external tools and services. Think of it as a universal adapter between AI and the tools it needs.Adspirer implements MCP so that any AI client — Claude, ChatGPT, Perplexity, Cursor, Codex — can access the same 190+ advertising tools through one connection. See How MCP Works.
Skills are instruction files (SKILL.md) that teach AI assistants the right workflow for advertising tasks. Without skills, the AI guesses which tools to call. With skills:
  • It follows proven workflows (research → validate → create → verify)
  • Safety rules are enforced automatically
  • Campaign creation works on the first try instead of failing mid-workflow
Skills are optional but highly recommended. See Agent Skills Overview.
Yes. Generate a Personal Access Token (API key) from adspirer.ai/keys, then authenticate using either:
  • CLI flag: openclaw adspirer login --token sk_live_your_key
  • Environment variable: export ADSPIRER_API_KEY=sk_live_your_key
You still need to connect your ad platforms via OAuth from a browser at adspirer.ai/connections. The API key on your remote server will then access those connected accounts.See the OpenClaw Remote Server Setup guide.
It depends on your AI client:
  • Claude (web/desktop): No install. Add a connector URL in settings. Guide →
  • ChatGPT: No install. Add a connector in settings. Guide →
  • Claude Code: One command (/plugin install adspirer-ads-agent@claude-plugins-official) — available on the official Anthropic plugin marketplace. Guide →
  • Cursor: One command (bash installer). Guide →
  • Codex: One command (bash installer). Guide →

​
Ad Platforms

Four platforms with 190+ tools:
PlatformToolsWhat You Can Do
Google Ads39Keyword research, Search & PMax campaigns, wasted spend, budget optimization, ad extensions
LinkedIn Ads28Sponsored content, lead gen, B2B targeting, creative management
Meta Ads20Image/video/carousel campaigns, audience targeting, creative fatigue
TikTok Ads4In-feed campaigns, video asset validation
See Platform Comparison for a detailed breakdown.
Yes. You can connect multiple accounts per platform. Use switch_primary_account to change which account you’re managing, or specify the account ID in your prompts. See Multi-Account Management.
Yes. Adspirer supports MCC (My Client Center) accounts for Google Ads and Business Manager accounts for Meta. You can manage multiple client accounts from one Adspirer connection. See Multi-Client Management. Agencies and teams managing many client accounts at scale should also review the Adspirer Enterprise plans for agencies and teams, which add multi-seat access and pooled tool calls.
Always paused. Every campaign Adspirer creates starts in PAUSED status. You review the campaign — targeting, keywords, ad copy, budget — and manually enable it when you’re ready. This is enforced at both the skill level and the tool level.

​
Pricing & Billing

Yes — a tool call is a task your AI assistant performs for you, on a complexity spectrum:
  • Simple task (1 call): “What’s my Google Ads ROAS this month?” · keyword research · pull last week’s performance
  • Medium task (8–12 calls): Launch a single campaign — research keywords, write ad copy, validate assets, create paused, summarize for review
  • Complex task (25–40+ calls): “Take my Q2 media plan and launch paused campaigns across Google, Meta, and LinkedIn” — multi-platform research, asset validation, and creation in one prompt
The same plan covers tasks at every level — you just use more calls when the task is bigger. See full breakdown.
Pricing is based on tool calls, not ad spend:
PlanPriceTool CallsBest For
Free$0/mo15/monthSetup verification + 1 trial campaign
Plus$49/mo150/month + overageSolo advertisers, single platform
Pro$99/mo600/monthActive multi-platform campaign managers
Max$199/mo3,000/monthAgencies, sequential sub-agents, power users
Plus subscribers get pay-as-you-go overage after 150 calls at 0.50/call,cappedat0.50/call, capped at 50/month. A typical single-campaign launch uses 8–12 tool calls; a multi-platform launch from one media plan uses 25–40+. The Pro plan (99/mo)delivers 120hoursofequivalentspecialistwork—about∗∗76×cheaperthananin−housespecialist∗∗(99/mo) delivers ~120 hours of equivalent specialist work — about **76× cheaper than an in-house specialist** (7,500/mo) and 15× cheaper than an Upwork contractor ($1,500/mo). See full pricing.
Yes — 15 tool calls/month, no credit card required. The free tier is sized to verify Adspirer connects to your AI client and ad accounts and to run one end-to-end campaign as a taste test. It’s an evaluation tier — not enough for ongoing production work. For active campaign management, plan on Plus ($49/mo) or above. Sign up free →
It depends on your AI client. Custom MCP connectors require:
  • Claude: Pro, Max, Team, or Enterprise (connectors aren’t available on the Claude free tier)
  • ChatGPT: Plus or Pro (connectors aren’t available on the ChatGPT free tier)
These are AI platform requirements set by Anthropic and OpenAI, not Adspirer’s. Free alternatives that connect to Adspirer without a paid Claude or ChatGPT subscription: Claude Code, Cursor, Codex, Windsurf, OpenClaw, and Gemini CLI.
No. Your Adspirer plan works across all AI clients. The same account and tool call quota applies whether you use Claude, ChatGPT, Perplexity, Cursor, Codex, Claude Code, Windsurf, or any other MCP-compatible client.

​
Security & Privacy

Yes. Key protections:
  • OAuth 2.1 with PKCE — Adspirer never sees your passwords
  • Scoped permissions — you authorize exactly what Adspirer can do
  • Encrypted tokens — access tokens encrypted at rest, auto-refreshed
  • Revocable access — revoke anytime from your ad platform’s security settings
  • No billing data — Adspirer never accesses credit cards or payment information
See Security & Data Privacy for full details.
Yes, anytime. Go to your ad platform’s security or connected apps settings:
  • Google Ads: myaccount.google.com/permissions
  • Meta: Settings & Privacy → Settings → Business Integrations
  • LinkedIn: Settings → Data Privacy → Permitted Services
  • TikTok: Settings → Security → Authorized Apps
API keys are hashed with SHA-256 before storage — the raw token is never stored server-side. Keys can be revoked instantly from the dashboard, set to expire after a specified period, and are tier-limited (Free: 2 keys, Plus: 5, Pro: 10, Max: 20). See Security — API Key Authentication.
Adspirer reads your campaign data in real-time from ad platform APIs and returns it to your AI client. It does not permanently store campaign performance data, ad copy, or targeting settings. OAuth tokens are stored encrypted for session management.

​
Troubleshooting

If no tools work at all (even get_connections_status or echo_test fails), this is a connection issue between your AI client and the Adspirer MCP server. Follow these steps in order:Step 1: Check tool permissionsYour AI client needs the right tool permission settings:
  • Read tools (performance analysis, keyword research, connection status): Set to Always allow
  • Write tools (campaign creation, budget changes): Set to Custom (ask each time)
If tools are set to “Block” or “Never allow,” Adspirer can’t execute anything. Check your connector settings and toggle permissions.Step 2: Disconnect and reconnect the Adspirer connector
  • Claude (web/desktop): Go to Customize → Connectors, find Ads MCP, click Disconnect, then Connect again and complete the OAuth flow
  • ChatGPT: Go to Settings → Apps, find Adspirer, click Disconnect, then reopen the Adspirer app, click Connect, and complete OAuth
  • Claude Code: Run claude mcp remove adspirer, then claude mcp add --transport http adspirer https://mcp.adspirer.com/mcp, restart, and re-authenticate via /mcp
  • Cursor: Re-connect via MCP settings
Step 3: Refresh your Adspirer sessionIf reconnecting the connector doesn’t fix it, your Adspirer login session may have expired:
  1. Go to adspirer.ai
  2. Log out (click your avatar → Sign out)
  3. Log back in
  4. Return to your AI client and try again
When does this apply? Only when nothing works — not even basic tools like get_connections_status. If some ad accounts work but one doesn’t (e.g., Google works but LinkedIn fails), that’s a platform-specific connection issue, not a general connection problem. In that case, reconnect just that platform at adspirer.ai/connections.
Claude (web/desktop) and ChatGPT periodically disconnect MCP connectors — typically every 1–2 weeks. This is normal behavior for web-based AI clients, not an Adspirer issue.When it happens:
  1. Go to your AI client’s connector settings
  2. Find Adspirer / Ads MCP
  3. Click Connect (or re-enable it)
  4. Complete the OAuth flow if prompted
  5. Verify tool permissions are set correctly (read tools → Always allow, write tools → Custom)
If you find yourself reconnecting frequently, make sure you’re logged into adspirer.ai in the same browser. An active Adspirer session makes re-authentication faster (often just a single click).
Common causes:
  1. Ad platform not connected: Visit adspirer.ai and connect your Google/Meta/LinkedIn/TikTok account
  2. OAuth expired: Re-authenticate by clicking the MCP server connection in your AI client
  3. Browser extension interference: Disable ad blockers temporarily during OAuth
  4. Wrong account: Use switch_primary_account to select the correct ad account
Access tokens expire after 1 hour. Adspirer auto-refreshes them, but if the refresh token (30-day lifetime) has also expired, you’ll need to re-authenticate:
  • Claude Code: Run /mcp, select the Adspirer server, and re-authenticate
  • Claude: Reconnect the connector in Customize → Connectors
  • ChatGPT: Reconnect in Settings → Apps
  • Cursor: Re-connect via MCP settings
If re-authenticating doesn’t work, log out of adspirer.ai and log back in to refresh your session, then reconnect the connector.
You have three options:
  1. Upgrade to a higher tier — takes effect immediately and resets your counter.
  2. Wait for your monthly reset — your quota resets on your billing date.
  3. Switch to an annual plan — annual subscribers get one large yearly pool instead of a monthly cap. No monthly resets, no mid-month walls. Use calls heavily during launch periods and lightly when campaigns are running steady.
Plan-specific behavior:
  • Free (15 calls): Upgrade to Plus or wait for the monthly reset.
  • Plus (150 calls): Overage billing is on by default — you keep going at 0.50/call,cappedat0.50/call, capped at 50/month. If you’ve hit the cap, upgrade to Pro or switch to annual.
  • Pro / Max: Upgrade to the next tier, switch to annual, or wait for reset.
Check your current usage by asking your AI assistant: Check my Adspirer usage statusView pricing & annual plans →
Common causes:
  1. Key revoked or expired: Check your key status at adspirer.ai/keys
  2. Wrong format: API keys start with sk_live_ — check for extra whitespace or line breaks
  3. No ad platforms connected: API keys authenticate you, but you still need to connect platforms at adspirer.ai/connections
  4. Environment variable issue: Verify with echo $ADSPIRER_API_KEY
Generate a new key if the existing one is compromised or expired.
Don’t retry automatically. Common causes:
  • Missing keyword research: Run research_keywords before creating Search campaigns
  • Invalid assets: Run validate_and_prepare_assets to check image dimensions, headline lengths
  • Platform not connected: Run get_connections_status to verify
  • Budget below minimum: Google/LinkedIn require 10/dayminimum,Meta10/day minimum, Meta 5/day
If using skills, the workflow handles all of these automatically.
Last modified on May 29, 2026