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

# Quickstart: Set Up Adspirer MCP in 5 Minutes

> Get started with Adspirer in under 5 minutes: sign up, connect your AI client, link an ad platform, and run your first ad campaign query.

<Steps>
  <Step title="Sign Up">
    Create your free Adspirer account at [adspirer.ai](https://adspirer.ai?utm_source=docs\&utm_medium=page\&utm_content=signup). No credit card required — free tier includes 15 tool calls per month.
  </Step>

  <Step title="Connect Your AI Client">
    Pick your AI assistant and follow the setup guide:

    **Chat Apps**

    <CardGroup cols={2}>
      <Card title="ChatGPT" icon="https://mintcdn.com/adspirer/3Cmu7BGXJhgAiZSY/icons/chatgpt.svg?fit=max&auto=format&n=3Cmu7BGXJhgAiZSY&q=85&s=6106ee76b21067108cdff4760dd7cfb1" href="/ai-clients/chatgpt" width="24" height="24" data-path="icons/chatgpt.svg">
        Install the Adspirer app from the ChatGPT App Store. Requires Plus or Pro.
      </Card>

      <Card title="Claude" icon="https://mintcdn.com/adspirer/TdPg9YWtsb-THudf/icons/claude.svg?fit=max&auto=format&n=TdPg9YWtsb-THudf&q=85&s=5a0cf872fbf9d5eaae304c65c4d3e28c" href="/ai-clients/claude" width="24" height="24" data-path="icons/claude.svg">
        Add the MCP connector in Claude Settings. Requires Pro, Max, Team, or Enterprise.
      </Card>
    </CardGroup>

    **Developer Tools**

    <CardGroup cols={2}>
      <Card title="Claude Code" icon="https://mintcdn.com/adspirer/TdPg9YWtsb-THudf/icons/claude-code.svg?fit=max&auto=format&n=TdPg9YWtsb-THudf&q=85&s=4873968842d36554bb6a8d15c886e00d" href="/ai-clients/claude-code" width="24" height="24" data-path="icons/claude-code.svg">
        One-command plugin install from your terminal.
      </Card>

      <Card title="Gemini CLI" icon="https://mintcdn.com/adspirer/3OjfThfXkO753jUS/icons/gemini.svg?fit=max&auto=format&n=3OjfThfXkO753jUS&q=85&s=3415ee990e815a422f4f6dd50eb96ac8" href="/ai-clients/gemini-cli" width="24" height="24" data-path="icons/gemini.svg">
        One-command extension install from your terminal.
      </Card>

      <Card title="Cursor" icon="https://mintcdn.com/adspirer/3Cmu7BGXJhgAiZSY/icons/cursor.svg?fit=max&auto=format&n=3Cmu7BGXJhgAiZSY&q=85&s=fc2d5972cbda895e87b17aba40dcd1f1" href="/ai-clients/cursor" width="24" height="24" data-path="icons/cursor.svg">
        One-command installer with 5 skills and subagent.
      </Card>

      <Card title="Codex" icon="https://mintcdn.com/adspirer/d1-3M_DPxPhMWBSu/icons/codex.svg?fit=max&auto=format&n=d1-3M_DPxPhMWBSu&q=85&s=b31cb81882fba09f78a7d90639f6c97a" href="/ai-clients/codex" width="24" height="24" data-path="icons/codex.svg">
        One-command installer for autonomous agent setup.
      </Card>

      <Card title="OpenClaw" icon="https://mintcdn.com/adspirer/TdPg9YWtsb-THudf/icons/openclaw.svg?fit=max&auto=format&n=TdPg9YWtsb-THudf&q=85&s=507164157fe5912c1dae95a190a65267" href="/ai-clients/openclaw" width="24" height="24" data-path="icons/openclaw.svg">
        Plugin install with 14KB skill file built in.
      </Card>

      <Card title="Windsurf" icon="https://mintcdn.com/adspirer/3Cmu7BGXJhgAiZSY/icons/windsurf.svg?fit=max&auto=format&n=3Cmu7BGXJhgAiZSY&q=85&s=dc8feecaa6bf135782d4fd9d7703929e" href="/ai-clients/windsurf" width="24" height="24" data-path="icons/windsurf.svg">
        Add MCP config to Windsurf settings.
      </Card>

      <Card title="Perplexity" icon="https://mintcdn.com/adspirer/TdPg9YWtsb-THudf/icons/perplexity.svg?fit=max&auto=format&n=TdPg9YWtsb-THudf&q=85&s=e1ee0859a3ade5ea84a9a9d5df37e6c5" href="/ai-clients/perplexity" width="24" height="24" data-path="icons/perplexity.svg">
        Add custom connector in Perplexity Computer.
      </Card>
    </CardGroup>

    **Quick MCP Config Reference**

    <Tabs>
      <Tab title="Claude Code">
        ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
        /plugin install adspirer-ads-agent@claude-community
        ```

        Anthropic community marketplace, enabled by default, no setup needed. Bundles the MCP connector with slash commands, skills, and an agent.
      </Tab>

      <Tab title="Cursor">
        ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
        bash <(curl -fsSL https://raw.githubusercontent.com/amekala/ads-mcp/main/plugins/cursor/adspirer/install.sh)
        ```

        Run from your **system terminal**, not Cursor's built-in terminal. Then restart Cursor.
      </Tab>

      <Tab title="Codex">
        ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
        codex plugin marketplace add amekala/ads-mcp
        ```

        Then inside Codex run `/plugins` → **Adspirer** tab → install **Adspirer Ads Agent**. OAuth runs on first use.
      </Tab>

      <Tab title="OpenClaw">
        ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
        openclaw plugins install openclaw-adspirer
        openclaw adspirer login
        ```
      </Tab>

      <Tab title="Gemini CLI">
        ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
        gemini extensions install https://github.com/amekala/ads-mcp
        ```

        Browser opens automatically for OAuth on first tool use.
      </Tab>

      <Tab title="Windsurf">
        Add to `~/.codeium/windsurf/mcp_config.json`:

        ```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
        {
          "mcpServers": {
            "adspirer": {
              "type": "streamable-http",
              "url": "https://mcp.adspirer.com/mcp"
            }
          }
        }
        ```
      </Tab>

      <Tab title="Perplexity">
        In Perplexity Computer, click **Connectors** → **+ Custom connector** and enter:

        | Field              | Value                          |
        | ------------------ | ------------------------------ |
        | **Name**           | `Adspirer`                     |
        | **MCP Server URL** | `https://mcp.adspirer.com/mcp` |

        Check the acknowledgment box and click **Add**, then complete OAuth.
      </Tab>

      <Tab title="ChatGPT">
        No config needed — open **Apps** in ChatGPT, search **"Adspirer,"** and click **Connect**. ([App Store setup guide](/ai-clients/chatgpt))
      </Tab>

      <Tab title="Claude">
        No config needed — add the MCP connector from Claude's Settings page:

        **MCP Server URL:** `https://mcp.adspirer.com/mcp`
      </Tab>
    </Tabs>
  </Step>

  <Step title="Connect an Ad Platform">
    Link your advertising accounts. You can connect multiple platforms:

    <CardGroup cols={2}>
      <Card title="Google Ads" icon="https://mintcdn.com/adspirer/TdPg9YWtsb-THudf/icons/google-ads.svg?fit=max&auto=format&n=TdPg9YWtsb-THudf&q=85&s=523927ffe08f8a180fe35b7cdd522541" href="/ad-platforms/google-ads" width="24" height="24" data-path="icons/google-ads.svg">
        147 tools for Search, PMax, Shopping & App campaigns, keyword research, budget optimization.
      </Card>

      <Card title="Meta Ads" icon="https://mintcdn.com/adspirer/TdPg9YWtsb-THudf/icons/meta.svg?fit=max&auto=format&n=TdPg9YWtsb-THudf&q=85&s=3d0d90257e6e8b1d7b22b4ad6ea959b8" href="/ad-platforms/meta-ads" width="24" height="24" data-path="icons/meta.svg">
        54 tools for Facebook & Instagram campaigns, Advantage+ Catalog (dynamic product ads), creative testing.
      </Card>

      <Card title="Amazon Ads" icon="https://mintcdn.com/adspirer/tm56ipPRpt0nhwwQ/icons/amazon.svg?fit=max&auto=format&n=tm56ipPRpt0nhwwQ&q=85&s=1931358385448531df132fa40cc27ea9" href="/ad-platforms/amazon-ads" width="251" height="260" data-path="icons/amazon.svg">
        61 tools for Sponsored Products, Brands & Display, ASIN targeting, ACOS/ROAS.
      </Card>

      <Card title="ChatGPT Ads" icon="https://mintcdn.com/adspirer/tm56ipPRpt0nhwwQ/icons/openai.svg?fit=max&auto=format&n=tm56ipPRpt0nhwwQ&q=85&s=5392e998e6c23bb558c633f50ba4d629" href="/ad-platforms/chatgpt-ads" width="24" height="24" data-path="icons/openai.svg">
        31 tools for pay-per-click chat-card ads inside ChatGPT, created paused.
      </Card>

      <Card title="LinkedIn Ads" icon="https://mintcdn.com/adspirer/vhaKM86uNtBGo98V/icons/linkedin.svg?fit=max&auto=format&n=vhaKM86uNtBGo98V&q=85&s=59bacb73f680a3ecf7df34306ad2ba04" href="/ad-platforms/linkedin-ads" width="123" height="122" data-path="icons/linkedin.svg">
        55 tools for B2B advertising, video & carousel, campaign groups, audience forecasting.
      </Card>

      <Card title="TikTok Ads" icon="https://mintcdn.com/adspirer/vhaKM86uNtBGo98V/icons/tiktok.svg?fit=max&auto=format&n=vhaKM86uNtBGo98V&q=85&s=a76c6259ebbd339771558f26cf72baac" href="/ad-platforms/tiktok-ads" width="461" height="512" data-path="icons/tiktok.svg">
        37 tools for in-feed video, Spark Ads, and Carousel campaigns.
      </Card>
    </CardGroup>
  </Step>

  <Step title="Try It Out">
    Once connected, ask your AI assistant:

    <Prompt description="Verify your ad platform connections are working." actions={["copy", "cursor"]}>
      Check my connected ad platforms
    </Prompt>

    You should see a table showing your connected accounts with IDs, names, and connection status.

    Then try something real:

    <Prompt description="Research keywords with real CPC data from Google Keyword Planner." actions={["copy", "cursor"]}>
      Research Google Ads keywords for "project management software" — show search volume, CPC, and competition level
    </Prompt>
  </Step>
</Steps>

## What's Next?

<CardGroup cols={2}>
  <Card title="Agent Skills" icon="brain" href="/agent-skills/overview">
    Install skills to teach your AI assistant proven ad management workflows with safety rules.
  </Card>

  <Card title="Tool Catalog" icon="wrench" href="/agent-skills/tools">
    Browse all 400+ tools organized by platform.
  </Card>
</CardGroup>
