wp_ga_run_report is a Google Analytics 4 MCP tool inside Easy MCP AI — the WordPress plugin that connects Claude, ChatGPT, and any AI assistant to your site.
Install Free Plugin →wp_ga_run_report
Read-onlyRun a custom GA4 report — clicks, sessions, users, events, engagement, revenue — with dimensions, filters, ordering, and pagination
Requires a Google service-account key configured in Easy MCP AI → External Data. Requires the manage_options capability and the mcp:ga:read OAuth scope. Only GA4 properties are supported — Universal Analytics was sunset July 2024.
Description
The workhorse of Easy MCP AI's GA4 suite, wp_ga_run_report covers virtually any standard analytics question — traffic by source, engagement by page, revenue by product, conversions by campaign — through a single natural-language prompt. Easy MCP AI translates the request into a fully parameterized GA4 Data API call (dimensions, metrics, date ranges, filters, ordering, pagination) and streams the result back to Claude.ai, Cursor, Gemini CLI, or any MCP-compatible AI client you use. Run wp_ga_get_metadata first to discover valid field names, then fire this tool for the actual data.
See it in action
wp_ga_run_report Done. I've used wp_ga_run_report to complete that for you.
Example Use Cases & Sample Prompts
- Analyze traffic sources for the past month
- Prompt: “Show me sessions and users broken down by source and medium for the last 30 days on GA4 property 123456789.”
- Find the top landing pages by engagement rate
- Prompt: “What are the top 20 landing pages by engagement rate for GA4 property 123456789 over the last 90 days?”
- Pull ecommerce revenue by product for the last quarter
- Prompt: “Show me total revenue and transactions by item name for GA4 property 123456789 for the last 3 months, sorted by revenue descending.”
Frequently Asked Questions
What does wp_ga_run_report do?
The workhorse of Easy MCP AI's GA4 suite, wp_ga_run_report covers virtually any standard analytics question — traffic by source, engagement by page, revenue by product, conversions by campaign — through a single natural-language prompt. Easy MCP AI translates the request into a fully parameterized GA4 Data API call (dimensions, metrics, date ranges, filters, ordering, pagination) and streams the result back to Claude.ai, Cursor, Gemini CLI, or any MCP-compatible AI client you use. Run wp_ga_get_metadata first to discover valid field names, then fire this tool for the actual data.
How do I use wp_ga_run_report with my AI assistant?
Install Easy MCP AI and configure your Google Analytics 4 credentials in the dashboard. Then connect your AI client and describe what you want in natural language — for example: "Show me sessions and users by country for the last 30 days on GA4 property 123456789."
Do I need Easy MCP AI to use wp_ga_run_report?
Yes. wp_ga_run_report is bundled inside Easy MCP AI as part of the Google Analytics 4 data integration. Configure your credentials, connect your AI, and this tool is available immediately — no coding required.
More Google Analytics 4 Tools
Check which dimension/metric combinations are valid together before running a report
Get all available dimensions and metrics for a property — use to discover valid names before building reports
Get details for a single GA4 property — display name, time zone, currency, data retention
List all GA4 accounts and their properties — entry point for discovering a valid property_id
List conversion/key events configured on a property
List custom dimensions registered on a property
Step 1
Get the Plugin
Install Easy MCP AI on your WordPress site to unlock wp_ga_run_report and all Google Analytics 4 tools instantly.
Step 2
Connect Your AI Client
Already have the plugin? Step-by-step setup guides for Claude, ChatGPT, Cursor, and 10+ more.