{"name":"io.github.leonardosepulvedat/mcp-google-analytics","slug":"leonardosepulvedat-mcp-google-analytics","title":null,"description":"GA4 MCP that reads AND writes: reports, funnels, audits, and server-side events. 26 tools.","url":"https://mcp.market/server/leonardosepulvedat-mcp-google-analytics","rating":null,"grade":"B","score":78,"certified":false,"status":"active","category":"other","tags":[],"presence":{"score":31,"stars":2,"forks":0,"downloads_week":1591,"last_push_at":"2026-08-21T17:52:27.000Z","license":"MIT"},"uptime":null,"claimed":false,"transport":"npm","callable_via_gateway":false,"default_price_micros":0,"repository":"https://github.com/leonardosepulvedat/mcp-google-analytics","website":null,"version":"1.3.0","remotes":[],"packages":[{"registryType":"npm","identifier":"mcp-google-analytics","version":"1.3.0","transport":{"type":"stdio"},"environmentVariables":[{"description":"Service account JSON for reading reports: file path or inline JSON (needed for read tools)","format":"string","isSecret":true,"name":"GA_SERVICE_ACCOUNT_JSON"},{"description":"Numeric GA4 property ID, e.g. 123456789 (needed for read tools)","format":"string","name":"GA_PROPERTY_ID"},{"description":"Measurement ID of the data stream, e.g. G-XXXXXXXXXX (needed for event-sending tools)","format":"string","name":"GA_MEASUREMENT_ID"},{"description":"Measurement Protocol API secret (needed for event-sending tools)","format":"string","isSecret":true,"name":"GA_API_SECRET"}]}],"tools":[{"name":"ga_batch_run_reports","description":"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.","write_action":true,"price_micros":0,"input_schema":null},{"name":"ga_check_compatibility","description":"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.","write_action":false,"price_micros":0,"input_schema":null},{"name":"ga_get_account_summaries","description":"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.","write_action":false,"price_micros":0,"input_schema":null},{"name":"ga_get_metadata","description":"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.","write_action":false,"price_micros":0,"input_schema":null},{"name":"ga_get_property","description":"Get details about a GA4 property (the configured one, or any accessible property via propertyId).","write_action":false,"price_micros":0,"input_schema":null},{"name":"ga_list_accounts","description":"List all Google Analytics accounts accessible to the service account. Use this to find account IDs for listing properties.","write_action":false,"price_micros":0,"input_schema":null},{"name":"ga_list_custom_dimensions","description":"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.","write_action":false,"price_micros":0,"input_schema":null},{"name":"ga_list_custom_metrics","description":"List all custom metrics defined for the configured GA4 property. Use this to discover custom metric API names for reports.","write_action":false,"price_micros":0,"input_schema":null},{"name":"ga_list_data_streams","description":"List data streams for the configured GA4 property. Use this to find measurement IDs for Measurement Protocol.","write_action":false,"price_micros":0,"input_schema":null},{"name":"ga_list_google_ads_links","description":"List Google Ads accounts linked to a GA4 property.","write_action":false,"price_micros":0,"input_schema":null},{"name":"ga_list_key_events","description":"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.","write_action":false,"price_micros":0,"input_schema":null},{"name":"ga_list_properties","description":"List Google Analytics properties. Optionally filter by account ID. Without an account ID, properties from all accessible accounts are aggregated.","write_action":false,"price_micros":0,"input_schema":null},{"name":"ga_run_funnel_report","description":"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.","write_action":true,"price_micros":0,"input_schema":null},{"name":"ga_run_pivot_report","description":"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.","write_action":true,"price_micros":0,"input_schema":null},{"name":"ga_run_realtime_report","description":"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","write_action":true,"price_micros":0,"input_schema":null},{"name":"ga_run_report","description":"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","write_action":true,"price_micros":0,"input_schema":null},{"name":"ga_send_add_to_cart","description":"Send an add to cart event to Google Analytics. Ecommerce event for tracking when items are added to shopping cart.","write_action":true,"price_micros":0,"input_schema":null},{"name":"ga_send_begin_checkout","description":"Send a begin checkout event to Google Analytics. Ecommerce event for tracking when users start the checkout process.","write_action":true,"price_micros":0,"input_schema":null},{"name":"ga_send_event","description":"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","write_action":true,"price_micros":0,"input_schema":null},{"name":"ga_send_login","description":"Send a login event to Google Analytics. Standard event for tracking user logins with authentication method.","write_action":true,"price_micros":0,"input_schema":null},{"name":"ga_send_pageview","description":"Send a page view event to Google Analytics. Standard event for tracking page/screen views. Automatically uses 'page_view' event name.","write_action":true,"price_micros":0,"input_schema":null},{"name":"ga_send_purchase","description":"Send an ecommerce purchase event to Google Analytics. Standard event for tracking completed purchases with transaction details and items.","write_action":true,"price_micros":0,"input_schema":null},{"name":"ga_send_refund","description":"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.","write_action":true,"price_micros":0,"input_schema":null},{"name":"ga_send_signup","description":"Send a sign-up event to Google Analytics. Standard event for tracking new user registrations.","write_action":true,"price_micros":0,"input_schema":null},{"name":"ga_send_view_item","description":"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.","write_action":true,"price_micros":0,"input_schema":null},{"name":"ga_validate_event","description":"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.","write_action":false,"price_micros":0,"input_schema":null}],"scan":{"score":78,"grade":"B","scanned_at":"2026-11-01T22:09:47.691Z","report":{"scannerVersion":"0.1.10","scannedAt":"2026-11-01T22:09:47.648Z","components":{"code":{"score":25,"max":25,"notes":["9 source files scanned"]},"reliability":{"score":-1,"max":20,"notes":["no gateway calls yet and no remote to probe"]},"poisoning":{"score":-1,"max":15,"notes":["tools not inspected (local package is not executed); not counted"]},"auth":{"score":6,"max":15,"notes":["static API keys via environment variables"]},"maintenance":{"score":12,"max":15,"notes":["last push 72 days ago"]},"identity":{"score":8,"max":10,"notes":["registry namespace matches repository owner","GitHub account older than a year"]}},"findings":[],"inputs":{"packages":[{"registryType":"npm","identifier":"mcp-google-analytics","version":"1.3.0","found":true,"license":"MIT","hasInstallScripts":false,"dependencyCount":4,"publishedAt":"2026-08-21T14:24:31.469Z","repositoryUrl":"git+https://github.com/leonardosepulvedat/mcp-google-analytics.git"}],"repo":{"found":true,"owner":"leonardosepulvedat","repo":"mcp-google-analytics","archived":false,"pushedAt":"2026-08-21T17:52:27Z","stars":2,"forks":0,"openIssues":0,"ownerType":"User","ownerAvatarUrl":"https://avatars.githubusercontent.com/u/60888770?v=4","ownerCreatedAt":"2020-02-10T15:30:19Z","license":"MIT"},"icon":{"url":null,"source":"none"},"presence":{"stars":2,"forks":0,"downloadsWeek":1591,"license":"MIT","lastPushAt":"2026-08-21T17:52:27.000Z","score":31}}}},"grade_history":[],"reviews":[]}