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

# Connect Cursor to Ad Platforms | Adspirer

> Connect Cursor IDE to Adspirer MCP. Manage Google, Meta, Amazon, ChatGPT Ads, LinkedIn, and TikTok Ads from your editor with 400+ tools, 5 skills, and a marketing subagent.

Manage ads from your code editor. One command to install, 400+ tools, automatic workflow rules, zero context-switching.

## Prerequisites

<Note>
  * [Cursor IDE](https://cursor.com/) installed (v2.4+ recommended for subagent support)
  * [git](https://git-scm.com/) installed (used by the installer)
  * An Adspirer account ([free to start](https://adspirer.ai/sign-up?utm_source=docs\&utm_medium=page\&utm_content=signup))
  * At least one ad platform account: Google Ads, Meta Ads, Amazon Ads, ChatGPT Ads, LinkedIn Ads, or TikTok Ads
</Note>

## Setup

<Tabs>
  <Tab title="Quick Install (Recommended)">
    **Run this from your system terminal** (Terminal.app, iTerm, Windows Terminal, etc.), **not** Cursor's built-in terminal.

    <Steps>
      <Step title="Run the Installer">
        ```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)
        ```

        This installs the performance marketing subagent, all 5 skills, and the MCP server config automatically.
      </Step>

      <Step title="Restart Cursor">
        Close and reopen Cursor to load the new MCP config.
      </Step>

      <Step title="Authenticate with Adspirer">
        1. Open **Cursor Settings > MCP**
        2. Find `adspirer` in the server list
        3. Click on it to authenticate — a browser window opens for Adspirer login
        4. Sign in, authorize access, and return to Cursor

        If `adspirer` is missing, add it manually: **Cursor Settings > MCP > Add Server** with URL:

        ```
        https://mcp.adspirer.com/mcp
        ```
      </Step>

      <Step title="Set Up Your Brand Workspace">
        Open your brand folder and switch to **Agent mode** (not Ask or Edit mode):

        ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
        cd ~/Clients/YourBrand
        cursor .
        ```

        Then say:

        ```
        set up my brand workspace
        ```

        The agent will connect to your ad accounts, scan for brand docs, pull live campaign data, and create `BRAND.md`. If it doesn't trigger automatically, type: `/adspirer-setup`
      </Step>

      <Step title="Try It Now">
        <Card title="Sign up for Adspirer — free to start" icon="rocket" href="https://adspirer.ai/sign-up?utm_source=docs&utm_medium=setup-cta&utm_content=cursor" horizontal>
          15 free tool calls/month. No credit card required. Connect your ad accounts in 2 minutes.
        </Card>
      </Step>
    </Steps>
  </Tab>

  <Tab title="Manual Setup">
    <Steps>
      <Step title="Clone the Repo">
        ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
        git clone https://github.com/amekala/ads-mcp.git /tmp/ads-mcp
        cd /tmp/ads-mcp/plugins/cursor/adspirer
        ```
      </Step>

      <Step title="Install Subagent and Skills">
        ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
        mkdir -p ~/.cursor/agents ~/.cursor/skills
        cp .cursor/agents/performance-marketing-agent.md ~/.cursor/agents/
        cp -r .cursor/skills/adspirer-ads ~/.cursor/skills/
        cp -r .cursor/skills/adspirer-setup ~/.cursor/skills/
        cp -r .cursor/skills/adspirer-performance-review ~/.cursor/skills/
        cp -r .cursor/skills/adspirer-write-ad-copy ~/.cursor/skills/
        ```
      </Step>

      <Step title="Add the MCP Server">
        Add to `~/.cursor/mcp.json`:

        ```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
        {
          "mcpServers": {
            "adspirer": {
              "url": "https://mcp.adspirer.com/mcp"
            }
          }
        }
        ```

        Or use **Cursor Settings > MCP > Add Server** with URL `https://mcp.adspirer.com/mcp`.
      </Step>

      <Step title="Copy Rules (Optional)">
        ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
        cd ~/Clients/YourBrand
        mkdir -p .cursor/rules
        cp /tmp/ads-mcp/plugins/cursor/adspirer/.cursor/rules/*.mdc .cursor/rules/
        ```
      </Step>

      <Step title="Restart and Authenticate">
        Restart Cursor. Open **Cursor Settings > MCP**, find `adspirer`, and click to authenticate via browser.
      </Step>

      <Step title="Set Up Your Brand Workspace">
        Open your brand folder, switch to **Agent mode**, and say:

        ```
        set up my brand workspace
        ```
      </Step>
    </Steps>
  </Tab>
</Tabs>

<Check>
  You're connected. Cursor now has access to 400+ advertising tools with automatic workflow enforcement.
</Check>

## Available Skills

| Skill                  | Invocation                            | What it Does                                                        |
| ---------------------- | ------------------------------------- | ------------------------------------------------------------------- |
| **Adspirer Ads**       | `/adspirer-ads` or just ask naturally | Full campaign management — 400+ tools, all workflows, all platforms |
| **Setup**              | `/adspirer-setup`                     | Bootstrap a brand workspace (first-time or refresh)                 |
| **Performance Review** | `/adspirer-performance-review`        | Cross-platform performance scorecard                                |
| **Write Ad Copy**      | `/adspirer-write-ad-copy`             | Brand-voice ad copy from real data                                  |
| **Wasted Spend**       | `/adspirer-wasted-spend`              | Find and fix wasted ad spend                                        |

You don't need to remember skill names — just describe what you want and Cursor will match the right skill automatically.

## What You Can Do

400+ tools across 6 ad platforms, accessible from Cursor's AI chat or inline editing:

| Platform         | Tools | Key Capabilities                                                                                                          |
| ---------------- | ----- | ------------------------------------------------------------------------------------------------------------------------- |
| **Google Ads**   | 147   | Keyword research, Search & PMax campaigns, wasted spend analysis, budget optimization, search term reports, ad extensions |
| **Amazon Ads**   | 61    | Sponsored Products, Brands & Display, ASIN/keyword targeting, ACOS & ROAS analytics, budget recommendations               |
| **LinkedIn Ads** | 55    | Sponsored content, B2B targeting (job titles, industries, company size), lead gen forms, creative analysis                |
| **Meta Ads**     | 54    | Image/video/carousel ads, audience targeting, placement optimization, creative fatigue detection                          |
| **TikTok Ads**   | 37    | In-feed campaigns, asset validation, performance tracking                                                                 |
| **ChatGPT Ads**  | 31    | Pay-per-click chat-card ads inside ChatGPT responses, launch orchestrator, conversions (pixel + CAPI); created paused     |

Plus 8 automation tools for scheduling, monitoring, and cross-platform reporting.

## Example Prompts

What to actually say to Cursor once you're connected:

### Google Search Campaign

<Prompt description="Google Search campaign for B2B with negative keyword suggestions." actions={["copy", "cursor"]}>
  Create a Google Search campaign for my B2B software:

  * Product: cloud-based inventory management for restaurants
  * Target: restaurant owners and ops managers
  * Budget: \$75/day
  * Research keywords with real CPC data first
  * Suggest negative keywords to avoid irrelevant clicks
</Prompt>

### Google PMax Campaign

<Prompt description="PMax campaign for online courses with conversion tracking." actions={["copy", "cursor"]}>
  Build a Performance Max campaign for my online course:

  * Product: "Advanced Python for Data Science" course, \$199
  * Target ROAS: 300%
  * I have these image assets: \[paste URLs]
  * Write headlines and descriptions optimized for conversions
  * Set up conversion tracking for purchases
</Prompt>

### Meta Ads Creative Testing

<Prompt description="Meta carousel campaign with per-card creative copy." actions={["copy", "cursor"]}>
  Set up a Meta carousel campaign for my furniture store:

  * Products: 4 best-selling sofas ($800-$2,000 range)
  * Target: homeowners aged 28-45, interests in interior design and home decor
  * Budget: \$50/day
  * Image URLs: \[paste 4 URLs]
  * Write unique copy for each carousel card
  * Optimize for purchases
</Prompt>

### LinkedIn B2B Lead Gen

<Prompt description="LinkedIn campaign targeting C-suite finance leaders." actions={["copy", "cursor"]}>
  Create a LinkedIn campaign targeting CFOs and Finance Directors:

  * Company size: 200-5,000 employees
  * Industries: manufacturing, logistics, retail
  * Product: AP automation software
  * Budget: \$120/day
  * Goal: demo request sign-ups
  * Use this image: \[paste URL]
</Prompt>

### Cross-Platform Performance Report

<Prompt description="Multi-platform performance report with budget recommendations." actions={["copy", "cursor"]}>
  Pull performance data from all my connected platforms for the last 30 days.
  Create a markdown report with:

  * Executive summary with key metrics per platform
  * Top 3 campaigns by ROAS across all platforms
  * Wasted spend analysis (Google: zero-conversion keywords, Meta: fatigued creatives)
  * Budget reallocation recommendations for next month
</Prompt>

## How Cursor Rules Improve Your Workflow

If you installed the Cursor Rule (included in both the one-command installer and manual install), here's what changes:

### Before Rules:

**You:** "Create a Google Ads campaign for running shoes"

**Cursor:** Immediately calls `create_search_campaign` with generic parameters — fails because no keyword research, no asset validation.

### After Rules:

**You:** "Create a Google Ads campaign for running shoes"

**Cursor:** Automatically follows the workflow:

1. Calls `get_connections_status` (verify you're managing the right account)
2. Calls `research_keywords` with "running shoes" seed keywords
3. Shows you CPC data and keyword suggestions
4. Calls `discover_existing_assets` (check if you have images/headlines already)
5. Calls `validate_and_prepare_assets` (make sure assets meet Google's requirements)
6. Calls `create_search_campaign` with validated data
7. **Asks for your confirmation** before actually creating the campaign

Rules turn one vague prompt into a complete, validated workflow. You still control the final decision — nothing launches without your approval.

## Safety Features

* **All campaigns created PAUSED:** Review before they spend money
* **User confirmation required:** Cursor asks before any write action
* **Read-before-write enforcement:** Skills prevent campaign creation without research
* **Connection checks:** Always verifies you're managing the correct account first
* **No automatic retries:** If something fails, Cursor waits for your input instead of retrying blindly

## Troubleshooting

| Problem                                   | Solution                                                                                       |
| ----------------------------------------- | ---------------------------------------------------------------------------------------------- |
| Install fails with permission/hooks error | Run the install from your **system terminal**, not Cursor's built-in terminal (it's sandboxed) |
| MCP server not showing                    | Open Cursor Settings > MCP > Add server with URL `https://mcp.adspirer.com/mcp`                |
| MCP connection error                      | Click the server in Settings > MCP to re-authenticate via browser                              |
| Authentication failed                     | Remove and re-add the MCP server in Cursor Settings                                            |
| OAuth window doesn't open                 | Check browser pop-up blocker. Try restarting Cursor.                                           |
| No ad platforms connected                 | Connect platforms at [adspirer.com](https://www.adspirer.com)                                  |
| Skills not showing                        | Verify: `ls ~/.cursor/skills/` — should show `adspirer-*` directories                          |
| Subagent not triggering                   | Ensure you're in **Agent mode** (not Ask or Edit). Try `/adspirer-setup` directly.             |
| No data returned                          | Check for active campaigns. Try longer lookback (60/90 days)                                   |
| Rate limit hit                            | Check Adspirer tier (Free: 15/mo, Plus: 150, Pro: 600, Max: 3,000)                             |

## FAQ

<AccordionGroup>
  <Accordion title="What's the difference between global and per-project config?">
    **Global (`~/.cursor/mcp.json`):** Adspirer works in every Cursor project. Use this if you manage ads regularly.

    **Per-project (`.cursor/mcp.json`):** Adspirer only works in that specific project. Use this if you're working on a client's codebase and want ad management tools only for that client.
  </Accordion>

  <Accordion title="Can I use Adspirer with Cursor Composer?">
    Yes. Cursor Composer (multi-file editing mode) has full access to Adspirer tools. You can ask Composer to analyze campaigns, generate reports, and save the output as markdown files in your project — all in one flow.
  </Accordion>

  <Accordion title="Do I need both Skills and Cursor Rules?">
    No, but they complement each other. Skills teach Cursor *how* to use the tools. Cursor Rules enforce *when* and *why* to use them. The one-command installer includes both.
  </Accordion>

  <Accordion title="How much does Adspirer cost?">
    Pricing is based on tool calls, not ad spend. Free tier: 15 calls/month. Plus: $49/mo for 150 calls. Pro: $99/mo for 600 calls. Max: \$199/mo for 3,000 calls. See [full pricing details](https://www.adspirer.com/pricing).
  </Accordion>

  <Accordion title="Can I manage multiple ad accounts?">
    Yes. Connect multiple Google Ads accounts, multiple Meta Business Managers, etc. Use the `switch_primary_account` tool to change which account you're managing, or specify the account ID in your prompts.
  </Accordion>
</AccordionGroup>

## Related Documentation

* [Claude Code Setup Guide](/ai-clients/claude-code)
* [Google Ads Integration Guide](/ad-platforms/google-ads)
* [Google Ads + Adspirer Integration](https://www.adspirer.com/integrations/google-ads)
* [Pricing & Plans](https://www.adspirer.com/pricing)
* [All Documentation](/introduction)