@channel47/google-ads-mcp 1.1.0 → 1.2.0

package/README.md

@@ -5,7 +5,7 @@
 
 MCP server for Google Ads API access via GAQL (Google Ads Query Language). Built by a practitioner managing 25+ ad accounts daily — not a demo.
 
-Part of [Channel 47](https://channel47.dev), the open-source ecosystem of profession plugins for Claude Code. [Get the newsletter](https://channel47.dev/subscribe) for weekly skill breakdowns from production use.
+Part of [channel47](https://channel47.dev), the open-source ecosystem of profession plugins for Claude Code. [Get the newsletter](https://channel47.dev/subscribe) for weekly skill breakdowns from production use.
 
 ## What It Does
 
@@ -18,7 +18,7 @@ Part of [Channel 47](https://channel47.dev), the open-source ecosystem of profes
 
 ### For Claude Code Plugin Users
 
-Bundled with the [media-buyer plugin](https://github.com/channel47/channel47). No manual install required.
+Bundled with the [media-buyer plugin](https://github.com/channel47/plugins). No manual install required.
 
 ### Standalone Use
 
@@ -50,6 +50,30 @@ google-ads-mcp
 |----------|-------------|
 | `GOOGLE_ADS_LOGIN_CUSTOMER_ID` | MCC Account ID (10 digits, no dashes) |
 | `GOOGLE_ADS_DEFAULT_CUSTOMER_ID` | Default account ID for queries |
+| `GOOGLE_ADS_READ_ONLY` | Set to `true` to hide the mutate tool entirely — query and list only |
+
+### MCP Config Example
+
+```json
+{
+  "mcpServers": {
+    "google-ads": {
+      "command": "npx",
+      "args": ["-y", "@channel47/google-ads-mcp@latest"],
+      "env": {
+        "GOOGLE_ADS_DEVELOPER_TOKEN": "your-developer-token",
+        "GOOGLE_ADS_CLIENT_ID": "your-client-id",
+        "GOOGLE_ADS_CLIENT_SECRET": "your-client-secret",
+        "GOOGLE_ADS_REFRESH_TOKEN": "your-refresh-token",
+        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "1234567890",
+        "GOOGLE_ADS_READ_ONLY": "true"
+      }
+    }
+  }
+}
+```
+
+Remove `GOOGLE_ADS_READ_ONLY` or set to `false` to enable the mutate tool.
 
 ## Tools
 
@@ -241,15 +265,15 @@ npm install    # workspaces — installs all servers
 npm test       # runs all server tests
 ```
 
-~200 lines of server code. 3 core tools. Dry-run by default. OAuth 2.0 with environment-based credentials.
+3 core tools. Dry-run by default. OAuth 2.0 with environment-based credentials.
 
-Pairs with the [media-buyer plugin](https://github.com/channel47/channel47), which adds skills, mutation validation hooks, and GAQL reference docs on top of this server.
+Pairs with the [media-buyer plugin](https://github.com/channel47/plugins), which adds skills, mutation validation hooks, and GAQL reference docs on top of this server.
 
 ## Links
 
-- [Channel 47](https://channel47.dev) — open-source profession plugins for Claude Code
+- [channel47](https://channel47.dev) — open-source profession plugins for Claude Code
 - [Build Notes](https://channel47.dev/subscribe) — weekly skill breakdowns from production use
-- [Media Buyer Plugin](https://github.com/channel47/channel47) — the paid-search toolkit this MCP powers
+- [Media Buyer Plugin](https://github.com/channel47/plugins) — the paid-search toolkit this MCP powers
 - [NPM Package](https://www.npmjs.com/package/@channel47/google-ads-mcp)
 - [Google Ads API](https://developers.google.com/google-ads/api/docs/start) / [GAQL Reference](https://developers.google.com/google-ads/api/docs/query/overview)
 - [X](https://x.com/ctrlswing) / [LinkedIn](https://www.linkedin.com/in/jackson-d-9979a7a0/) / [GitHub](https://github.com/channel47)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@channel47/google-ads-mcp",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Google Ads MCP Server - Query and mutate Google Ads data using GAQL",
   "main": "server/index.js",
   "bin": {

package/server/auth.js

@@ -61,14 +61,15 @@ export function initializeGoogleAdsClient() {
 /**
  * Get authenticated customer client for a specific account
  * @param {string} customerId - Google Ads account ID (without dashes)
+ * @param {string} [loginCustomerId] - MCC account ID to authenticate through (overrides env var)
  * @returns {Customer}
  */
-export function getCustomerClient(customerId) {
+export function getCustomerClient(customerId, loginCustomerId) {
   const client = initializeGoogleAdsClient();
 
   return client.Customer({
     customer_id: customerId,
     refresh_token: process.env.GOOGLE_ADS_REFRESH_TOKEN,
-    login_customer_id: process.env.GOOGLE_ADS_LOGIN_CUSTOMER_ID,
+    login_customer_id: loginCustomerId || process.env.GOOGLE_ADS_LOGIN_CUSTOMER_ID,
   });
 }

package/server/index.js

@@ -26,7 +26,7 @@ import { getPromptsList, renderPrompt } from './prompts/templates.js';
 
 // Server metadata
 const SERVER_NAME = 'google-ads-mcp';
-const SERVER_VERSION = '1.0.0';
+const SERVER_VERSION = '1.1.1';
 
 // Validate environment on startup
 const { valid, missing } = validateEnvironment();
@@ -61,6 +61,10 @@ const ALL_TOOLS = [
     inputSchema: {
       type: 'object',
       properties: {
+        login_customer_id: {
+          type: 'string',
+          description: 'MCC account ID to authenticate through (overrides GOOGLE_ADS_LOGIN_CUSTOMER_ID env var). Use when accessing accounts under a different MCC than the default.'
+        },
         include_manager_accounts: {
           type: 'boolean',
           description: 'Include manager (MCC) accounts in results',
@@ -79,6 +83,10 @@ const ALL_TOOLS = [
           type: 'string',
           description: 'Google Ads account ID (optional, uses default if not specified)'
         },
+        login_customer_id: {
+          type: 'string',
+          description: 'MCC account ID to authenticate through (overrides GOOGLE_ADS_LOGIN_CUSTOMER_ID env var). Use when accessing accounts under a different MCC than the default.'
+        },
         query: {
           type: 'string',
           description: 'Full GAQL query string (SELECT only)'
@@ -123,6 +131,10 @@ For IMAGE/VIDEO assets, use 'image_file_path' or 'video_file_path' with absolute
           type: 'string',
           description: 'Google Ads customer ID (optional, uses default if not specified)'
         },
+        login_customer_id: {
+          type: 'string',
+          description: 'MCC account ID to authenticate through (overrides GOOGLE_ADS_LOGIN_CUSTOMER_ID env var). Use when accessing accounts under a different MCC than the default.'
+        },
         operations: {
           type: 'array',
           description: 'Array of mutation operations. Supports standard format ({ create/update/remove: ... }) or Opteo format ({ entity, operation, resource }).',

package/server/tools/gaql-query.js

@@ -63,7 +63,7 @@ export async function runGaqlQuery(params = {}) {
       }
     }
 
-    const customer = getCustomerClient(customerId);
+    const customer = getCustomerClient(customerId, params.login_customer_id);
 
     // Execute query
     const startTime = Date.now();

package/server/tools/list-accounts.js

@@ -12,18 +12,20 @@ export async function listAccounts(params = {}) {
   try {
     const includeManagers = params.include_manager_accounts || false;
 
-    // Use login customer ID or default customer ID
-    const customerId = process.env.GOOGLE_ADS_LOGIN_CUSTOMER_ID ||
-                       process.env.GOOGLE_ADS_DEFAULT_CUSTOMER_ID;
+    // Resolve MCC to enumerate — broader fallback than query/mutate because
+    // list_accounts always needs an MCC, while the others target specific accounts
+    const loginCustomerId = params.login_customer_id ||
+                            process.env.GOOGLE_ADS_LOGIN_CUSTOMER_ID ||
+                            process.env.GOOGLE_ADS_DEFAULT_CUSTOMER_ID;
 
-    if (!customerId) {
+    if (!loginCustomerId) {
       throw new Error(
-        'Either GOOGLE_ADS_LOGIN_CUSTOMER_ID or GOOGLE_ADS_DEFAULT_CUSTOMER_ID must be set'
+        'Either login_customer_id parameter, GOOGLE_ADS_LOGIN_CUSTOMER_ID, or GOOGLE_ADS_DEFAULT_CUSTOMER_ID must be set'
       );
     }
 
-    // Get customer client
-    const customer = getCustomerClient(customerId);
+    // Get customer client — login_customer_id serves as both the query target and auth MCC
+    const customer = getCustomerClient(loginCustomerId, loginCustomerId);
 
     // Build query with optional manager filter
     const filters = includeManagers ? '' : "WHERE customer_client.manager = false";

package/server/tools/mutate.js

@@ -17,6 +17,7 @@ import { normalizeOperations } from '../utils/operation-transform.js';
 export async function mutate(params) {
   const {
     customer_id = process.env.GOOGLE_ADS_CUSTOMER_ID,
+    login_customer_id,
     operations,
     partial_failure = true,
     dry_run = true
@@ -31,7 +32,7 @@ export async function mutate(params) {
     return formatError(new Error('operations array is required and must contain at least one operation'));
   }
 
-  const customer = getCustomerClient(customer_id);
+  const customer = getCustomerClient(customer_id, login_customer_id);
   let response;
   let partialFailureErrors = [];