@getmcpads/google-ads-mcp-server

MCPcommunity
v1.0.2GetMCPAdsApache-2.0Aggiornato 3 g fanpmGitHub

Open-source MCP server for the Google Ads API. 31 read tools and 7 write tools that preview before they apply, full Keyword Planner, Reach Planner and GAQL access. Self-hosted, bring your own credentials.

Funziona in
ClaudeCursorCopilotGemini

Dedotto dai trasporti dichiarati da questo annuncio (stdio). Un client che non compare qui non è escluso — semplicemente Forge non è in grado di confermarlo.

Indicizzato automaticamente da fonti pubbliche. Non ancora verificato dal suo sviluppatore su Forge.Rivendica questo annuncio →
52Download/sett.
3 g faUltimo aggiornamento
Richiede 3 credenziali prima di poter funzionare
  • GOOGLE_ADS_DEVELOPER_TOKENChiave APIobbligatoria

    Google Ads API developer token, Basic Access or above.

  • GOOGLE_ADS_CLIENT_SECRETApp OAuthobbligatoria

    OAuth client secret.

  • GOOGLE_ADS_REFRESH_TOKENApp OAuthobbligatoria

    OAuth refresh token.

Dichiarato dall’autore nel registro MCP ufficiale. Forge does not store, broker, or ever see these values — the config below is scaffolded with placeholders you fill in locally.

Pacchetto
AutoreGetMCPAds
LicenzaApache-2.0
Versione1.0.2
Fontenpm+mcp-registry
Stato di fiducia
B
60/100Buono
Presente nell’indice di Forge+10/10
Identità del publisher verificata+0/20
Publisher: esegui `forge publish` dal repo del pacchetto per rivendicarne la proprietà
Firma di pubblicazione Ed25519+0/5
Inclusa automaticamente quando il publisher esegue `forge publish`
Verifica del dominio+0/5
Publisher: ospita /.well-known/forge.json sulla homepage del pacchetto con { "publisher": "<github-login>" }
npm Trusted Publishing (Sigstore)+0/5
Pubblica da GitHub Actions con --provenance perché l’attestation leghi questo pacchetto a questo repo
Corrispondenza del maintainer npm+0/5
Si ottiene quando la tua identità è verificata qui sopra e quel login è maintainer npm di questo pacchetto
Analisi CVE · pulita+30/30
Analisi statica · pulita+20/20
Incollalo in Claude Code, Cursor o qualsiasi assistente di IA per colmare tutte le lacune
StatoIndicizzato dalla community
PublisherNon verificato
FirmaNon firmato
Dominio
Provenienza
Dipendenze✓ 60 risolte+ · nessuna vulnerabile
Superficie di strumenti36 strumenti · 1 privilegiati
Analisi di sicurezza✓ Pulitov1.0.2 · 2 g faQuanto è efficace questa analisi?
ValutazioniNessuna
Indicizzato31 ago 2026

La verifica conferma l’identità del publisher (la proprietà del repo), non la sicurezza del codice. L’analisi di sicurezza copre i CVE noti e gli script di installazione sospetti.

Strumenti

36 strumenti · 1 privilegiati
Estratto staticamente dal pacchetto pubblicatov1.0.2 · 2d ago

Letto dal codice che npm distribuisce davvero, al momento dell’analisi. Il pacchetto non è mai stato eseguito. Gli strumenti registrati dinamicamente a runtime, o nascosti in codice impacchettato o minificato, possono sfuggire — quindi questo è un limite inferiore della superficie di strumenti, non un censimento completo.

google_ads_run_readonly_rpcAdvanced read-only escape hatch for allowlisted Google Ads services outside GAQL: Audience Insights, Reach Planner, benchmarks, creator/trending insights, targeting suggestions, Smart Campaign suggestions, identity verification, invoices, and payments accounts. The operation is an enum; arbitrary p…

Advanced read-only escape hatch for allowlisted Google Ads services outside GAQL: Audience Insights, Reach Planner, benchmarks, creator/trending insights, targeting suggestions, Smart Campaign suggestions, identity verification, invoices, and payments accounts. The operation is an enum; arbitrary p…

Per questo strumento non è stato pubblicato alcuno schema di input.

google_ads_generate_keyword_historical_metricsGet Keyword Planner search-volume history for supplied keywords. Returns average monthly searches, monthly volumes (up to 48 months), latest volume, computed 3-month and YoY changes, competition, CPC/bid ranges, close variants, and optional device totals. This is a read-only planless RPC.

Get Keyword Planner search-volume history for supplied keywords. Returns average monthly searches, monthly volumes (up to 48 months), latest volume, computed 3-month and YoY changes, competition, CPC/bid ranges, close variants, and optional device totals. This is a read-only planless RPC.

Per questo strumento non è stato pubblicato alcuno schema di input.

google_ads_generate_keyword_ideasDiscover Keyword Planner ideas from up to 20 seed keywords, a URL, keywords plus URL, or a whole site. Returns historical volume, monthly trends, computed 3-month/YoY changes, competition, bids, close variants, optional concepts, and pagination. Read-only; no plan is saved.

Discover Keyword Planner ideas from up to 20 seed keywords, a URL, keywords plus URL, or a whole site. Returns historical volume, monthly trends, computed 3-month/YoY changes, competition, bids, close variants, optional concepts, and pagination. Read-only; no plan is saved.

Per questo strumento non è stato pubblicato alcuno schema di input.

google_ads_generate_keyword_forecast_metricsForecast impressions, clicks, CTR, CPC, cost, conversions, and CPA for a temporary keyword campaign. Supports targeting, negatives, match type, three bidding strategies, explicit future dates, and an optional independent per-keyword breakdown. This read-only planless RPC does not create a campaign…

Forecast impressions, clicks, CTR, CPC, cost, conversions, and CPA for a temporary keyword campaign. Supports targeting, negatives, match type, three bidding strategies, explicit future dates, and an optional independent per-keyword breakdown. This read-only planless RPC does not create a campaign…

Per questo strumento non è stato pubblicato alcuno schema di input.

google_ads_search_fieldsSearch Google's live GoogleAdsField catalog. Discovers every queryable GAQL resource, attribute, segment, metric, enum value, and selectable-with compatibility relationship. Read-only and useful before a raw GAQL query.

Search Google's live GoogleAdsField catalog. Discovers every queryable GAQL resource, attribute, segment, metric, enum value, and selectable-with compatibility relationship. Read-only and useful before a raw GAQL query.

Per questo strumento non è stato pubblicato alcuno schema di input.

google_ads_suggest_geo_targetsResolve up to 25 location names or geo target IDs to Google Ads geoTargetConstants. Returns criterion IDs, canonical names, target types, status, parents, locale, and approximate reach. Read-only.

Resolve up to 25 location names or geo target IDs to Google Ads geoTargetConstants. Returns criterion IDs, canonical names, target types, status, parents, locale, and approximate reach. Read-only.

Per questo strumento non è stato pubblicato alcuno schema di input.

google_ads_generate_ad_group_themesOrganize supplied keywords into existing Google Ads ad groups. Returns suggested ad group/campaign pairings, normalized keyword text, and suggested match type without creating or editing keywords. Read-only Keyword Planner RPC.

Organize supplied keywords into existing Google Ads ad groups. Returns suggested ad group/campaign pairings, normalized keyword text, and suggested match type without creating or editing keywords. Read-only Keyword Planner RPC.

Per questo strumento non è stato pubblicato alcuno schema di input.

google_ads_list_accountsList Google Ads customer accounts accessible with the current credentials. If an accessible customer is a manager account, also attempts to include enabled child accounts from customer_client.

List Google Ads customer accounts accessible with the current credentials. If an accessible customer is a manager account, also attempts to include enabled child accounts from customer_client.

Per questo strumento non è stato pubblicato alcuno schema di input.

google_ads_get_account_detailsGet detailed information for a specific Google Ads customer account.

Get detailed information for a specific Google Ads customer account.

Per questo strumento non è stato pubblicato alcuno schema di input.

google_ads_run_gaqlExecute a raw GAQL (Google Ads Query Language) query. Full flexibility for any reporting need. Example: SELECT campaign.name, metrics.impressions FROM campaign WHERE campaign.status = 'ENABLED' AND segments.date DURING LAST_30_DAYS ORDER BY metrics.impressions DESC LIMIT 100

Execute a raw GAQL (Google Ads Query Language) query. Full flexibility for any reporting need. Example: SELECT campaign.name, metrics.impressions FROM campaign WHERE campaign.status = 'ENABLED' AND segments.date DURING LAST_30_DAYS ORDER BY metrics.impressions DESC LIMIT 100

Per questo strumento non è stato pubblicato alcuno schema di input.

google_ads_get_insightsQuery Google Ads performance insights with intelligent query planning. Auto-generates GAQL, handles metric/segment incompatibilities by splitting queries. Use google-ads://metrics for available metrics, google-ads://dimensions for dimensions.

Query Google Ads performance insights with intelligent query planning. Auto-generates GAQL, handles metric/segment incompatibilities by splitting queries. Use google-ads://metrics for available metrics, google-ads://dimensions for dimensions.

Per questo strumento non è stato pubblicato alcuno schema di input.

google_ads_get_campaignsList campaigns for a Google Ads account with status, budget, channel type, and bidding strategy.

List campaigns for a Google Ads account with status, budget, channel type, and bidding strategy.

Per questo strumento non è stato pubblicato alcuno schema di input.

google_ads_get_adgroupsList ad groups for a Google Ads account, optionally filtered by campaign.

List ad groups for a Google Ads account, optionally filtered by campaign.

Per questo strumento non è stato pubblicato alcuno schema di input.

google_ads_get_keyword_performanceGet keyword-level performance data from keyword_view resource. Shows quality score, impressions, clicks, cost.

Get keyword-level performance data from keyword_view resource. Shows quality score, impressions, clicks, cost.

Per questo strumento non è stato pubblicato alcuno schema di input.

google_ads_validate_queryValidate metric/dimension/resource compatibility BEFORE executing a query. Checks segment restrictions and resource availability.

Validate metric/dimension/resource compatibility BEFORE executing a query. Checks segment restrictions and resource availability.

Per questo strumento non è stato pubblicato alcuno schema di input.

google_ads_health_checkRead-only connectivity check. Verifies credential presence, Google Ads API access, login customer visibility, API version, and actionable warnings without returning secrets.

Read-only connectivity check. Verifies credential presence, Google Ads API access, login customer visibility, API version, and actionable warnings without returning secrets.

Per questo strumento non è stato pubblicato alcuno schema di input.

google_ads_get_account_hierarchyList accessible customers and, where possible, manager/client relationships from GAQL customer_client. Falls back to accessible customers if hierarchy queries are unavailable.

List accessible customers and, where possible, manager/client relationships from GAQL customer_client. Falls back to accessible customers if hierarchy queries are unavailable.

Per questo strumento non è stato pubblicato alcuno schema di input.

google_ads_get_conversion_actionsList conversion actions with status, type, category, primary/include-in-conversions flags, owner customer, and last activity dates when supported.

List conversion actions with status, type, category, primary/include-in-conversions flags, owner customer, and last activity dates when supported.

Per questo strumento non è stato pubblicato alcuno schema di input.

google_ads_get_change_eventsFetch recent change_event rows. Enforces Google Ads constraints: date window within the last 30 days and LIMIT <= 10000.

Fetch recent change_event rows. Enforces Google Ads constraints: date window within the last 30 days and LIMIT <= 10000.

Per questo strumento non è stato pubblicato alcuno schema di input.

google_ads_get_recommendationsList Google Ads recommendations with type, resource, campaign/ad group links, dismissed state, and impact when supported.

List Google Ads recommendations with type, resource, campaign/ad group links, dismissed state, and impact when supported.

Per questo strumento non è stato pubblicato alcuno schema di input.

google_ads_get_budgetsList campaign budgets with amount, status, delivery method, and recommended budget fields when supported.

List campaign budgets with amount, status, delivery method, and recommended budget fields when supported.

Per questo strumento non è stato pubblicato alcuno schema di input.

google_ads_get_bidding_strategiesList portfolio bidding strategies. Includes metrics only when startDate/endDate are provided; otherwise returns structure only.

List portfolio bidding strategies. Includes metrics only when startDate/endDate are provided; otherwise returns structure only.

Per questo strumento non è stato pubblicato alcuno schema di input.

google_ads_get_search_termsFetch search term performance from search_term_view or campaign_search_term_insight depending on reportType.

Fetch search term performance from search_term_view or campaign_search_term_insight depending on reportType.

Per questo strumento non è stato pubblicato alcuno schema di input.

google_ads_get_landing_pagesFetch landing_page_view performance with final URL, campaign/ad group context, traffic, conversion, and landing-page quality metrics when supported.

Fetch landing_page_view performance with final URL, campaign/ad group context, traffic, conversion, and landing-page quality metrics when supported.

Per questo strumento non è stato pubblicato alcuno schema di input.

google_ads_get_pmax_assetsList Performance Max asset group assets from asset_group_asset with asset group/campaign context and optional date-range performance metrics.

List Performance Max asset group assets from asset_group_asset with asset group/campaign context and optional date-range performance metrics.

Per questo strumento non è stato pubblicato alcuno schema di input.

google_ads_get_simulationsRead-only planning/forecast query for campaign, ad group, or portfolio bidding simulations. Returns simulation metadata and projected point lists when available, with a metadata fallback.

Read-only planning/forecast query for campaign, ad group, or portfolio bidding simulations. Returns simulation metadata and projected point lists when available, with a metadata fallback.

Per questo strumento non è stato pubblicato alcuno schema di input.

google_ads_get_paid_organic_search_termsRead-only paid/organic search terms report. Uses paid_organic_search_term_view when available and falls back to paid-only search_term_view if organic fields are unavailable.

Read-only paid/organic search terms report. Uses paid_organic_search_term_view when available and falls back to paid-only search_term_view if organic fields are unavailable.

Per questo strumento non è stato pubblicato alcuno schema di input.

google_ads_get_shopping_productsRead-only Merchant Center product catalog/eligibility report via shopping_product. Supports account, campaign, and ad group scopes with performance metrics when the account has Shopping/PMax e-commerce data.

Read-only Merchant Center product catalog/eligibility report via shopping_product. Supports account, campaign, and ad group scopes with performance metrics when the account has Shopping/PMax e-commerce data.

Per questo strumento non è stato pubblicato alcuno schema di input.

google_ads_get_shopping_performanceRead-only Shopping performance report keyed by Merchant Center product dimensions. Useful for joining spend/conversions to merchant ID, item ID, title, brand, feed label, and custom labels.

Read-only Shopping performance report keyed by Merchant Center product dimensions. Useful for joining spend/conversions to merchant ID, item ID, title, brand, feed label, and custom labels.

Per questo strumento non è stato pubblicato alcuno schema di input.

google_ads_get_pmax_placementsRead-only Performance Max placement diagnostics from performance_max_placement_view. Returns placement type, display name, target URL, campaign context, and impressions only.

Read-only Performance Max placement diagnostics from performance_max_placement_view. Returns placement type, display name, target URL, campaign context, and impressions only.

Per questo strumento non è stato pubblicato alcuno schema di input.

google_ads_get_pmax_asset_diagnosticsRead-only Performance Max asset group diagnostics. Returns ad strength, asset coverage action items, primary status reasons, optional performance metrics, and optional top asset combinations.

Read-only Performance Max asset group diagnostics. Returns ad strength, asset coverage action items, primary status reasons, optional performance metrics, and optional top asset combinations.

Per questo strumento non è stato pubblicato alcuno schema di input.

google_ads_rename_campaignprivilegiatoRename a Google Ads campaign. The name is the only thing that changes: delivery, budget and targeting are untouched. Previews by default.

Rename a Google Ads campaign. The name is the only thing that changes: delivery, budget and targeting are untouched. Previews by default.

Per questo strumento non è stato pubblicato alcuno schema di input.

google_ads_create_campaignCreate a Google Ads campaign. It is always created PAUSED and there is no option to create it active: someone has to look at it before it spends. Creates the campaign budget too. Previews by default.

Create a Google Ads campaign. It is always created PAUSED and there is no option to create it active: someone has to look at it before it spends. Creates the campaign budget too. Previews by default.

Per questo strumento non è stato pubblicato alcuno schema di input.

google_ads_update_campaign_budgetChange the daily budget of a Google Ads campaign. The amount is in the account currency (12.50 for 12.50 EUR). Previews by default.

Change the daily budget of a Google Ads campaign. The amount is in the account currency (12.50 for 12.50 EUR). Previews by default.

Per questo strumento non è stato pubblicato alcuno schema di input.

google_ads_update_adgroup_bidNessuna descrizione pubblicata

Questo strumento non ha pubblicato alcuna descrizione. Forge non se la inventa.

google_ads_update_campaign_scheduleNessuna descrizione pubblicata

Questo strumento non ha pubblicato alcuna descrizione. Forge non se la inventa.

34 strumenti su 36 hanno pubblicato una descrizione.

I nomi e le descrizioni degli strumenti sono scritti dal publisher e mostrati alla lettera come testo inerte. Sono le stringhe che un client MCP passa a un modello, quindi Forge vi cerca schemi di prompt injection — ogni rilievo compare insieme all’analisi di sicurezza qui sopra. «Privilegiato» è una corrispondenza di parola chiave sul nome dello strumento, non una verifica di ciò che fa: un nome innocuo può comunque fare qualsiasi cosa.

Descrizione

Open-source MCP server for the Google Ads API. 31 read tools and 7 write tools that preview before they apply, full Keyword Planner, Reach Planner and GAQL access. Self-hosted, bring your own credentials.

Parole chiave
mcpmcp-servermodel-context-protocolgoogle-adsgoogle-ads-apigaqlkeyword-planneradvertisingmarketing-analyticsclaudechatgptcursorai-agent
Alternative
Confronto delle superfici di strumenti…

Albero delle dipendenze

Ciò che una scansione di Forge ha risolto dai metadati npm il 2026-08-31: risoluzione osservata, non una dichiarazione dell'editore.

60 pacchetti risolti · 2 diretti · nessuno con avvisi di sicurezza La risoluzione si ferma alla profondità 4 e a 60 pacchetti.

La scansione si è fermata al limite di profondità 4. Tutto ciò che sta sotto quel livello non è mai stato risolto.

La scansione si è fermata al limite di 60 pacchetti. Il resto dell'albero non è mai stato risolto.

Altri 36 pacchetti risolti non vengono disegnati qui (limite di visualizzazione: 24). Ogni dipendenza con un avviso di sicurezza viene disegnata comunque. Inventario completo (SBOM CycloneDX)

Dichiarate ma non risolte

54 dipendenze dichiarate non sono mai arrivate nell'albero. Mancano dalla risoluzione di Forge, non dal pacchetto.

+42 altre non elencate. I conteggi per motivo qui sopra le comprendono tutte.

Non seguite: peerDependencies. Questo albero copre solo le dipendenze di runtime, quindi ciò che queste comportano non è mai stato risolto.

Argomenti

Correlati in analytics & dashboards