mcp-marketing-analytics
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| META_APP_ID | No | For app secret proof (Meta Ads) | |
| GSC_SITE_URL | No | Default GSC site (can be set per-request) | |
| GA4_PROPERTY_ID | No | Default GA4 property (can be set per-request) | |
| META_APP_SECRET | No | For app secret proof (Meta Ads) | |
| GOOGLE_CLIENT_ID | No | OAuth 2.0 Client ID for Google APIs | |
| META_ACCESS_TOKEN | No | Long-lived access token for Meta Ads | |
| GOOGLE_CLIENT_SECRET | No | OAuth 2.0 Client Secret for Google APIs | |
| GOOGLE_REFRESH_TOKEN | No | OAuth 2.0 Refresh Token for Google APIs | |
| GOOGLE_ADS_CUSTOMER_ID | No | 10-digit account ID for Google Ads | |
| GOOGLE_ADS_DEVELOPER_TOKEN | No | Developer token from API Center for Google Ads | |
| GOOGLE_ADS_LOGIN_CUSTOMER_ID | No | MCC manager account ID (optional) |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| setup_guideA | Get step-by-step instructions for configuring the Marketing Analytics MCP server. Shows which APIs are configured and provides detailed setup guides for any that are missing. |
| ga4_list_accountsA | List all GA4 properties accessible to the authenticated Google account. Use this to discover Property IDs for use with other ga4_* tools. |
| ga4_run_reportA | Run a custom GA4 report with specified dimensions, metrics, and date range. Use GA4 API names like 'activeUsers', 'sessions', 'pagePath', 'sessionSource'. Dates: YYYY-MM-DD or relative like '7daysAgo', '30daysAgo', 'today', 'yesterday'. |
| ga4_realtime_reportA | Get a realtime GA4 report showing current active users and activity from the last 30 minutes. |
| ga4_top_pagesA | Get the top pages by views for the specified date range. Returns page path, title, views, users, and average session duration. |
| ga4_traffic_sourcesA | Get traffic source breakdown showing sessions, users, and engagement by source/medium for the specified date range. |
| ga4_user_metricsA | Get a summary of key user metrics: total users, new users, sessions, page views, bounce rate, avg session duration, and engagement rate. Optionally compare with the previous period. |
| gsc_list_sitesA | List all Search Console sites/properties accessible to the authenticated Google account. Use this to discover Site URLs for use with other gsc_* tools. |
| gsc_search_analyticsC | Query Google Search Console search analytics data with flexible dimensions and filters. Returns clicks, impressions, CTR, and average position. |
| gsc_top_queriesA | Get the top search queries driving traffic to your site, sorted by clicks. Shows query, clicks, impressions, CTR, and average position. |
| gsc_top_pagesA | Get the top pages appearing in Google Search results, sorted by clicks. Shows page URL, clicks, impressions, CTR, and average position. |
| gsc_inspect_urlA | Inspect a URL to see its Google indexing status, crawl info, mobile usability, and any issues. Useful for debugging why a page isn't appearing in search. |
| gsc_list_sitemapsA | List all sitemaps submitted for the site, including their status, last download date, and number of URLs submitted/indexed. |
| meta_list_ad_accountsC | List all Meta/Facebook ad accounts accessible with the current access token. Returns account ID, name, status, currency, and timezone. |
| meta_account_overviewA | Get a high-level performance overview for a Meta ad account: total spend, impressions, clicks, CTR, CPC, CPM, and conversions for the specified date range. Optionally break down by age, gender, country, placement, or device. |
| meta_campaign_insightsA | Get performance insights for all campaigns in a Meta ad account. Shows each campaign's spend, impressions, clicks, CTR, CPC, and conversions. |
| meta_adset_insightsA | Get performance insights for ad sets within a campaign or account. Shows spend, impressions, clicks, and conversions per ad set. |
| meta_ad_insightsA | Get performance insights for individual ads. Shows each ad's name, ad set, campaign, spend, impressions, clicks, and conversions. |
| gads_queryA | Execute a raw Google Ads Query Language (GAQL) query. Use for custom queries not covered by other tools. Example: SELECT campaign.name, metrics.clicks FROM campaign WHERE segments.date DURING LAST_30_DAYS |
| gads_campaign_performanceB | Get performance metrics for Google Ads campaigns: impressions, clicks, cost, conversions, CTR, CPC, and conversion rate. |
| gads_keyword_performanceB | Get performance metrics for Google Ads keywords: search term, match type, clicks, impressions, cost, conversions, and quality score. |
| gads_ad_group_performanceA | Get performance metrics for Google Ads ad groups: impressions, clicks, cost, conversions grouped by ad group within campaigns. |
| gads_account_summaryA | Get a high-level summary of the Google Ads account: total spend, clicks, impressions, conversions, and key averages, plus top 5 campaigns by spend. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 23 tools
Tools are clearly organized by platform prefixes (ga4_, gsc_, meta_, gads_), and each tool targets a distinct resource or action. There is minor overlap within platforms (e.g., ga4_top_pages vs. ga4_run_report, gsc_top_pages vs. gsc_search_analytics), but descriptions clarify when to use each.
Names follow a strong platform-prefix convention (ga4_, gsc_, meta_, gads_) which aids navigation. Within each platform, naming is mostly descriptive noun phrases (e.g., ga4_top_pages, meta_campaign_insights) with some verbs (list, run, inspect), creating minor inconsistency but no chaos.
23 tools is on the heavy side, but appropriate for a multi-platform analytics server covering four distinct services (GA4, Search Console, Meta Ads, Google Ads). Each platform receives a focused set of 5-6 tools, making the count reasonable for the scope.
The tool set provides solid read-only coverage across all four platforms: account discovery, standard reports, custom queries, and granular insights. Some advanced features (e.g., GA4 event diagnostics, Meta ad creative details) are absent, but core analytics workflows are well supported.