Examples

Practical examples of using MCP Google Marketing tools

GA4: Run a Report

Get sessions, users, and page views by date and country for the last 30 days:

{
  "tool": "ga4_run_report",
  "arguments": {
    "propertyId": "properties/123456789",
    "dateRanges": [{ "startDate": "30daysAgo", "endDate": "today" }],
    "dimensions": ["date", "country"],
    "metrics": ["sessions", "totalUsers", "screenPageViews"]
  }
}

GA4: Real-time Data

Get current active users on your site:

{
  "tool": "ga4_get_realtime",
  "arguments": {
    "propertyId": "properties/123456789",
    "dimensions": ["country", "city"],
    "metrics": ["activeUsers"]
  }
}

Search Console: Top Queries

Get top search queries for your site:

{
  "tool": "gsc_search_analytics",
  "arguments": {
    "siteUrl": "https://example.com",
    "startDate": "2024-01-01",
    "endDate": "2024-01-31",
    "dimensions": ["query"],
    "rowLimit": 25
  }
}

Search Console: Page Performance

See which pages get the most clicks:

{
  "tool": "gsc_search_analytics",
  "arguments": {
    "siteUrl": "https://example.com",
    "startDate": "2024-01-01",
    "endDate": "2024-01-31",
    "dimensions": ["page"],
    "rowLimit": 50
  }
}

Generate a monthly earnings report:

{
  "tool": "adsense_generate_report",
  "arguments": {
    "accountId": "accounts/pub-1234567890123456",
    "startDate": "2024-01-01",
    "endDate": "2024-01-31",
    "metrics": ["ESTIMATED_EARNINGS", "PAGE_VIEWS", "CLICKS"],
    "dimensions": ["DATE"]
  }
}

See which ad units perform best:

{
  "tool": "adsense_generate_report",
  "arguments": {
    "accountId": "accounts/pub-1234567890123456",
    "startDate": "2024-01-01",
    "endDate": "2024-01-31",
    "metrics": ["ESTIMATED_EARNINGS", "IMPRESSIONS", "CLICKS"],
    "dimensions": ["AD_UNIT_NAME"]
  }
}

PageSpeed Insights: Analyze Performance

Get detailed performance analysis with Core Web Vitals:

{
  "tool": "psi_analyze",
  "arguments": {
    "url": "https://example.com",
    "strategy": "mobile"
  }
}

PageSpeed Insights: Quick Health Check

Use checkMode for pass/fail evaluation against thresholds:

{
  "tool": "psi_analyze",
  "arguments": {
    "url": "https://example.com",
    "checkMode": true,
    "thresholds": {
      "lcp": 2500,
      "cls": 0.1,
      "inp": 200
    }
  }
}

PageSpeed Insights: Compare URLs

Compare performance of multiple URLs side-by-side:

{
  "tool": "psi_compare",
  "arguments": {
    "urls": ["https://example.com", "https://competitor.com"],
    "strategy": "both"
  }
}

Google Trends: Interest Over Time

Compare keyword interest over the past year:

{
  "tool": "trends_interest_over_time",
  "arguments": {
    "keywords": ["react", "vue", "angular"],
    "geo": "US",
    "timeframe": "today 12-m"
  }
}

Find related search queries for a keyword:

{
  "tool": "trends_related_queries",
  "arguments": {
    "keyword": "artificial intelligence",
    "geo": "US"
  }
}

Get today's trending topics:

{
  "tool": "trends_daily_trending",
  "arguments": {
    "geo": "US"
  }
}

Google Trends: Interest by Region

See where a keyword is most popular:

{
  "tool": "trends_interest_by_region",
  "arguments": {
    "keyword": "electric cars",
    "resolution": "COUNTRY"
  }
}

SEO Audit: Comprehensive Analysis

Run a full SEO audit combining PageSpeed, Search Console, and Trends:

{
  "tool": "seo_audit",
  "arguments": {
    "url": "https://example.com",
    "siteUrl": "sc-domain:example.com",
    "keyword": "your main keyword"
  }
}

Content Opportunity Finder

Discover content opportunities based on trends and search data:

{
  "tool": "content_opportunity_finder",
  "arguments": {
    "siteUrl": "sc-domain:example.com",
    "keywords": ["topic1", "topic2"],
    "geo": "US"
  }
}

Memory: Store Preferences

Save your default settings for future use:

{
  "tool": "memory_set",
  "arguments": {
    "category": "preference",
    "content": "My default GA4 property is properties/123456789"
  }
}

Memory: Get Context

Retrieve stored preferences and context:

{
  "tool": "memory_get",
  "arguments": {
    "toolNames": ["ga4_run_report", "psi_analyze"]
  }
}

Conversational Examples

You can ask Claude naturally:

Analytics & Traffic

"Show me my website traffic for the last week"
"Compare this month's traffic to last month"
"What are my real-time active users?"
"Which pages have the highest bounce rate?"

Search Console & SEO

"What are my top performing pages in Google Search?"
"Which keywords bring the most traffic?"
"Check the indexing status of my homepage"
"Submit my new sitemap"

"How much did I earn from AdSense this month?"
"Which ad units perform best?"
"Show me my payment history"

Performance & Core Web Vitals

"Analyze the performance of my homepage"
"Are my Core Web Vitals passing?"
"Compare my site speed with competitor.com"
"What's slowing down my website?"

Trends & Research

"What's trending in my industry today?"
"Compare interest in React vs Vue vs Angular"
"Find related keywords for 'machine learning'"
"Where is 'electric cars' most popular?"

Combined SEO Tasks

"Run a full SEO audit on my website"
"Find content opportunities for my blog"
"What topics should I write about next?"

Memory & Preferences

"Remember that my main property is properties/123456789"
"What are my saved preferences?"
"Set my preferred language to English"

Examples

On this page