`gads_campaign_metrics`

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

Get performance metrics for campaigns over a date range. Returns impressions, clicks, cost, conversions, CTR, and CPC. Use to analyze campaign effectiveness or compare performance trends.

Parameters

Name	Type	Required	Description
`customer_id`	string	yes	Google Ads customer ID
`campaign_id`	string	no	Campaign ID to filter (optional, returns all campaigns if omitted)
`start_date`	string	yes	Start date in YYYY-MM-DD format (e.g., “2024-01-01”)
`end_date`	string	yes	End date in YYYY-MM-DD format (e.g., “2024-01-31”)
`limit`	number	no	Maximum number of rows to return (default 50)

Example call

Arguments

{
  "customer_id": "1234567890",
  "start_date": "2024-01-01",
  "end_date": "2024-01-31"
}

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_campaign_metrics","arguments":{"customer_id":"1234567890","start_date":"2024-01-01","end_date":"2024-01-31"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('gads_campaign_metrics', {
  "customer_id": "1234567890",
  "start_date": "2024-01-01",
  "end_date": "2024-01-31"
});

More examples

{
  "customer_id": "1234567890",
  "campaign_id": "9876543210",
  "start_date": "2024-01-01",
  "end_date": "2024-01-31",
  "limit": 100
}

Response shape

Field	Type	Description
`results`	array	Campaign performance metrics

Full JSON Schema

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "description": "Campaign performance metrics",
      "items": {
        "type": "object",
        "properties": {
          "campaign": {
            "type": "object",
            "description": "Campaign resource data",
            "properties": {
              "id": {
                "type": "string",
                "description": "Campaign ID"
              },
              "name": {
                "type": "string",
                "description": "Campaign name"
              }
            }
          },
          "metrics": {
            "type": "object",
            "description": "Performance metrics",
            "properties": {
              "impressions": {
                "type": "number",
                "description": "Number of impressions"
              },
              "clicks": {
                "type": "number",
                "description": "Number of clicks"
              },
              "cost_micros": {
                "type": "number",
                "description": "Cost in micros"
              },
              "conversions": {
                "type": "number",
                "description": "Number of conversions"
              },
              "ctr": {
                "type": "number",
                "description": "Click-through rate"
              },
              "average_cpc": {
                "type": "number",
                "description": "Average cost per click"
              }
            }
          }
        }
      }
    }
  }
}

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_campaign_metrics