Google Ads MCP API
Full reference for all 35+ tools, API token authentication, and direct API access.
Available Tools
35+ functions organized by category. All tools are available through the MCP server.
Account & Customer Management
Access and manage Google Ads customer accounts
list_google_ads_customersList all Google Ads customer accounts accessible to the authenticated user
get_google_ads_account_infoGet detailed account information including status, currency, timezone, and settings
Campaigns
Create, read, update, and manage search campaigns
get_google_ads_campaignsGet campaigns with optional filtering by status, network settings, and bidding strategy
create_google_ads_campaignCreate a new campaign with budget, bidding strategy, and network settings (PAUSED by default)
update_google_ads_campaignUpdate campaign name, status, budget, and bidding strategy
pause_google_ads_campaignPause a running campaign
enable_google_ads_campaignEnable a paused campaign
Ad Groups
Manage ad groups within campaigns
get_google_ads_ad_groupsGet ad groups with optional campaign filtering and status details
create_google_ads_ad_groupCreate a new ad group with CPC bid settings (PAUSED by default)
update_google_ads_ad_groupUpdate ad group name, status, and bid amounts
Ads
Create and manage responsive search ads
get_google_ads_adsGet ads with full detail including type, URLs, headlines, and descriptions
create_google_ads_responsive_search_adCreate responsive search ads with multiple headlines and descriptions for A/B testing
pause_google_ads_adPause an individual ad
enable_google_ads_adEnable a paused ad
Keywords
Manage keywords with match types, quality scores, and bids
get_google_ads_keywordsGet keywords with quality scores, match types, and performance data
add_google_ads_keywordsAdd keywords with match types (EXACT, PHRASE, BROAD) and optional CPC bids
remove_google_ads_keywordsRemove keywords by criterion IDs
update_google_ads_keyword_bidUpdate CPC bids for individual or batch keywords
Negative Keywords
Block unwanted search terms at campaign or ad group level
add_google_ads_negative_keywordsAdd negative keywords at campaign or ad group level to block irrelevant traffic
get_google_ads_negative_keywordsRetrieve negative keywords with level filtering (campaign or ad group)
remove_google_ads_negative_keywordsRemove negative keywords by criterion IDs
Analytics & Performance
Access metrics with time-series breakdowns and segmentation
get_google_ads_campaign_metricsCampaign performance metrics with optional time-series breakdown
Supports day, week, month, and hour segmentation. Date ranges include TODAY, LAST_7_DAYS, LAST_30_DAYS, LAST_90_DAYS, and more.
get_google_ads_ad_group_metricsAd group performance with time-series segmentation support
get_google_ads_ad_metricsIndividual ad performance with time breakdown
get_google_ads_keyword_metricsKeyword performance including quality score components
get_google_ads_search_terms_reportSearch terms report showing actual user queries that triggered your ads
get_google_ads_geo_performanceGeographic performance breakdown by location
get_google_ads_device_performancePerformance by device type (mobile, desktop, tablet, connected TV)
get_google_ads_hour_of_day_performanceHourly breakdown showing peak performance times for bid scheduling
Extensions & Assets
Manage sitelinks, callouts, and structured snippets
get_google_ads_extensionsGet sitelinks, callouts, structured snippets, and call extensions
create_google_ads_sitelinkCreate sitelink extensions with descriptions and URLs
create_google_ads_calloutCreate callout extensions (max 25 characters)
create_google_ads_structured_snippetCreate structured snippets with predefined headers
update_google_ads_extension_statusUpdate extension status (ENABLED, PAUSED, or REMOVED)
remove_google_ads_extensionRemove extensions from campaigns
Audiences & Targeting
Manage audience segments and campaign targeting
get_google_ads_audiencesGet audience segments including remarketing, custom, combined, and demographics
add_google_ads_audience_to_campaignAdd audiences to campaigns with optional bid modifiers
Network & Settings
Control campaign network targeting
update_google_ads_network_settingsUpdate campaign network targeting (Search Network, Display Network, Search Partners)
Note: Display Network is disabled by default. Enabling it can significantly increase impressions but may reduce conversion quality.
Advanced: GAQL Queries
Execute raw Google Ads Query Language for custom reporting
execute_google_ads_gaql_queryExecute raw GAQL (Google Ads Query Language) queries for custom reporting and data extraction beyond what the pre-built tools offer
Full access to the Google Ads reporting API — query any resource, metric, or segment available in GAQL
API Tokens & Direct Access
For programmatic access, automation scripts, and direct API calls
If your MCP client requires an API token, or if you want to call the MCP server directly from code, you can use a Pipeboard API token for authentication.
1. Get your API token:
pipeboard.co/api-tokens →2. Use in your requests:
Option A: Authorization header
Authorization: Bearer YOUR_TOKENOption B: Query parameter
https://mcp.pipeboard.co/google-ads-mcp?token=pk_...Useful for MCP clients that don't support custom headers. Less secure as the token may appear in request logs — prefer the header option when possible.
Direct Testing with curl
For testing or debugging, you can call the MCP directly using the MCP protocol:
curl -X POST https://mcp.pipeboard.co/google-ads-mcp \\
-H "Content-Type: application/json" \\
-H "Accept: application/json, text/event-stream" \\
-H "Authorization: Bearer $PIPEBOARD_API_TOKEN" \\
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "list_google_ads_customers",
"arguments": {}
}
}'Replace $PIPEBOARD_API_TOKEN with your API token from pipeboard.co/api-tokens