Can I use Google Ads as a CLI?

Yes. KosmoKrator exposes a Google Ads CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Google Ads through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Google Ads tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Google Ads credentials stored?

Google Ads credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Google Ads MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

analytics

Google Ads MCP Integration for Vercel AI SDK

Connect Google Ads to Vercel AI SDK 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 Vercel AI SDK

Use KosmoKrator as a local integration gateway for Vercel AI SDK agents and scripts.

Create an MCP client that starts or connects to the KosmoKrator gateway for the selected integration. The gateway is local, scoped to this integration, and starts with --write=deny so Vercel AI SDK can inspect read-capable tools without receiving write access by default.

Google Ads MCP Config for Vercel AI SDK

Prefer CLI JSON calls when a workflow only needs one deterministic integration operation.

{
  "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 Vercel AI SDK

Vercel AI SDK sees stable MCP tool names generated from the Google Ads integration catalog.

MCP tool	Source function	Type	Description
`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 Vercel AI SDKClient-level gateway setup.