adspirer-ads-agent

Ads MCP

Remote Model Context Protocol (MCP) server for cross-platform ad management. Create, analyze, and optimize campaigns across Google Ads, Meta Ads, TikTok Ads, and LinkedIn Ads from any MCP-compatible AI assistant.

Quick Links

• MCP Remote URL: https://mcp.adspirer.com/mcp
• Transport: Streamable HTTP
• Registry ID: com.adspirer/ads
• Authentication: OAuth 2.1 with PKCE (dynamic client registration supported)
• Website: https://www.adspirer.com
• Support: [email protected]

What It Does

• Strategy-aware execution — strategic decisions persist to STRATEGY.md and guide all future campaign creation, keyword research, and ad copy across sessions and subagents
• 175+ tools across 4 ad platforms for campaign creation, performance analysis, and optimization
• Plan and validate campaigns using structured prompts
• Research keywords with real CPC data and competitive analysis
• Create Google Ads Search, Performance Max (with search themes + audience signals), Display (Standard + Smart), Demand Gen, and YouTube campaigns end-to-end
• Launch Meta image / video / carousel / OUTCOME_LEADS campaigns, LinkedIn sponsored content / carousel / lead-gen forms with campaign groups, and TikTok in-feed / Spark Ads / Carousel / App Promotion campaigns
• Analyze performance with actionable optimization recommendations — wasted spend, anomaly detection, audience insights, creative fatigue
• Raw data mode (raw_data=true) on all 29 performance/analytics tools — JSON-only output for your own attribution, dashboards, or token-efficient pipelines
• Multi-account, multi-platform — agencies can manage many ad accounts per platform from one workspace
• Automation — scheduled briefs, performance monitors, on-demand cross-platform reports across all four platforms

Platforms & Tools

Platform	Tools	Capabilities
Google Ads	75+	Search, Performance Max (with search themes + audience signals), Display (Standard + Smart), Demand Gen, YouTube; keyword research, performance analysis, wasted-spend, asset management, ad extensions (sitelinks / callouts / structured snippets), bidding strategy management
LinkedIn Ads	45	Sponsored content (single-image, video, carousel), lead-gen forms, campaign groups, 14 targeting facets, audience insights, creative fatigue analysis, conversion tracking, organizations
Meta Ads	36	Image / video / carousel campaigns, OUTCOME_LEADS lead-gen forms, lifetime budgets, granular placements (Feed / Stories / Reels), city-level targeting, custom audiences, custom conversions, Advantage+ controls
TikTok Ads	31	In-feed video / image / Spark Ads / Carousel / App Promotion campaigns, full lifecycle (list / get / pause / resume / update for campaigns, ad groups, ads), 8 analytics tools (performance, wasted spend, audience insights, creative fatigue, anomaly detection, geo)
Total	175+	Plus monitoring, automation (scheduled briefs / monitors / reports), and account management tools — all available over MCP and as REST endpoints at api.adspirer.ai

How to Connect

See CONNECTING.md for detailed setup instructions for each platform.

Claude (Recommended)

1. Open Settings > Connectors > Add custom connector
2. Name: Ads MCP
3. URL: https://mcp.adspirer.com/mcp
4. Complete OAuth 2.1 sign-in
5. Link your ad accounts on first use

Claude Code

Install the full Adspirer plugin (agent + skills + commands + MCP server):

1. Open Claude Code
2. Run /plugin marketplace add amekala/ads-mcp
3. Run /plugin install adspirer
4. Run /mcp — find plugin:adspirer:adspirer and click to authenticate
5. Run /adspirer:setup to pull your campaign data and create your brand workspace

This gives you a brand-aware performance marketing agent with persistent memory, competitive research via web search, campaign creation with ad extensions, and slash commands for common workflows. Enabling subagent usage does not change this installation flow.

MCP-only (no plugin): If you just want the raw MCP tools without the agent:

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

ChatGPT

1. Open Settings > Connectors > Add custom connector
2. Name: Ads MCP
3. URL: https://mcp.adspirer.com/mcp
4. Follow OAuth 2.1 sign-in flow

Cursor

Add to ~/.cursor/mcp.json:

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

OpenAI Codex

Add to ~/.codex/config.toml:

[mcp_servers.adspirer]
url = "https://mcp.adspirer.com/mcp"

Gemini CLI

Install as an extension:

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