`gads_search`

Pack: google_ads · Endpoint: https://gateway.pipeworx.io/google_ads/mcp

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/gads_search for the schema, then POST the same URL with its arguments for the data.

Run custom GAQL queries against Google Ads data. Use for advanced analysis—filter by keywords, matching types, or aggregate metrics by custom dimensions.

Parameters

Name	Type	Required	Description
`customer_id`	string	yes	Google Ads customer ID
`query`	string	yes	GAQL query string (e.g., “SELECT campaign.name, metrics.clicks FROM campaign WHERE segments.date DURING LAST_7_DAYS”)

Example call

Arguments

{
  "customer_id": "1234567890",
  "query": "SELECT campaign.name, metrics.clicks FROM campaign WHERE segments.date DURING LAST_7_DAYS"
}

curl

curl -X POST https://gateway.pipeworx.io/google_ads/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"gads_search","arguments":{"customer_id":"1234567890","query":"SELECT campaign.name, metrics.clicks FROM campaign WHERE segments.date DURING LAST_7_DAYS"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('gads_search', {
  "customer_id": "1234567890",
  "query": "SELECT campaign.name, metrics.clicks FROM campaign WHERE segments.date DURING LAST_7_DAYS"
});

More examples

{
  "customer_id": "1234567890",
  "query": "SELECT ad_group.name, metrics.impressions, metrics.cost_micros FROM ad_group WHERE campaign.id = 9876543210"
}

Response shape

Field	Type	Description
`results`	array	GAQL query results

Full JSON Schema

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "description": "GAQL query results",
      "items": {
        "type": "object",
        "description": "Result row matching the GAQL query selection"
      }
    }
  }
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "google_ads": {
      "url": "https://gateway.pipeworx.io/google_ads/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

gads_search