@channel47/google-ads-mcp 1.1.1 → 1.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@channel47/google-ads-mcp",
-  "version": "1.1.1",
+  "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

@@ -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 = [];