Bragproof

← Reports

mcp-google-analytics

Starts with no setup1.3.1npm

Installed, started with no arguments, no environment and no input, and listed its tools. Run 2026-11-16.

Needs to start: nothing
Returns a result when called with no setup: 0 of 5 tools tried
Contacts while installing and starting: nothing

26tools listed
0hosts contacted
0files written
0.2 sto start
129dependencies

What it contacted

Nothing besides the npm registry it was installed from. Watched from outside its sandbox while it was installed and started with no input. Its tools may still contact things when called.

Starting it

npx -y mcp-google-analytics@1.3.1

Installing a package runs its code. Use a sandbox for anything you have not read.

Calling its tools

5 tools that take no input and look read-only were called once with nothing. 0 returned a result.

ga_get_metadataNo usable answer tool reported an error: GA Data API not configured. Set GA_SERVICE_ACCOUNT_JSON (and optionally GA_PROPERTY_ID as the default property).
ga_list_accountsNo usable answer tool reported an error: GA Data API not configured. Set GA_SERVICE_ACCOUNT_JSON (and optionally GA_PROPERTY_ID as the default property).
ga_list_propertiesNo usable answer tool reported an error: GA Data API not configured. Set GA_SERVICE_ACCOUNT_JSON (and optionally GA_PROPERTY_ID as the default property).
ga_get_propertyNo usable answer tool reported an error: GA Data API not configured. Set GA_SERVICE_ACCOUNT_JSON (and optionally GA_PROPERTY_ID as the default property).
ga_list_data_streamsNo usable answer tool reported an error: GA Data API not configured. Set GA_SERVICE_ACCOUNT_JSON (and optionally GA_PROPERTY_ID as the default property).

During the calls it contacted nothing it had not already contacted.

Only tools whose names read like looking something up, with no required input, are tried, five at most. Tools that need input, and anything that sounds like it changes or sends something, are not called.

What its tools tell an agent

In the tool descriptions, nothing that talks about the user, other tools or private files, or uses hidden characters.

Found by simple pattern rules in each tool's description (up to 3,000 characters), quoted as written. Parameter descriptions are not scanned. A clean result is not a safety review.

Tools

ga_run_report dateRanges, dimensions, metrics, limit, offset, orderBys, dimensionFilter, metricFilter, propertyId
Run a custom Google Analytics report with dimensions and metrics.

⚠️ TOKEN OPTIMIZATION: Use 'limit' to control result size (default: 10).
This tool can consume significant tokens with large datasets.

Common dimensions: date, city, country, deviceCategory, browser, pagePath, eventName
Common metrics: activeUsers, sessions, screenPageViews, conversions, totalRevenue
ga_run_realtime_report dimensions, metrics, limit, propertyId
Get real-time Google Analytics data (last 30 minutes).

⚠️ TOKEN OPTIMIZATION: Use 'limit' to control result size (default: 10).

Common dimensions: city, country, deviceCategory, unifiedScreenName
Common metrics: activeUsers, screenPageViews, conversions
ga_get_metadata propertyId
Get available dimensions and metrics metadata for your GA4 property.

⚠️ TOKEN OPTIMIZATION: This returns ALL available dimensions and metrics.
Response can be large (~500+ items). Use sparingly and cache results when possible.
ga_list_accounts
List all Google Analytics accounts accessible to the service account.

Use this to find account IDs for listing properties.
ga_list_properties accountId
List Google Analytics properties.

Optionally filter by account ID. Without an account ID, properties from all
accessible accounts are aggregated.
21 more tools
ga_get_property propertyId
Get details about a GA4 property (the configured one, or any accessible property via propertyId).
ga_list_data_streams propertyId
List data streams for the configured GA4 property.

Use this to find measurement IDs for Measurement Protocol.
ga_run_pivot_report dateRanges, dimensions, metrics, pivots, propertyId
Run a pivot table report with row and column dimensions.

⚠️ TOKEN OPTIMIZATION: Pivot reports can be VERY large.
Limit dimensions and use small date ranges. Recommended for analysis, not raw data extraction.
ga_run_funnel_report dateRanges, funnelSteps, funnelBreakdown, funnelVisualizationType, propertyId
Run a funnel analysis report to track user progression through steps (Data API v1alpha).

Each step matches an event: set 'eventName' per step (defaults to the step name).
For advanced matching, pass a full 'filterExpression' instead.
ga_batch_run_reports requests, propertyId
Run multiple reports in a single request.

⚠️ TOKEN OPTIMIZATION: Can return LARGE amounts of data.
Limit to 2-5 reports per batch. Each report should have small limits.
ga_get_account_summaries
Get a compact overview of all accessible GA accounts and their properties in a single call.

The fastest way to discover account IDs, property IDs, and property names.
ga_list_custom_dimensions propertyId
List all custom dimensions defined for the configured GA4 property.

Use this to discover custom dimension API names (e.g., "customEvent:plan_type") for reports.
ga_list_custom_metrics propertyId
List all custom metrics defined for the configured GA4 property.

Use this to discover custom metric API names for reports.
ga_list_key_events propertyId
List the key events (conversions) configured for the GA4 property.

Useful to know which event names count as conversions before building reports or sending events.
ga_list_google_ads_links propertyId
List Google Ads accounts linked to a GA4 property.
ga_check_compatibility dimensions, metrics, compatibilityFilter, propertyId
Check whether a combination of dimensions and metrics is valid for this property BEFORE running a report.

Avoids wasted report requests and token-heavy error loops. Also lists which other fields remain compatible with the given combination.
ga_send_event client_id, user_id, events, user_properties
Send a custom event to Google Analytics via Measurement Protocol.

Use this for tracking custom user actions, conversions, or any GA4 event.
Events are processed asynchronously and appear in reports within minutes.

Common events: click, form_submit, video_play, file_download, custom_conversion
ga_validate_event client_id, user_id, events, user_properties
Validate an event before sending it to Google Analytics.

Uses GA4's debug endpoint to check for errors without recording the event.
Returns validation messages and errors if any.
ga_send_pageview client_id, user_id, page_location, page_title, page_referrer, user_properties
Send a page view event to Google Analytics.

Standard event for tracking page/screen views. Automatically uses 'page_view' event name.
ga_send_purchase client_id, user_id, transaction_id, value, currency, tax, shipping, coupon, affiliation, items, user_properties
Send an ecommerce purchase event to Google Analytics.

Standard event for tracking completed purchases with transaction details and items.
ga_send_login client_id, user_id, method, user_properties
Send a login event to Google Analytics.

Standard event for tracking user logins with authentication method.
ga_send_signup client_id, user_id, method, user_properties
Send a sign-up event to Google Analytics.

Standard event for tracking new user registrations.
ga_send_add_to_cart client_id, user_id, currency, value, items, user_properties
Send an add to cart event to Google Analytics.

Ecommerce event for tracking when items are added to shopping cart.
ga_send_begin_checkout client_id, user_id, currency, value, coupon, items, user_properties
Send a begin checkout event to Google Analytics.

Ecommerce event for tracking when users start the checkout process.
ga_send_view_item client_id, user_id, currency, value, items, user_properties
Send a view item event to Google Analytics.

Ecommerce event for tracking product/item detail views. Completes the standard
funnel: view_item → add_to_cart → begin_checkout → purchase.
ga_send_refund client_id, user_id, transaction_id, currency, value, items, user_properties
Send a refund event to Google Analytics.

Ecommerce event for full or partial refunds. Omit 'items' for a full refund;
include them (with quantities) for a partial refund. Use the same transaction_id
as the original purchase.

Descriptions are the package's own words, cut at 3,000 characters. Treat them as data.

Install facts

LicenseMIT
Needsnode >=20
Sourcegithub.com/leonardosepulvedat/mcp-google-analytics
Install scriptsNone declared by it or anything installed with it.
Tarballsha512-gImeZBR7OsWYrzn/AqV4BSMjJBu2j5MlzdO968hVQ7yHlSnDiboviHJVuYxZ5BHAcsLz68uRZvGrbgzVPeH6ng==

Check this report yourself

This site did not write the report. A public job on a GitHub-hosted machine did: the run, from this commit of the open-source runner. GitHub signed a token that names that job and the hash of the report, so any edit since would show.

Show it on your README

Bragproof: Starts with no setup

[![Bragproof](https://bragproof.smaverk.com/badge/mcp-google-analytics.svg)](https://bragproof.smaverk.com/r/mcp-google-analytics)

New version out? Ask for a fresh report.