Tools Reference

Complete reference for all 58 MCP tools

Tools Reference

Metrifyr provides 58 MCP tools across 5 categories for comprehensive Google Marketing data access.

Tools by Category

Google Analytics 4 (22 tools)

Traffic analysis, conversion tracking, real-time data, and property management.

Categories:

• Reporting (8 tools) - Run reports, compare periods, realtime data
• Properties (5 tools) - List, create, update properties and data streams
• Events (4 tools) - Manage conversion events and custom events
• Dimensions & Metrics (3 tools) - Custom dimensions, metrics, calculated metrics
• Account Management (2 tools) - List accounts, account summaries

View all Analytics tools →

Search Console (7 tools)

SEO performance, keyword rankings, sitemap management, and URL inspection.

Categories:

• Performance (3 tools) - Query search analytics, export data, aggregate metrics
• Sitemaps (2 tools) - List and submit sitemaps
• URL Inspection (1 tool) - Inspect URLs for indexing status
• Sites (1 tool) - List verified sites

View all Search Console tools →

Google AdSense (6 tools)

Revenue tracking, performance metrics, payment history, and account management.

Categories:

• Reports (3 tools) - Generate revenue reports, saved reports, custom dimensions
• Accounts (2 tools) - List accounts, get account details
• Payments (1 tool) - List payment history

View all AdSense tools →

Google Tag Manager (13 tools) Beta

Container management, tag deployment, trigger configuration, and version control.

Categories:

• Containers (3 tools) - List, get container details, list versions
• Tags (5 tools) - List, get, create, update, delete tags
• Triggers (1 tool) - List triggers
• Variables (1 tool) - List variables
• Versions (1 tool) - Create version from workspace
• Audit (2 tools) - Container audit, accounts list

View all Tag Manager tools →

SEO Tools (10 tools)

PageSpeed Insights, Google Trends, comprehensive audits, and content opportunities.

Categories:

• PageSpeed Insights (4 tools) - Analyze performance, compare sites, batch analysis
• Google Trends (3 tools) - Interest over time, related queries, compare keywords
• SEO Audit (2 tools) - Comprehensive site audit, content opportunities
• Integration (1 tool) - Combined analytics with GSC and PSI

View all SEO tools →

Quick Reference

Total: 58 tools

Common Patterns

Listing Resources

Most tools follow a consistent pattern for listing resources:

Tool: ga4_list_properties
Returns: List of all GA4 properties you have access to

Tool: gsc_list_sites
Returns: List of all Search Console sites

Tool: adsense_list_accounts
Returns: List of all AdSense accounts

Ask Claude:

List my Google Analytics properties

Running Reports

Report tools accept flexible parameters:

Tool: ga4_run_report
Parameters:
  - propertyId: Which property to query
  - dateRange: start/end dates or preset (last_7_days)
  - metrics: Array of metrics (users, sessions, etc.)
  - dimensions: Array of dimensions (date, country, etc.)

Ask Claude:

Show me users and sessions for the last 7 days,
grouped by device category

Creating/Updating Resources

Modification tools require edit permissions:

Tool: ga4_create_conversion_event
Requires: analytics.edit scope

Tool: gtm_create_tag
Requires: tagmanager.edit.containers scope

Ask Claude:

Create a conversion event for newsletter signups

Tool Naming Convention

Tools follow a consistent naming pattern:

<service>_<action>_<resource>

Examples:

• ga4_run_report - Google Analytics, run, report
• gsc_query_search_analytics - Search Console, query, search analytics
• adsense_generate_report - AdSense, generate, report
• gtm_create_tag - Tag Manager, create, tag
• seo_audit_site - SEO, audit, site

Pagination

Tools that return large datasets support pagination:

Automatic pagination: Most tools automatically fetch all pages. You don't need to handle pagination manually.

Manual pagination: Some tools return nextPageToken if you want to control paging:

Tool: ga4_run_report
Response: {
  rows: [...],
  nextPageToken: "abc123"
}

Ask Claude to fetch the next page:

Fetch the next page of results

Error Handling

All tools return structured errors:

Common error types:

• 401 Unauthorized - Invalid API key or expired OAuth
• 403 Forbidden - Missing OAuth scope or insufficient permissions
• 404 Not Found - Property/account doesn't exist or you don't have access
• 429 Too Many Requests - Rate limit exceeded
• 500 Internal Server Error - Google API or Metrifyr issue

See troubleshooting guide

Rate Limits

Metrifyr limits:

• Free: 1,000 requests/day
• Pro: 10,000 requests/day (coming soon)

Google API limits:

• Analytics: 10 queries per second (QPS)
• Search Console: 600 requests per minute
• AdSense: 10 QPS
• Tag Manager: 10 QPS

Metrifyr automatically handles Google rate limits with exponential backoff.

See rate limits reference

Next Steps