Skip to content
/ ads-mcp Public

MCP server for managing ad campaigns across Google Ads, Meta Ads, LinkedIn Ads, and TikTok Ads. 100+ tools for campaign creation, performance analysis, keyword research, and budget optimization. Works with Claude Code, Cursor, Codex, ChatGPT, Windsurf, and Cline.

8 stars 1 fork Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

amekala/ads-mcp

BranchesTags

Repository files navigation

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

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
  • 100+ 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 and Performance Max campaigns end-to-end
  • Launch Meta, TikTok, and LinkedIn ad campaigns
  • Analyze performance with actionable optimization recommendations
  • Manage multiple ad accounts across platforms

Platforms & Tools

Platform Tools Capabilities
Google Ads 39 Search campaigns, Performance Max, keyword research, performance analysis, asset management, ad extensions
LinkedIn Ads 28 Sponsored content, lead gen forms, audience targeting, campaign analytics
Meta Ads 20 Image campaigns, carousel campaigns, audience targeting, performance tracking
TikTok Ads 4 In-feed video/image campaigns, asset validation
Total 100+ Plus 2 resources and 6 prompts

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"

OpenClaw

openclaw plugins install openclaw-adspirer
openclaw adspirer login
openclaw adspirer connect

Or install from ClawHub.

Example Prompts

Keyword Research:

Research keywords for my emergency plumbing business in Chicago.
Show me high-intent keywords with real CPC data and budget recommendations.

Performance Analysis:

Show me campaign performance for the last 30 days across all platforms.
Which campaigns are converting best and what should I optimize?

Campaign Creation:

Create a Google Performance Max campaign for luxury watches targeting
New York with a $50/day budget.

Multi-Platform Strategy:

I want to advertise my handmade jewelry business across Google and LinkedIn.
Research keywords for Google Ads and create a LinkedIn sponsored content campaign
targeting small business owners.

Technical Details

  • Protocol: MCP 2025-03-26 (with fallback to 2024-11-05)
  • Transport: Streamable HTTP
  • OAuth: RFC 8252 (Authorization Code + PKCE) with RFC 7591 (Dynamic Client Registration) and RFC 9728 (Protected Resource Metadata)
  • Tool Annotations: All tools include MCP safety metadata (readOnlyHint, destructiveHint)

Security

  • HTTPS/TLS for all data transmission
  • OAuth 2.1 with PKCE for authentication
  • Dynamic client registration for CLI tools (Claude Code, Cursor, Codex)
  • Encrypted token storage
  • No conversation logging -- only tool requests are processed

See SECURITY.md for vulnerability reporting.

Documentation

Support

Supported Plugins

This repo distributes plugins for 4 AI platforms from a single monorepo:

Platform Directory Skills Install Method
Claude Code Repo root 1 generated + 5 slash commands /plugin marketplace add
Cursor plugins/cursor/adspirer/ 5 generated from templates install.sh (one-command)
Codex plugins/codex/adspirer/ 5 generated from templates install.sh (one-command)
OpenClaw plugins/openclaw/ 1 standalone (self-contained) openclaw plugins install

Skills for Claude Code, Cursor, and Codex are authored once in shared/skills/ as templates, then compiled into IDE-specific versions by scripts/sync-skills.sh. The performance marketing agent prompt is also authored once in shared/agents/performance-marketing-agent/PROMPT.md and compiled into Claude Code, Cursor, and Codex agent files by the same sync script. OpenClaw uses its own standalone skill. See Architecture for the full design.

Shared Update Wireframe

Edit once (source of truth)
  ├─ shared/skills/adspirer-*/SKILL.md
  └─ shared/agents/performance-marketing-agent/PROMPT.md
                |
                v
        ./scripts/sync-skills.sh
                |
                +--> Claude Code outputs
                |     ├─ skills/ad-campaign-management/SKILL.md
                |     └─ agents/performance-marketing-agent.md
                |
                +--> Cursor outputs
                |     ├─ plugins/cursor/adspirer/.cursor/skills/adspirer-*/SKILL.md
                |     └─ plugins/cursor/adspirer/.cursor/agents/performance-marketing-agent.md
                |
                +--> Codex outputs
                |     ├─ plugins/codex/adspirer/skills/adspirer-*/SKILL.md
                |     └─ plugins/codex/adspirer/agents/performance-marketing-agent.toml
                |
                └--> OpenClaw (standalone, not generated)
                      └─ plugins/openclaw/SKILL.md

Client Roots and Install Targets

AI Client Repo Source Root Generated/Runtime Root in Repo User Installation Path/Method
Claude Code Repo root + shared/skills/ + shared/agents/ skills/, agents/, commands/, .claude-plugin/ /plugin marketplace add amekala/ads-mcp then /plugin install adspirer
Cursor plugins/cursor/adspirer/ + shared sources plugins/cursor/adspirer/.cursor/skills/, plugins/cursor/adspirer/.cursor/agents/ bash <(curl -fsSL https://raw.githubusercontent.com/amekala/ads-mcp/main/plugins/cursor/adspirer/install.sh)
Codex plugins/codex/adspirer/ + shared sources plugins/codex/adspirer/skills/, plugins/codex/adspirer/agents/ bash <(curl -fsSL https://raw.githubusercontent.com/amekala/ads-mcp/main/plugins/codex/adspirer/install.sh)
OpenClaw plugins/openclaw/ plugins/openclaw/ (standalone, no sync generation) openclaw plugins install openclaw-adspirer

Developer Guide

If you're contributing to this repo or adding new ad platforms/IDE support:

Quick reference

./scripts/sync-skills.sh          # Generate IDE-specific skills from templates
./scripts/sync-skills.sh --check  # Verify generated files match committed (CI mode)
./scripts/validate.sh             # Run all 48 offline validation checks
./scripts/validate.sh --live      # Also test MCP endpoint connectivity

Never edit files in plugins/*/skills/, skills/, agents/, or plugins/*/agents/ directly — they will be overwritten by the sync script. Edit templates in shared/skills/ and shared prompts in shared/agents/ instead.

License

Proprietary -- See Terms of Service for usage terms.

About

MCP server for managing ad campaigns across Google Ads, Meta Ads, LinkedIn Ads, and TikTok Ads. 100+ tools for campaign creation, performance analysis, keyword research, and budget optimization. Works with Claude Code, Cursor, Codex, ChatGPT, Windsurf, and Cline.

Topics

mcp cursor advertising codex cline claude google-ads windsurf tiktok-ads ai-agent meta-ads chatgpt model-context-protocol mcp-server linkedin-ads

Resources

Readme

Security policy

Security policy
Activity

Stars

8 stars

Watchers

0 watching

Forks

1 fork
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages