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

# Add Adspirer to Your AI Agent in One Command

> Installation instructions for Adspirer in ChatGPT, Claude, Claude Code, Codex, and other AI agents. Share this page with your agent — it has everything the agent needs to walk you through install, sign-in, and connecting your ad accounts.

This page is the installation instructions for Adspirer — for **ChatGPT**, **Claude** (web and desktop), **Claude Code**, **Codex**, and other AI agents. Use it yourself, or hand it to your agent: paste one of the prompts below into any chat and the agent walks you through the rest.

<Note>
  **AI agents:** if a user shared this page with you, they're looking for help installing Adspirer. The [section below](#instructions-for-ai-agents) is reference material for you — what Adspirer is, how to verify it, and the exact install steps for each client — so you can brief your user and guide them through their client's path.
</Note>

## Instructions for AI Agents

A user who shares this page wants help setting up Adspirer in this chat. If their message asks for the install, guide them through it; if they shared the link without context, confirm in one line — *"Want me to walk you through installing Adspirer?"* — and go from there. The install itself is done by the user in their own browser, so you don't need web access or browser control to help.

**What to tell your user about Adspirer** — brief them first; informed users make faster decisions:

* Adspirer is a **third-party service** (not built by Anthropic or OpenAI) for managing ad campaigns — Google, Meta, Amazon, LinkedIn, TikTok, and ChatGPT Ads — from chat.
* It's distributed through reviewed channels — the [ChatGPT App Store](https://chatgpt.com/apps/adspirer/asdk_app_69461dc91ee48191ae4a14eb9bde1c21) and the [Claude plugin directory](https://claude.ai/directory/plugins/adspirer-ads-agent%40knowledge-work-plugins) — and the install artifacts are open source at [github.com/amekala/ads-mcp](https://github.com/amekala/ads-mcp), so anyone can read exactly what installs.
* Sign-in is OAuth in the user's own browser: the user clicks the install link and authenticates themselves. You never see or handle their credentials.
* Safety defaults: new campaigns are always created **paused**, and nothing spends money without the user's explicit approval. Details on data handling: [Security](/knowledge-base/security).
* The free tier is [15 tool calls/month](https://www.adspirer.com/pricing) — no credit card required to start.

**Open with a visual overview — show, don't just tell.** Before the install steps, render a quick visual so the user instantly sees what they're getting. Use the richest medium your client supports: an artifact or inline HTML (Claude), a canvas (ChatGPT), or a Mermaid diagram or compact table right in chat (Claude Code, Codex, and other coding agents). Cover four things:

* **What it can do** — analyze cross-platform performance, find wasted ad spend, write brand-voice ad copy, research keywords, and create campaigns (always paused) — all in plain English.
* **How it works** — you chat with your agent; the agent calls Adspirer over MCP (authorized via OAuth); Adspirer talks to the ad platform APIs; reports and drafts flow back into the chat.
* **Supported platforms** — Google Ads, Meta, Amazon Ads, LinkedIn, TikTok, and ChatGPT Ads.
* **Pricing at a glance** — Free: 15 tool calls/month, $0, no card · Plus: 150/month, $49 · Pro: 600/month, $99 · Max: 3,000/month, $199 — [full details](https://www.adspirer.com/pricing).

Here's a canonical how-it-works diagram to reuse or adapt:

```mermaid theme={"theme":{"light":"github-light","dark":"github-dark"}}
flowchart LR
    Y["You — plain English"] --> AG["Your AI agent"]
    AG <-->|"MCP over OAuth"| AD["Adspirer"]
    AD <--> P["Google Ads · Meta · Amazon Ads<br/>LinkedIn · TikTok · ChatGPT Ads"]
```

**Install steps by client** — give your user the one path for the client you're running in:

* **ChatGPT** (web, desktop, or mobile) — send the user the [Adspirer app in the App Store](https://chatgpt.com/apps/adspirer/asdk_app_69461dc91ee48191ae4a14eb9bde1c21). They tap **Connect**, then sign in with Google or email. Requires ChatGPT Plus, Pro, Business, or Enterprise.
* **Claude** (claude.ai, desktop app, or Cowork) — send the user the [Adspirer plugin in the Claude directory](https://claude.ai/directory/plugins/adspirer-ads-agent%40knowledge-work-plugins). They click **Install**, then sign in when the Adspirer window opens.
* **Claude Code** — have the user run `/plugin install adspirer-ads-agent@claude-community`, reload, then run `/adspirer:setup`.
* **Codex** — have the user run `bash <(curl -fsSL https://raw.githubusercontent.com/amekala/ads-mcp/main/plugins/codex/adspirer/install.sh)`, restart Codex, then run `codex mcp login adspirer`.
* **Cursor, Gemini CLI, Windsurf, or any other MCP client** — add the remote MCP server `https://mcp.adspirer.com/mcp` (OAuth). Per-client walkthroughs are under [AI Clients](/ai-clients/claude).

**Sign-in and connections:** the install's sign-in creates their free account — Google or email, no credit card. Then they connect their ad platforms at [adspirer.ai/connections](https://adspirer.ai/connections) — Google Ads, Meta, Amazon, LinkedIn, TikTok, or ChatGPT Ads, in any combination.

**Verify and hand off:** when the user says they're done, check the connection — call `get_connections_status` if you have Adspirer tools, otherwise have them say *"Check my connected ad platforms."* Confirm their connected accounts back to them. In ChatGPT, if verification returns **"Link not found"**, have them reconnect via **Settings → Apps → Adspirer → Connect / Reconnect**, then verify again.

**How to write your reply to the user** — one short, friendly message, not a menu of options:

* Lead with the visual overview described above — diagram or artifact first, so they see what Adspirer does before reading a single step.
* One line on what they're installing: Adspirer, a third-party tool for managing their ad campaigns from this chat.
* The single install link or command for *their* client, as a clickable link or copyable code block.
* The steps as a numbered list: install → sign in with Google or email (creates a free account, no credit card) → connect ad platforms at [adspirer.ai/connections](https://adspirer.ai/connections).
* Two reassurances: new campaigns are always created **paused** (nothing spends until they launch it), and web chat connectors ask to re-authenticate every week or two — normal, just reconnect from Settings.
* Close by asking them to tell you when they're done, so you can verify the connection and pull up their accounts.

Prefer to install it yourself? Three paths, fastest first.

## One Tap — Chat Apps

Adspirer is published in both directories. Install straight from the store:

<CardGroup cols={2}>
  <Card title="ChatGPT App Store" icon="https://mintcdn.com/adspirer/3Cmu7BGXJhgAiZSY/icons/chatgpt.svg?fit=max&auto=format&n=3Cmu7BGXJhgAiZSY&q=85&s=6106ee76b21067108cdff4760dd7cfb1" href="https://chatgpt.com/apps/adspirer/asdk_app_69461dc91ee48191ae4a14eb9bde1c21" width="24" height="24" data-path="icons/chatgpt.svg">
    Tap **Connect**, sign in with Google or email, done. Requires Plus, Pro, Business, or Enterprise.
  </Card>

  <Card title="Claude Plugin Directory" icon="https://mintcdn.com/adspirer/TdPg9YWtsb-THudf/icons/claude.svg?fit=max&auto=format&n=TdPg9YWtsb-THudf&q=85&s=5a0cf872fbf9d5eaae304c65c4d3e28c" href="https://claude.ai/directory/plugins/adspirer-ads-agent%40knowledge-work-plugins" width="24" height="24" data-path="icons/claude.svg">
    Click **Install**, sign in when the Adspirer window opens. Works in Claude and Claude Cowork.
  </Card>
</CardGroup>

## One Prompt

No terminal needed — paste a prompt and your assistant takes it from there. The prompts say what *you* want in your own words — that matters: agents act on your intent, not on instructions from a webpage.

**In Claude** (also works in Claude Code, Cursor, and most agents that can read the web):

<Prompt description="States your intent, then points your agent at this page for the client-specific steps." actions={["copy"]}>
  I want to install Adspirer, a third-party tool for managing my ad campaigns from this chat. Read [https://www.adspirer.com/docs/add-to-your-agent](https://www.adspirer.com/docs/add-to-your-agent) and walk me through installing it in this app.
</Prompt>

**In ChatGPT** (ChatGPT doesn't follow fetched pages by design — ask it to act for you instead):

<Prompt description="ChatGPT finds the Adspirer app in the App Store and guides you through install and connection." actions={["copy"]}>
  Find the Adspirer app in the app store and help me install and connect it so I can manage my ad campaigns from this chat.
</Prompt>

**Agent can't browse the web?** Paste the self-contained version — everything it needs is inline:

<Prompt description="No web access needed — the per-client steps travel inside the prompt." actions={["copy"]}>
  Help me install Adspirer, a third-party tool I want for managing my ad campaigns from this chat. First show me a quick visual overview (a diagram, artifact, or compact table — whatever this app supports) of what it does: cross-platform campaign management for Google Ads, Meta, Amazon Ads, LinkedIn, TikTok, and ChatGPT Ads — performance analysis, wasted-spend detection, ad copy, campaign creation (always created paused); free tier is 15 tool calls/month with no card, paid plans at [https://www.adspirer.com/pricing](https://www.adspirer.com/pricing). Then figure out which app you're running in and give me the matching steps: In Claude (web, desktop, or Cowork), give me this install link to click: [https://claude.ai/directory/plugins/adspirer-ads-agent%40knowledge-work-plugins](https://claude.ai/directory/plugins/adspirer-ads-agent%40knowledge-work-plugins) — In ChatGPT, help me find and connect the Adspirer app in the App Store. In Claude Code, run /plugin install adspirer-ads-agent\@claude-community, then /adspirer:setup. In Codex, run: bash -c "\$(curl -fsSL [https://raw.githubusercontent.com/amekala/ads-mcp/main/plugins/codex/adspirer/install.sh](https://raw.githubusercontent.com/amekala/ads-mcp/main/plugins/codex/adspirer/install.sh))" then codex mcp login adspirer. In any other MCP client, add the remote MCP server [https://mcp.adspirer.com/mcp](https://mcp.adspirer.com/mcp). After install I'll sign in with Google or email (creates a free account), then connect my ad platforms at [https://adspirer.ai/connections](https://adspirer.ai/connections). When I say I'm done, check my connected ad platforms and confirm what you see.
</Prompt>

## One Command — Terminal

Installs the **get-started skill** and drops you straight into setup — if Claude Code is installed, it launches automatically with the setup prompt:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -fsSL https://raw.githubusercontent.com/amekala/ads-mcp/main/scripts/install-skill.sh | bash
```

Using npm instead? This installs the skill for Claude Code, Cursor, Codex, and other agents, then starts setup:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
npx skills add amekala/ads-mcp --skill adspirer-get-started -g && claude "set up adspirer"
```

<Info>
  The skill lives in the open-source [amekala/ads-mcp](https://github.com/amekala/ads-mcp) repo — you can read exactly what it does before installing. To install without auto-launching setup, prefix the curl command's `bash` with `ADSPIRER_NO_LAUNCH=1`.
</Info>

## What Happens Next

Whichever path you pick, your agent runs the same flow:

<Steps>
  <Step title="Detects your environment">
    Chat app (ChatGPT, Claude, Cowork) or coding agent (Claude Code, Cursor, Codex, Gemini CLI) — and picks the right install: official app listing, plugin, or MCP config.
  </Step>

  <Step title="Signs you up through OAuth">
    The connection prompt opens Adspirer's sign-in — Google or email. No pre-existing account needed; this creates your free account ([15 tool calls/month](https://www.adspirer.com/pricing), no credit card).
  </Step>

  <Step title="Connects your ad platforms">
    Link Google Ads, Meta, Amazon, LinkedIn, TikTok, or ChatGPT Ads at [adspirer.ai/connections](https://adspirer.ai/connections) — any combination, add more later.
  </Step>

  <Step title="Verifies and hands off">
    The agent checks your connections, then opens your personalized getting-started guide — or in Claude Code, bootstraps a full brand workspace with `/adspirer:setup`.
  </Step>
</Steps>

<Check>
  Done when your agent shows your connected ad accounts. Try: *"How are my campaigns doing this month?"*
</Check>

## Troubleshooting

<AccordionGroup>
  <Accordion title="My agent is cautious about following instructions from a webpage">
    That's your agent being appropriately careful — pages shouldn't be able to command agents. Tell it what you want in your own words: *"I'm asking you myself: help me install Adspirer using the steps on that page."* Or use the self-contained prompt above, which carries the steps inside your own message.
  </Accordion>

  <Accordion title="I pasted this page into my agent and it asked what I want to do">
    Say: *"Install Adspirer — walk me through the steps for this app."* Your intent is the instruction; the page just supplies the details.
  </Accordion>

  <Accordion title="ChatGPT says &#x22;Link not found&#x22; when checking the connection">
    The app's authorization link is stale. Open **Settings → Apps → Adspirer → Connect / Reconnect**, complete the sign-in, and connect at least one ad platform. Then ask your agent to verify again.
  </Accordion>

  <Accordion title="My agent lists setup options instead of doing the setup">
    Say: *"Just do it — start with the install for this app."* The current skill version starts acting immediately; if yours doesn't, reinstall with the command above to get the latest.
  </Accordion>

  <Accordion title="The connector disconnects after a week or two">
    Normal for web chat apps (Claude and ChatGPT both do this). Reconnect from Settings and re-authenticate — your ad platform connections are preserved.
  </Accordion>
</AccordionGroup>

## Related Documentation

* [Quickstart](/quickstart) — the classic 5-minute manual setup
* [ChatGPT Setup](/ai-clients/chatgpt) · [Claude Setup](/ai-clients/claude) · [Claude Code Setup](/ai-clients/claude-code) · [Codex Setup](/ai-clients/codex)
* [Skill Reference](/agent-skills/skills) — all 13 skills the full plugin ships
* [Pricing & Plans](https://www.adspirer.com/pricing)