Quickstart

Get started with Adspirer in under 5 minutes. Sign up, connect your AI client (ChatGPT, Claude, Claude Code, Gemini CLI, Cursor, Codex, OpenClaw, Windsurf, or Perplexity), link an ad platform, and run your first 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

   Add the MCP connector in ChatGPT Settings. 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.

   

   Custom GPT

   Use Adspirer inside ChatGPT via the GPT Store.

   Quick MCP Config Reference

   Claude Code

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

   Or use the plugin system: /plugin marketplace add amekala/ads-mcp then /plugin install adspirer

   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

   bash <(curl -fsSL https://raw.githubusercontent.com/amekala/ads-mcp/main/plugins/codex/adspirer/install.sh)
   

   Then run codex mcp login adspirer to authenticate.

   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 / Claude

   No config needed — add the MCP connector from your app’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

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

   

   Meta Ads

   20 tools for Facebook & Instagram campaigns, creative testing.

   

   LinkedIn Ads

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

   

   TikTok Ads

   4 tools for in-feed video 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 100+ tools organized by platform.