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.

1. Sign Up

   Create your free Adspirer account at adspirer.ai. No credit card required — free tier includes 15 tool calls per month.

2. Connect Your AI Client

   Pick your AI assistant and follow the setup guide:

   Chat Apps

   

   ChatGPT

   Install the Adspirer app from the ChatGPT App Store. Requires Plus or Pro.

   

   Claude

   Add the MCP connector in Claude Settings. Requires Pro, Max, Team, or Enterprise.

   Developer Tools

   

   Claude Code

   Plugin install or one MCP command from your terminal.

   

   Gemini CLI

   One-command extension install from your terminal.

   

   Cursor

   One-command installer with 5 skills and subagent.

   

   Codex

   One-command installer for autonomous agent setup.

   

   OpenClaw

   Plugin install with 14KB skill file built in.

   

   Windsurf

   Add MCP config to Windsurf settings.

   

   Perplexity

   Add custom connector in Perplexity Computer.

   Quick MCP Config Reference

   Claude Code

   claude mcp add --transport http adspirer https://mcp.adspirer.com/mcp
   

   Or use the plugin system: /plugin install adspirer-ads-agent@claude-plugins-official (official Anthropic marketplace — no setup needed)

   Cursor

   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.

   Codex

   codex plugin marketplace add amekala/ads-mcp
   

   Then inside Codex run /plugins → Adspirer tab → install Adspirer Ads Agent. OAuth runs on first use.

   OpenClaw

   openclaw plugins install openclaw-adspirer
   openclaw adspirer login
   

   Gemini CLI

   gemini extensions install https://github.com/amekala/ads-mcp
   

   Browser opens automatically for OAuth on first tool use.

   Windsurf

   Add to ~/.codeium/windsurf/mcp_config.json:

   {
     "mcpServers": {
       "adspirer": {
         "type": "streamable-http",
         "url": "https://mcp.adspirer.com/mcp"
       }
     }
   }
   

   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.

   ChatGPT

   No config needed — open Apps in ChatGPT, search “Adspirer,” and click Connect. (App Store setup guide)

   Claude

   No config needed — add the MCP connector from Claude’s Settings page:

   MCP Server URL: https://mcp.adspirer.com/mcp

3. Connect an Ad Platform

   Link your advertising accounts. You can connect multiple platforms:

   

   Google Ads

   95 tools for Search & PMax campaigns, keyword research, budget optimization.

   

   Meta Ads

   37 tools for Facebook & Instagram campaigns, creative testing.

   

   Amazon Ads

   61 tools for Sponsored Products, Brands & Display, ASIN targeting, ACOS/ROAS.

   

   ChatGPT Ads

   31 tools for pay-per-click chat-card ads inside ChatGPT, created paused.

   

   LinkedIn Ads

   45 tools for B2B advertising, lead gen forms, sponsored content.

   

   TikTok Ads

   37 tools for in-feed video, Spark Ads, and Carousel campaigns.

4. Try It Out

   Once connected, ask your AI assistant:

   Verify your ad platform connections are working.

   CopiedCopy promptOpen in Cursor

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

   Then try something real:

   Research keywords with real CPC data from Google Keyword Planner.

   CopiedCopy promptOpen in Cursor

What’s Next?

Agent Skills

Install skills to teach your AI assistant proven ad management workflows with safety rules.

Tool Catalog

Browse all 340+ tools organized by platform.