A side-by-side look at the AdLoop and MCP Gads MCP servers: transport, auth, tools, quality signals, and the config to install either one in Claude, Cursor, Windsurf or VS Code.
Verdict: choose AdLoop for marketing work as a local process; choose MCP Gads for marketing as a local process. You can also run both side by side in one mcpServers block.
health_check, get_account_summaries, run_ga4_report.GOOGLE_ADS_DEVELOPER_TOKEN, GOOGLE_ADS_CREDENTIALS_PATH.list_accounts, get_account_currency, get_account_hierarchy.Rows where the two servers differ are marked.
| Spec | ||
|---|---|---|
| Category | Marketing | Marketing |
| Quality signal | 64/100 · Good | 61/100 · Good |
| Install command | Confirmed | Confirmed |
| Transport | Local subprocess (stdio) | Local subprocess (stdio) |
| Auth | Not declared | Not declared |
| Pricing | Not declared | Not declared |
| Required env vars | None listed | GOOGLE_ADS_DEVELOPER_TOKENGOOGLE_ADS_CREDENTIALS_PATH |
| Verified owner | Community listing | Community listing |
| GitHub stars | 279 | 1 |
| Directory activity | 1 views 0 installs 0 upvotes | 8 views 0 installs 0 upvotes |
| Tools | 134 | 36 |
| Full listing | View AdLoop | View MCP Gads |
health_checkTest AdLoop connectivity — checks OAuth token, GA4 API, Google Ads API,
and (when configured) the Reddit Ads API.
Returns the status of each service and actionable guidance when something
is broken, which makes it the diagnostic for failures in other tools.
Google Ads API: https://developers.google.com/google-ads/api/docs/start, Google Analytics Data API: https://developers.google.com/analytics/devguides/reporting/data/v1 and Reddit Ads API: https://ads-api.reddit.com/docs/v3/get_account_summariesList all GA4 accounts and properties accessible by the authenticated user.
Serves as the discovery step for which GA4 properties are available.
Returns account names, property names, and property IDs.
Google Analytics Data API: https://developers.google.com/analytics/devguides/reporting/data/v1 and Admin API: https://developers.google.com/analytics/devguides/config/admin/v1run_ga4_reportRun a custom GA4 report with optional filters, ordering, paging and a comparison period.
Returns the property, the date range, the dimension and metric headers,
one row per dimension combination (values as strings), row_count and
total_row_count (plus next_offset while more rows remain). At least one
dimension or metric is required. With compare_start/compare_end the
comparison period is a second date range: every row then carries a
dateRange value of "current" or "comparison", and date_ranges maps both
labels to their dates. Invalid filters or ordering return "Validation
failed" with details, before anything is sent.
Queries the GA4 Data API. Dimensions and metrics:
https://developers.google.com/analytics/devguides/reporting/data/v1/api-schemarun_realtime_reportRun a GA4 realtime report showing current active users and events.
Useful for checking if tracking is firing correctly after code changes.
Returns the dimension and metric headers and one row per dimension
combination over the realtime window (the last 30 minutes).
Google Analytics Data API: https://developers.google.com/analytics/devguides/reporting/data/v1 and Admin API: https://developers.google.com/analytics/devguides/config/admin/v1get_tracking_eventsList all GA4 events and their volume for the given date range.
Returns every distinct event name with its total event count, sorted by
count (highest first). Shows what tracking is configured and active.
Google Analytics Data API: https://developers.google.com/analytics/devguides/reporting/data/v1 and Admin API: https://developers.google.com/analytics/devguides/config/admin/v1list_key_eventsList the key events (conversions) configured on a GA4 property.
Returns each key event's event name, counting method (ONCE_PER_EVENT or
ONCE_PER_SESSION), create time, whether GA4 allows deleting it, whether
it is a custom event, and its resource name, sorted by event name, plus
the total. Reads the GA4 Admin API (keyEvents.list).
Google Analytics Data API: https://developers.google.com/analytics/devguides/reporting/data/v1 and Admin API: https://developers.google.com/analytics/devguides/config/admin/v1list_ga4_dimensions_and_metricsList the dimensions and metrics a GA4 property can report on, including custom ones.
Returns the exact API names valid in run_ga4_report for this property:
each with its UI name, category, whether it is a custom definition
(customEvent:..., customUser:...), and deprecated API names; metrics
also carry their type and, for calculated metrics, the expression.
Reads the GA4 Data API metadata (properties.getMetadata), which uses no
report quota.
Google Analytics Data API: https://developers.google.com/analytics/devguides/reporting/data/v1 and Admin API: https://developers.google.com/analytics/devguides/config/admin/v1list_gsc_sitesList all Google Search Console properties the authenticated user can access.
Serves as the discovery step for the site URLs that search analytics
reports (run_gsc_report) take. Returns the site URL and permission level
for each property.
Search Console API: https://developers.google.com/webmaster-toolsrun_gsc_reportRun a Google Search Console search analytics report.
Returns clicks, impressions, CTR, and average position broken down by
the requested dimensions. Useful for diagnosing organic traffic drops,
finding keyword opportunities, and cross-referencing with GA4 and Ads data.
One request returns at most 25,000 rows; a full page carries
next_start_row for the following request. With data_state "all" the
response metadata names the first date whose data is still incomplete.
Queries the Search Console API:
https://developers.google.com/webmaster-tools/v1/searchanalytics/queryanalyze_page_speedRun PageSpeed Insights for a landing page — Lighthouse + real-user data.
Returns the performance score (0-100), lab Core Web Vitals (LCP, CLS,
TBT, FCP), CrUX field data from real Chrome users where available
(p75 LCP/INP/CLS/FCP/TTFB + FAST/AVERAGE/SLOW ratings), and the top
improvement opportunities with estimated savings. When the page itself
has too little traffic for field data, the origin-wide field data is
returned instead, marked field.scope="origin".
Typical input is an ad final_url: slow landing pages depress Quality
Score and waste paid clicks. Takes 10-30s; that is normal for a
Lighthouse run.
PageSpeed Insights API: https://developers.google.com/speed/docs/insights/v5/aboutlist_merchant_accountsList Google Merchant Center accounts the connected user can access.
Returns each account's numeric ID, name and whether it is a test
account. Provides the account_id used by get_merchant_feed_health;
not needed when merchant.account_id is set in the config.
Merchant API: https://developers.google.com/merchant/api/overviewget_merchant_feed_healthMerchant Center feed health — disapproved products + account issues.
Disapproved feed items silently starve Shopping and Performance Max
campaigns; this reports approved/pending/disapproved counts per
reporting context (Shopping ads, free listings, ...), the top product
issues by affected products (with documentation links), and
account-level issues — CRITICAL ones stop offers serving entirely.
Product-status data lags reality by ~30 minutes.
Merchant API: https://developers.google.com/merchant/api/overviewlist_accountsLists all accessible Google Ads accounts. Run this first to discover account IDs.get_account_currencyGet the currency code for a Google Ads account. Run this before analyzing cost data.get_account_hierarchyGet the MCC account tree showing manager-client relationships via customer_client resource.execute_gaql_queryExecute a custom GAQL query and return results as a table. Use this for any ad-hoc Google Ads Query Language query.run_gaqlExecute any GAQL query with output format options (table, json, csv). The most powerful tool for custom Google Ads data queries.
EXAMPLE QUERIES:
Campaign metrics: SELECT campaign.name, metrics.clicks, metrics.impressions, metrics.cost_micros FROM campaign WHERE segments.date DURING LAST_7_DAYS
Ad group perf: SELECT ad_group.name, metrics.conversions, metrics.cost_micros, campaign.name FROM ad_group WHERE metrics.clicks > 100
Keyword analysis: SELECT keyword.text, metrics.ctr FROM keyword_view ORDER BY metrics.impressions DESC
Note: Cost values are in micros (1,000,000 = 1 unit of currency).get_gaql_helpGet a GAQL (Google Ads Query Language) reference guide with syntax, common resources, date filters, and example queries. Call this before writing custom GAQL queries.list_resourcesList valid Google Ads API resources that can be used in GAQL FROM clauses.get_campaign_performanceGet campaign performance metrics for the specified time period.
RECOMMENDED WORKFLOW:
1. First run list_accounts() to get available account IDs
2. Then run get_account_currency() to see what currency the account uses
3. Finally run this command to get campaign performance
Note: Cost values are in micros (1,000,000 = 1 unit of currency).get_budget_utilizationGet campaign budget amounts vs actual spend to see budget utilization. Shows whether campaigns are limited by budget.get_ad_performanceGet ad-level performance metrics for the specified time period.
RECOMMENDED WORKFLOW:
1. First run list_accounts() to get available account IDs
2. Then run get_account_currency() to see what currency the account uses
3. Finally run this command to get ad performance
Note: Cost values are in micros (1,000,000 = 1 unit of currency).get_ad_creativesGet ad creative details including RSA headlines, descriptions, and final URLs. Great for creative audits.get_image_assetsRetrieve all image assets in the account including their full-size URLs, dimensions, and file sizes.Paste either block (or both) into your client config, e.g. claude_desktop_config.json or ~/.cursor/mcp.json. We only show a config when the install command is confirmed.
{
"mcpServers": {
"adloop": {
"command": "uvx",
"args": [
"adloop"
]
}
}
}
{
"mcpServers": {
"mcp-gads": {
"command": "npx",
"args": [
"-y",
"mcp-gads"
],
"env": {
"GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_GOOGLE_ADS_DEVELOPER_TOKEN_HERE",
"GOOGLE_ADS_CREDENTIALS_PATH": "YOUR_GOOGLE_ADS_CREDENTIALS_PATH_HERE"
}
}
}
}