@getmcpads/google-ads-mcp-server

MCPcomunidad
v1.0.2GetMCPAdsApache-2.0Actualizado hace 3 dnpmGitHub

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.

Funciona en
ClaudeCursorCopilotGemini

Inferido de los transportes que declara este listado (stdio). Que un cliente no aparezca aquí no significa que se haya descartado: simplemente Forge no puede confirmarlo.

Indexado automáticamente desde fuentes públicas. Aún sin verificar por su desarrollador en Forge.Reclamar este listado →
52Descargas/sem.
hace 3 dÚltima actualización
Necesita 3 credenciales antes de poder ejecutarse
  • GOOGLE_ADS_DEVELOPER_TOKENClave de APIobligatoria

    Google Ads API developer token, Basic Access or above.

  • GOOGLE_ADS_CLIENT_SECRETApp OAuthobligatoria

    OAuth client secret.

  • GOOGLE_ADS_REFRESH_TOKENApp OAuthobligatoria

    OAuth refresh token.

Declarado por el autor en el registro oficial de MCP. Forge does not store, broker, or ever see these values — the config below is scaffolded with placeholders you fill in locally.

Paquete
AutorGetMCPAds
LicenciaApache-2.0
Versión1.0.2
Fuentenpm+mcp-registry
Estado de confianza
B
60/100Bueno
Listado en el índice de Forge+10/10
Identidad del publicador verificada+0/20
Publicador: ejecuta `forge publish` desde el repo del paquete para reclamar la propiedad
Firma de publicación Ed25519+0/5
Se incluye automáticamente cuando el publicador ejecuta `forge publish`
Verificación de dominio+0/5
Publicador: aloja /.well-known/forge.json en la página del paquete con { "publisher": "<github-login>" }
npm Trusted Publishing (Sigstore)+0/5
Publica desde GitHub Actions con --provenance para que la attestation vincule este paquete a este repo
Coincidencia de maintainer en npm+0/5
Se consigue cuando tu identidad esté verificada arriba y ese login sea maintainer de este paquete en npm
Análisis CVE · limpio+30/30
Análisis estático · limpio+20/20
Pégalo en Claude Code, Cursor o cualquier asistente de IA para corregir todas las carencias
EstadoIndexado por la comunidad
PublicadorSin verificar
FirmaSin firmar
Dominio
Procedencia
Dependencias✓ 60 resueltas+ · ninguna vulnerable
Superficie de herramientas36 herramientas · 1 privilegiadas
Análisis de seguridad✓ Limpiov1.0.2 · hace 2 d¿Qué tan bien funciona este análisis?
EvaluacionesNinguna
Indexado31 ago 2026

La verificación confirma la identidad del publicador (la propiedad del repo), no la seguridad del código. El análisis de seguridad cubre los CVE conocidos y los scripts de instalación sospechosos.

Herramientas

36 herramientas · 1 privilegiadas
Extraído estáticamente del paquete publicadov1.0.2 · 2d ago

Leído del código que npm publica realmente, en el momento del análisis. El paquete nunca se ejecutó. Las herramientas registradas dinámicamente en tiempo de ejecución, o escondidas en código empaquetado o minificado, pueden pasarse por alto — así que esto es un mínimo de la superficie de herramientas, no un censo 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…

No se publicó ningún esquema de entrada para esta herramienta.

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.

No se publicó ningún esquema de entrada para esta herramienta.

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.

No se publicó ningún esquema de entrada para esta herramienta.

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…

No se publicó ningún esquema de entrada para esta herramienta.

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.

No se publicó ningún esquema de entrada para esta herramienta.

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.

No se publicó ningún esquema de entrada para esta herramienta.

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.

No se publicó ningún esquema de entrada para esta herramienta.

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.

No se publicó ningún esquema de entrada para esta herramienta.

google_ads_get_account_detailsGet detailed information for a specific Google Ads customer account.

Get detailed information for a specific Google Ads customer account.

No se publicó ningún esquema de entrada para esta herramienta.

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

No se publicó ningún esquema de entrada para esta herramienta.

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.

No se publicó ningún esquema de entrada para esta herramienta.

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.

No se publicó ningún esquema de entrada para esta herramienta.

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.

No se publicó ningún esquema de entrada para esta herramienta.

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.

No se publicó ningún esquema de entrada para esta herramienta.

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.

No se publicó ningún esquema de entrada para esta herramienta.

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.

No se publicó ningún esquema de entrada para esta herramienta.

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.

No se publicó ningún esquema de entrada para esta herramienta.

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.

No se publicó ningún esquema de entrada para esta herramienta.

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.

No se publicó ningún esquema de entrada para esta herramienta.

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.

No se publicó ningún esquema de entrada para esta herramienta.

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.

No se publicó ningún esquema de entrada para esta herramienta.

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.

No se publicó ningún esquema de entrada para esta herramienta.

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.

No se publicó ningún esquema de entrada para esta herramienta.

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.

No se publicó ningún esquema de entrada para esta herramienta.

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.

No se publicó ningún esquema de entrada para esta herramienta.

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.

No se publicó ningún esquema de entrada para esta herramienta.

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.

No se publicó ningún esquema de entrada para esta herramienta.

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.

No se publicó ningún esquema de entrada para esta herramienta.

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.

No se publicó ningún esquema de entrada para esta herramienta.

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.

No se publicó ningún esquema de entrada para esta herramienta.

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.

No se publicó ningún esquema de entrada para esta herramienta.

google_ads_rename_campaignprivilegiadaRename 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.

No se publicó ningún esquema de entrada para esta herramienta.

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.

No se publicó ningún esquema de entrada para esta herramienta.

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.

No se publicó ningún esquema de entrada para esta herramienta.

google_ads_update_adgroup_bidSin descripción publicada

Esta herramienta no publicó ninguna descripción. Forge no se la inventa.

google_ads_update_campaign_scheduleSin descripción publicada

Esta herramienta no publicó ninguna descripción. Forge no se la inventa.

34 de 36 herramientas publicaron una descripción.

Los nombres y descripciones de las herramientas los escribe el publicador y se muestran literalmente como texto inerte. Son las cadenas que un cliente MCP pasa al modelo, así que Forge las analiza en busca de patrones de inyección de prompts — cualquier hallazgo aparece junto al análisis de seguridad de arriba. «Privilegiada» es una coincidencia de palabra clave en el nombre de la herramienta, no una auditoría de lo que hace: un nombre inofensivo puede hacer cualquier cosa.

Acerca de

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.

Palabras clave
mcpmcp-servermodel-context-protocolgoogle-adsgoogle-ads-apigaqlkeyword-planneradvertisingmarketing-analyticsclaudechatgptcursorai-agent
Alternativas
Comparando superficies de herramientas…

Árbol de dependencias

Lo que un análisis de Forge resolvió a partir de los metadatos de npm el 2026-08-31: resolución observada, no una declaración del publicador.

60 paquetes resueltos · 2 directos · ninguno con avisos de seguridad La resolución se detiene en la profundidad 4 y en 60 paquetes.

El rastreo se detuvo en el límite de profundidad 4. Nada por debajo de ese nivel llegó a resolverse.

El rastreo se detuvo en el límite de 60 paquetes. El resto del árbol nunca se resolvió.

Hay 36 paquetes resueltos más que no se dibujan aquí (límite de visualización: 24). Toda dependencia con avisos de seguridad se dibuja aunque se supere el límite. Inventario completo (SBOM CycloneDX)

Declaradas pero no resueltas

54 dependencias declaradas nunca llegaron al árbol. Faltan en la resolución de Forge, no en el paquete.

+42 más sin listar. Los recuentos por motivo de arriba las incluyen todas.

No se siguen: peerDependencies. Este árbol cubre solo dependencias en tiempo de ejecución, así que lo que estas arrastren nunca se resolvió.

Temas

Relacionados en analytics & dashboards