Paid Media Manager
Google Ads search campaigns, planned with your AI agent and built by you.
An MCP plugin that walks your AI agent through a 10-step guided journey toward Google Ads search campaigns. Your credentials stay on the KeyRing, and a read-only live check verifies your account setup. Turning on spend is your call.
Requires CoreforgedMCP gateway (free). Google Ads account, a Google Cloud project with the Google Ads API enabled, and a Desktop OAuth client required.
How It Works
Secure your credentials, walk the guided journey with your agent, and build campaigns from what the journey produces.
Secure Your Credentials
Your Google OAuth credentials go onto the KeyRing and never enter the chat or a config file. Its status and setup checks show account IDs masked.
Walk the Guided Journey
Your agent reads your codebase for context, asks Discovery questions, verifies your setup against the Google Ads API, and walks you through 10 steps from Discovery to Launch.
You Build the Campaigns
The journey produces keyword groups, ad copy, and a launch plan. You build each campaign in Google Ads, save it as an unpublished draft, review, and decide when to publish.
Six Tools
Paid Media Manager 0.3.0 gives your agent six tools. It needs coreforged-mcp 1.4.0 or later.
pmm_statusStatus Check
Check setup: each Google Ads credential's KeyRing state, the refresh token's expiry, and the pinned Google Ads API version.
pmm_verify_setupLive Verification
Live check against the Google Ads API: accessible customers, the manager link when there is one, and the Cloud project's API access level.
pmm_google_ads_requestRead Request
Make one read-only Google Ads request through the KeyRing with Paid Media Manager's own credentials: list your accessible accounts, or run a Google Ads query. Google's data comes back as Google sends it, customer IDs included.
pmm_journey_statusJourney Progress
Check guided setup progress: current phase, its journey file, and what's left.
pmm_journey_discoverDiscovery
Record the Discovery answers and set the journey's paths.
pmm_journey_advanceAdvance Step
Mark a setup step complete once its dependencies, discovery answers and proof are in place.
What's Under the Hood
KeyRing-Secured Credentials
Your Google OAuth credentials stay on the KeyRing and never enter your AI conversation or a tool result. Its status and setup checks show account IDs masked, and a read request returns Google's data as Google sends it.
Read-Only in This Version
Paid Media Manager's tools only read your Google Ads account, and the KeyRing refuses every Google Ads change. Every change to your campaigns is yours to make.
10-Step Guided Journey
A locked-gate state machine walks you from Discovery through Launch. A step opens only once the steps it depends on are done, so you can't skip ahead.
Search First, Measured on Revenue
New accounts start with Google Search campaigns. Success is judged on conversions and revenue, not clicks or impressions.
Works with Digital Analytics Manager
With Digital Analytics Manager installed, conversion tracking runs through it, and your GA4 conversions flow into your Google Ads account.
Learn more →Who Is This For?
Before You Start
Your Agent Needs
You'll Handle (Human-Only)
How It Fits Together
CoreforgedMCP Gateway (free)
├── KeyRing Plugin (free, bundled)
│ └── Manages Google Ads API credentials
│
├── Digital Analytics Plugin ($249)
│ └── GA4, Search Console, PageSpeed
│ └── Conversion tracking for your ads
│
└── Paid Media Manager Plugin ($249)
├── pmm_status — credential & API check
├── pmm_verify_setup — live Google Ads verification
├── pmm_google_ads_request — read-only Google Ads request
├── pmm_journey_status — guided setup progress
├── pmm_journey_discover — record Discovery answers
└── pmm_journey_advance — advance setup stepsAll three plugins dock into the same gateway. Digital Analytics Manager tracks conversions, and the KeyRing holds every credential.
What It Won't Do
These limits are there by design.
Install
1. Install or upgrade the gateway
pipx install "coreforged-mcp>=1.4.0"
Already have it? pipx upgrade coreforged-mcp
2. Install the plugin
coreforged-mcp install-plugin "<path>\CF_Paid_Media_Manager_V_0_3_0.zip"
3. Initialize the loadout
coreforged-mcp init --loadout paid-media
Coming Next
Version 0.3.0 is the 10-step guided journey, including Discovery and the live account check, and adds read-only Google Ads requests. Future versions will add:
Questions
Which AI assistants does it work with?
Built with and for Claude, and tested on Claude Desktop and Claude Code. Created for any agent: the tools are a standard MCP server. So any agent that can use MCP tools, like Codex or Zed, should be able to follow it.
Your Ads, Built from Your Codebase
Your agent walks the journey and the KeyRing holds the credentials. Nothing goes live until you say so.
Get Paid Media Manager — $249