Cursor Setup Guide

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

Prerequisites

Cursor IDE installed (v2.4+ recommended for subagent support)
git installed (used by the installer)
An Adspirer account (free to start)
At least one ad platform account: Google Ads, Meta Ads, LinkedIn Ads, or TikTok Ads

Setup

Quick Install (Recommended)
Manual Setup

Run this from your system terminal (Terminal.app, iTerm, Windows Terminal, etc.), not Cursor’s built-in terminal.

Run the Installer

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.

Restart Cursor

Close and reopen Cursor to load the new MCP config.

Authenticate with Adspirer

Open Cursor Settings > MCP
Find adspirer in the server list
Click on it to authenticate — a browser window opens for Adspirer login
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

Set Up Your Brand Workspace

Open your brand folder and switch to Agent mode (not Ask or Edit mode):

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

Try It Now

Sign up for Adspirer — free to start

10 free tool calls/month. No credit card required. Connect your ad accounts in 2 minutes.

Clone the Repo

git clone https://github.com/amekala/ads-mcp.git /tmp/ads-mcp
cd /tmp/ads-mcp/plugins/cursor/adspirer

Install Subagent and Skills

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/

Add the MCP Server

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "adspirer": {
      "url": "https://mcp.adspirer.com/mcp"
    }
  }
}

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

Copy Rules (Optional)

cd ~/Clients/YourBrand
mkdir -p .cursor/rules
cp /tmp/ads-mcp/plugins/cursor/adspirer/.cursor/rules/*.mdc .cursor/rules/

Restart and Authenticate

Restart Cursor. Open Cursor Settings > MCP, find adspirer, and click to authenticate via browser.

Set Up Your Brand Workspace

Open your brand folder, switch to Agent mode, and say:

set up my brand workspace

You’re connected. Cursor now has access to 100+ advertising tools with automatic workflow enforcement.

Available Skills

Skill	Invocation	What it Does
Adspirer Ads	`/adspirer-ads` or just ask naturally	Full campaign management — 100+ 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

100+ tools across 4 ad platforms, accessible from Cursor’s AI chat or inline editing:

Platform	Tools	Key Capabilities
Google Ads	39	Keyword research, Search & PMax campaigns, wasted spend analysis, budget optimization, search term reports, ad extensions
LinkedIn Ads	28	Sponsored content, B2B targeting (job titles, industries, company size), lead gen forms, creative analysis
Meta Ads	20	Image/video/carousel ads, audience targeting, placement optimization, creative fatigue detection
TikTok Ads	4	In-feed campaigns, asset validation, performance tracking

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

Google Search campaign for B2B with negative keyword suggestions.

Open in Cursor

Google PMax Campaign

PMax campaign for online courses with conversion tracking.

Open in Cursor

Meta Ads Creative Testing

Meta carousel campaign with per-card creative copy.

Open in Cursor

LinkedIn B2B Lead Gen

LinkedIn campaign targeting C-suite finance leaders.

Open in Cursor

Cross-Platform Performance Report

Multi-platform performance report with budget recommendations.

Open in Cursor

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:

Calls get_connections_status (verify you’re managing the right account)
Calls research_keywords with “running shoes” seed keywords
Shows you CPC data and keyword suggestions
Calls discover_existing_assets (check if you have images/headlines already)
Calls validate_and_prepare_assets (make sure assets meet Google’s requirements)
Calls create_search_campaign with validated data
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
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: 10/mo, Plus: 50, Pro: 100, Enterprise: unlimited)

FAQ

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.

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.

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.

How much does Adspirer cost?

Pricing is based on tool calls, not ad spend. Free tier: 10 calls/month. Plus:

25/mo for 50 calls. Pro:

75/mo for 100 calls. See full pricing details.

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.

Getting Started

AI Clients

Ad Platforms

Agent Skills

Resources

Cursor Setup Guide

Prerequisites

Setup

Sign up for Adspirer — free to start

Available Skills

What You Can Do

Example Prompts

Google Search Campaign

Google PMax Campaign

Meta Ads Creative Testing

LinkedIn B2B Lead Gen

Cross-Platform Performance Report

How Cursor Rules Improve Your Workflow

Before Rules:

After Rules:

Safety Features

Troubleshooting

FAQ

Getting Started

AI Clients

Ad Platforms

Agent Skills

Resources

​Prerequisites

​Setup

Sign up for Adspirer — free to start

​Available Skills

​What You Can Do

​Example Prompts

​Google Search Campaign

​Google PMax Campaign

​Meta Ads Creative Testing

​LinkedIn B2B Lead Gen

​Cross-Platform Performance Report

​How Cursor Rules Improve Your Workflow

​Before Rules:

​After Rules:

​Safety Features

​Troubleshooting

​FAQ

​Related Documentation

Prerequisites

Setup

Available Skills

What You Can Do

Example Prompts

Google Search Campaign

Google PMax Campaign

Meta Ads Creative Testing

LinkedIn B2B Lead Gen

Cross-Platform Performance Report

How Cursor Rules Improve Your Workflow

Before Rules:

After Rules:

Safety Features

Troubleshooting

FAQ

Related Documentation