> ## 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.

# Adspirer FAQ: Pricing, Security & Supported Platforms

> Common questions about Adspirer — what it is, how it works, pricing, security, supported ad platforms, and troubleshooting for new users.

## What Is Adspirer?

<AccordionGroup>
  <Accordion title="What is Adspirer?">
    Adspirer is an <Tooltip tip="Model Context Protocol — an open standard for connecting AI assistants to external tools">MCP</Tooltip> server that connects AI assistants to advertising platforms. It gives your AI (Claude, ChatGPT, Perplexity, Cursor, Codex) access to 400+ tools for managing Google Ads, Meta Ads, Amazon Ads, ChatGPT Ads, LinkedIn Ads, and TikTok Ads through natural language.

    Instead of logging into 6 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.
  </Accordion>

  <Accordion title="Is Adspirer an AI agent or a tool?">
    Both. At the core, Adspirer is an **MCP server** that provides 400+ 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](/agent-skills/overview) for details.
  </Accordion>

  <Accordion title="How is Adspirer different from other ad management tools?">
    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.
  </Accordion>

  <Accordion title="Which AI clients work with Adspirer?">
    Any MCP-compatible AI client. Currently supported with setup guides:

    | Client                                 |         Agent Support        |            Setup Guide           |
    | -------------------------------------- | :--------------------------: | :------------------------------: |
    | [Claude Code](/ai-clients/claude-code) |   Full (subagent + skills)   | [Guide](/ai-clients/claude-code) |
    | [Claude](/ai-clients/claude)           |         Skill upload         |    [Guide](/ai-clients/claude)   |
    | [Cursor](/ai-clients/cursor)           |    Full (subagent + rules)   |    [Guide](/ai-clients/cursor)   |
    | [Codex](/ai-clients/codex)             | Full (agent config + skills) |    [Guide](/ai-clients/codex)    |
    | [ChatGPT](/ai-clients/chatgpt)         |          Tools only          |   [Guide](/ai-clients/chatgpt)   |
    | [Windsurf](/ai-clients/windsurf)       |          Coming soon         |   [Guide](/ai-clients/windsurf)  |
    | [OpenClaw](/ai-clients/openclaw)       |         Bundled skill        |   [Guide](/ai-clients/openclaw)  |
    | [Perplexity](/ai-clients/perplexity)   |         Skill upload         |  [Guide](/ai-clients/perplexity) |
    | [Manus](/ai-clients/manus)             |    Skills (GitHub import)    |    [Guide](/ai-clients/manus)    |
  </Accordion>
</AccordionGroup>

## How It Works

<AccordionGroup>
  <Accordion title="How does Adspirer connect to my ad accounts?">
    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](/knowledge-base/security).
  </Accordion>

  <Accordion title="Can Adspirer spend my money without permission?">
    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
  </Accordion>

  <Accordion title="What is MCP?">
    <Tooltip tip="Model Context Protocol">MCP</Tooltip> (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 400+ advertising tools through one connection. See [How MCP Works](/mcp).
  </Accordion>

  <Accordion title="What are skills and why do they matter?">
    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](/agent-skills/overview).
  </Accordion>

  <Accordion title="Not sure where to start — or why something failed?">
    Adspirer ships a group of free, read-only **[Diagnostic & Helper tools](/agent-skills/diagnostic-helper-tools)** for exactly these moments. Ask your assistant things like:

    * *"What should I do first?"* → suggests your best next step from your real connected accounts
    * *"Is my account ready to launch?"* → checks billing, connection, and (for Meta) pixel/Page before you create anything
    * *"Why did that fail?"* → turns a cryptic platform error into a plain-language fix
    * *"Diagnose my setup"* → tells apart an AI-client connection problem from an ad-platform sign-in problem
    * *"What changed since last week?"* → spend/conversion movement plus the top opportunities to act on

    They're **quota-free** (never count against your tool-call limit) and work on every plan, including Free. In ChatGPT and Claude, their results render as interactive cards.
  </Accordion>

  <Accordion title="Can I use Adspirer on a remote server or in Docker?">
    Yes. Generate a **Personal Access Token** (API key) from [adspirer.ai/keys](https://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](https://adspirer.ai/connections). The API key on your remote server will then access those connected accounts.

    See the [OpenClaw Remote Server Setup](/ai-clients/openclaw#remote-server-setup) guide.
  </Accordion>

  <Accordion title="Do I need to install anything?">
    It depends on your AI client:

    * **Claude (web/desktop):** No install. Add a connector URL in settings. [Guide →](/ai-clients/claude)
    * **ChatGPT:** No install. Add a connector in settings. [Guide →](/ai-clients/chatgpt)
    * **Claude Code:** One command (`/plugin install adspirer-ads-agent@claude-community`) — available on Anthropic's community plugin marketplace (enabled by default). [Guide →](/ai-clients/claude-code)
    * **Cursor:** One command (bash installer). [Guide →](/ai-clients/cursor)
    * **Codex:** One command (bash installer). [Guide →](/ai-clients/codex)
  </Accordion>
</AccordionGroup>

## Ad Platforms

<AccordionGroup>
  <Accordion title="Which ad platforms does Adspirer support?">
    Six platforms with 400+ tools:

    | Platform         | Tools | What You Can Do                                                                             |
    | ---------------- | :---: | ------------------------------------------------------------------------------------------- |
    | **Google Ads**   |  147  | Keyword research, Search & PMax campaigns, wasted spend, budget optimization, ad extensions |
    | **Amazon Ads**   |   61  | Sponsored Products/Brands/Display, keyword & product targeting, bid optimization            |
    | **LinkedIn Ads** |   55  | Sponsored content, lead gen, B2B targeting, creative management                             |
    | **Meta Ads**     |   54  | Image/video/carousel campaigns, audience targeting, creative fatigue                        |
    | **TikTok Ads**   |   37  | In-feed campaigns, video asset validation                                                   |
    | **ChatGPT Ads**  |   31  | Conversational campaign launch and management                                               |

    See [Platform Comparison](/knowledge-base/platform-comparison) for a detailed breakdown.
  </Accordion>

  <Accordion title="Can I use Adspirer with multiple ad accounts?">
    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](/knowledge-base/multi-account).
  </Accordion>

  <Accordion title="Does Adspirer work with agency accounts?">
    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](/knowledge-base/multi-client). Agencies and teams managing many client accounts at scale should also review the [Adspirer Enterprise plans for agencies and teams](/knowledge-base/enterprise), which add multi-seat access and pooled tool calls.
  </Accordion>

  <Accordion title="Are campaigns created live or paused?">
    **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.
  </Accordion>
</AccordionGroup>

## Pricing & Billing

<AccordionGroup>
  <Accordion title="What's a tool call? Is it the same as a task?">
    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](/knowledge-base/pricing#whats-a-tool-call).
  </Accordion>

  <Accordion title="How much does Adspirer cost?">
    Pricing is based on **tool calls**, not ad spend:

    | Plan     | Price    |      Tool Calls     | Best For                                     |
    | -------- | -------- | :-----------------: | -------------------------------------------- |
    | **Free** | \$0/mo   |       15/month      | Setup verification + 1 trial campaign        |
    | **Plus** | \$49/mo  | 150/month + overage | Solo advertisers, single platform            |
    | **Pro**  | \$99/mo  |      600/month      | Active multi-platform campaign managers      |
    | **Max**  | \$199/mo |     3,000/month     | Agencies, sequential sub-agents, power users |

    Plus subscribers get pay-as-you-go overage after 150 calls at $0.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 ~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](/knowledge-base/pricing).
  </Accordion>

  <Accordion title="Is there a free tier?">
    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 →](https://adspirer.ai/sign-up?utm_source=docs\&utm_medium=faq\&utm_content=signup)
  </Accordion>

  <Accordion title="Do I need a paid ChatGPT or Claude subscription to use Adspirer?">
    **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](/ai-clients/claude-code), [Cursor](/ai-clients/cursor), [Codex](/ai-clients/codex), [Windsurf](/ai-clients/windsurf), [OpenClaw](/ai-clients/openclaw), and [Gemini CLI](/ai-clients/gemini-cli).
  </Accordion>

  <Accordion title="Do I pay separately for each AI client?">
    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.
  </Accordion>
</AccordionGroup>

## Security & Privacy

<AccordionGroup>
  <Accordion title="Is my data safe?">
    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](/knowledge-base/security) for full details.
  </Accordion>

  <Accordion title="Can I revoke Adspirer's access?">
    Yes, anytime. Go to your ad platform's security or connected apps settings:

    * **Google Ads:** [myaccount.google.com/permissions](https://myaccount.google.com/permissions)
    * **Meta:** Settings & Privacy → Settings → Business Integrations
    * **LinkedIn:** Settings → Data Privacy → Permitted Services
    * **TikTok:** Settings → Security → Authorized Apps
  </Accordion>

  <Accordion title="How are API keys secured?">
    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](/knowledge-base/security#api-key-authentication).
  </Accordion>

  <Accordion title="Does Adspirer store my ad data?">
    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.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Nothing is working — tools fail or I can't reach Adspirer">
    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 permissions**

    Your 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:** Type `/plugin` → **Installed** tab → select **adspirer** → **Authenticate** (or use `/mcp` → **plugin:adspirer-ads-agent:adspirer MCP Server** → **Authenticate**)
    * **Cursor:** Re-connect via MCP settings

    **Step 3: Refresh your Adspirer session**

    If reconnecting the connector doesn't fix it, your Adspirer login session may have expired:

    1. Go to [adspirer.ai](https://adspirer.ai)
    2. Log out (click your avatar → Sign out)
    3. Log back in
    4. Return to your AI client and try again

    <Note>
      **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](https://adspirer.ai/connections).
    </Note>
  </Accordion>

  <Accordion title="Why does my connector keep disconnecting? (Claude / ChatGPT web)">
    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)

    <Tip>
      If you find yourself reconnecting frequently, make sure you're logged into [adspirer.ai](https://adspirer.ai) in the same browser. An active Adspirer session makes re-authentication faster (often just a single click).
    </Tip>
  </Accordion>

  <Accordion title="Why isn't Adspirer connecting to my ad account?">
    Common causes:

    1. **Ad platform not connected:** Visit [adspirer.ai](https://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
  </Accordion>

  <Accordion title="Why do I see 'token expired' errors?">
    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](https://adspirer.ai) and log back in to refresh your session, then reconnect the connector.
  </Accordion>

  <Accordion title="I hit my tool call limit. What now?">
    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, 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 status`

    [View pricing & annual plans →](/knowledge-base/pricing)
  </Accordion>

  <Accordion title="My API key isn't working. What should I check?">
    Common causes:

    1. **Key revoked or expired:** Check your key status at [adspirer.ai/keys](https://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](https://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.
  </Accordion>

  <Accordion title="Campaign creation failed. What should I do?">
    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/day minimum, Meta $5/day

    If using skills, the workflow handles all of these automatically.
  </Accordion>
</AccordionGroup>

## Related Documentation

* [Security & Data Privacy](/knowledge-base/security) — OAuth, token lifecycle, data access
* [Pricing](/knowledge-base/pricing) — Plans and tool call limits
* [Enterprise Plans](/knowledge-base/enterprise) — Multi-seat access, pooled tool calls, and dedicated support for agencies and teams
* [Platform Comparison](/knowledge-base/platform-comparison) — Google vs Meta vs LinkedIn vs TikTok
* [Agent Skills Overview](/agent-skills/overview) — Skills, workflows, and safety rules