KosmoKrator

analytics

Google Ads MCP Integration for Generic MCP Clients

Connect Google Ads to Generic MCP Clients through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

38 functions 18 read 20 write oauth2 with developer token auth
Submit Google Ads feedback View package source

Connect Google Ads to Generic MCP Clients

Connect any stdio-compatible MCP client to local KosmoKrator integration tools.

Register kosmo mcp:serve as the command for a local stdio MCP server. The gateway is local, scoped to this integration, and starts with --write=deny so MCP clients can inspect read-capable tools without receiving write access by default.

Google Ads MCP Config for Generic MCP Clients

Start with read-only write policy and expand only for trusted projects.

{
  "mcpServers": {
    "kosmokrator-google_ads": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=google_ads",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=google_ads --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only Google Ads instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

Google Ads Tools Visible to MCP clients

MCP clients sees stable MCP tool names generated from the Google Ads integration catalog.

MCP toolSource functionTypeDescription
integration__google_ads__google_ads_diagnostics google_ads.google_ads_diagnostics Read Show safe configuration diagnostics.
integration__google_ads__google_ads_list_accessible_customers google_ads.google_ads_list_accessible_customers Read List Google Ads customers directly accessible to the OAuth user.
integration__google_ads__google_ads_list_customer_clients google_ads.google_ads_list_customer_clients Read List managed client accounts under a manager or customer.
integration__google_ads__google_ads_search google_ads.google_ads_search Read Run a paginated Google Ads Query Language search.
integration__google_ads__google_ads_search_stream google_ads.google_ads_search_stream Read Run a streaming GAQL report for larger result sets.
integration__google_ads__google_ads_campaign_report google_ads.google_ads_campaign_report Read Run a normalized campaign performance report.
integration__google_ads__google_ads_ad_group_report google_ads.google_ads_ad_group_report Read Run a normalized ad group performance report.
integration__google_ads__google_ads_ad_report google_ads.google_ads_ad_report Read Run an ad and creative performance report.
integration__google_ads__google_ads_keyword_report google_ads.google_ads_keyword_report Read Run a keyword performance report.
integration__google_ads__google_ads_search_term_report google_ads.google_ads_search_term_report Read Analyze search terms and query performance.
integration__google_ads__google_ads_asset_report google_ads.google_ads_asset_report Read Report on assets and policy/performance labels.
integration__google_ads__google_ads_performance_max_report google_ads.google_ads_performance_max_report Read Report on Performance Max campaigns and asset groups.
integration__google_ads__google_ads_list_campaigns google_ads.google_ads_list_campaigns Read List campaigns with status, budget, channel, and optimization fields.
integration__google_ads__google_ads_create_campaign_budget google_ads.google_ads_create_campaign_budget Write Create a campaign budget with micros normalization.
integration__google_ads__google_ads_manage_campaign google_ads.google_ads_manage_campaign Write Create, update, pause, enable, or remove campaigns.
integration__google_ads__google_ads_manage_ad_group google_ads.google_ads_manage_ad_group Write Create, update, pause, enable, or remove ad groups.
integration__google_ads__google_ads_manage_keyword google_ads.google_ads_manage_keyword Write Add, update, or remove keyword criteria.
integration__google_ads__google_ads_manage_ad google_ads.google_ads_manage_ad Write Create or manage responsive search ads and ad statuses.
integration__google_ads__google_ads_manage_campaign_criteria google_ads.google_ads_manage_campaign_criteria Write Add or remove location, language, schedule, and negative criteria.
integration__google_ads__google_ads_upload_image_asset google_ads.google_ads_upload_image_asset Write Create image assets from pre-encoded image metadata.
integration__google_ads__google_ads_link_asset google_ads.google_ads_link_asset Write Link an asset to a customer, campaign, ad group, or asset group.
integration__google_ads__google_ads_create_search_campaign google_ads.google_ads_create_search_campaign Write Create a complete paused Search campaign with budget, ad group, keywords, targets, and RSA.
integration__google_ads__google_ads_create_performance_max_campaign google_ads.google_ads_create_performance_max_campaign Write Create a governed Performance Max campaign using mixed mutate operations.
integration__google_ads__google_ads_generate_keyword_ideas google_ads.google_ads_generate_keyword_ideas Read Generate keyword ideas and forecasts inputs.
integration__google_ads__google_ads_list_recommendations google_ads.google_ads_list_recommendations Read List optimization recommendations.
integration__google_ads__google_ads_apply_recommendations google_ads.google_ads_apply_recommendations Write Apply selected recommendations with explicit confirmation.
integration__google_ads__google_ads_upload_click_conversions google_ads.google_ads_upload_click_conversions Write Upload offline or enhanced lead click conversions.
integration__google_ads__google_ads_upload_call_conversions google_ads.google_ads_upload_call_conversions Write Upload offline call conversions.
integration__google_ads__google_ads_create_customer_match_list google_ads.google_ads_create_customer_match_list Write Create a CRM-based user list for Customer Match.
integration__google_ads__google_ads_run_customer_match_job google_ads.google_ads_run_customer_match_job Write Create, populate, and run an OfflineUserDataJob for audience uploads.

Showing 30 of 38 functions. See the Google Ads MCP reference for the full list.

Related Google Ads Pages

Google Ads CLIUse direct JSON commands instead of MCP discovery. Google Ads MCPFull gateway reference and MCP tool names. KosmoKrator for MCP clientsClient-level gateway setup.