MCP Server

Claude Google Ads

Point Claude at your Google Ads account and ask it questions in English. The Adscriptly MCP server answers with real account data — 56 tools covering search terms, auction insights, keywords, assets, change history and raw GAQL. Reads are the default. Writes are a separate scope your client asks you to approve.

Connect Claude to Google Ads Read the setup docs

Three steps, no API keys

The endpoint is hosted. You add it once as a remote MCP server, sign in through Adscriptly, and the account context follows the conversation.

Claude.ai

Customize → Connectors → Add custom connector.
Paste https://adscriptly.com/api/mcp, select Connect, then sign in to Adscriptly.

Claude Code

claude mcp add --transport http adscriptly https://adscriptly.com/api/mcp
claude mcp login adscriptly

ChatGPT

Settings → Security and login → Developer mode.
Create an app at chatgpt.com/plugins with https://adscriptly.com/api/mcp as the server URL.

56 tools Claude can call

Every name below is a tool the server actually exposes. Claude picks the one your question needs; you never learn the names.

Ask anything

Raw GAQL plus the resource map the model needs to compose a query it has never seen.

run_gaql
execute_gaql_query
list_gaql_resources
list_accounts
get_account_currency
generate_report_file

Where the money went

Spend and outcomes at every level, without exporting a single CSV.

get_campaign_performance
get_ad_group_report
get_keyword_report
get_keyword_performance
get_search_terms_report
get_landing_page_report
get_placement_report

Who saw it

Every segment Google will break performance down by.

get_device_report
get_location_report
get_user_location_report
get_age_report
get_gender_report
get_income_report
get_parental_report
get_schedule_report

Creative and assets

Down to which RSA headline is carrying the ad group.

get_ad_performance
get_ad_creatives
get_rsa_ad_performance_report
get_asset_performance_report
get_image_assets
get_image_asset_urls
get_asset_usage
analyze_image_assets
get_extension_inventory

Competitive and diagnostic

Impression share, overlap, and who changed what, when.

get_auction_insights
get_keyword_metrics
get_keyword_ideas
get_keyword_kpis
get_change_history
get_campaign_settings
get_live_campaign_statuses
get_live_ad_group_statuses

Conversions

Including the outcomes Adscriptly sent back, not just the ones Google counted.

get_conversion_analytics
get_conversion_stats
get_conversion_action_report
get_call_details_report
get_dashboard_analytics
get_adscriptly_search_terms

Changes, behind approvalapproval

A separate scope, annotated destructive, surfaced by the client for approval.

execute_mutate
execute_gtm_mutate
apply_negative_keywords
approve_negative_keywords
approve_positive_keywords
dismiss_negative_keywords
get_pending_negative_keywords
get_pending_positive_keywords
get_negative_keyword_agent_status
get_gtm_tags
get_sync_status
trigger_sync

What it is allowed to do

Read and write are different scopes, and the client is told which is which.

Authentication: OAuth 2.1, Dynamic Client Registration, S256 PKCE. No API keys in a config file.
Google credentials: Never handed to the model. The server holds the connection; the client holds a token for Adscriptly.
Reads: Available as soon as you pick an account for the conversation.
Writes: A separate scope. Annotated as destructive so the client asks before it runs.
Entitlement: Checked on every request. An expired trial stops answering instead of degrading quietly.

Questions

Does Claude get write access to my Google Ads account?

Not by default. Read tools and write tools are separate scopes. Writes run through execute_mutate, which is annotated as a destructive operation so the client surfaces it for approval before anything changes in the account.

Which Claude clients work with it?

Any client that speaks remote MCP over HTTP. Claude.ai adds it under Customize → Connectors → Add custom connector, and Claude Code adds it with claude mcp add --transport http. ChatGPT connects through the same endpoint in developer mode.

How does it authenticate?

OAuth 2.1 with Dynamic Client Registration and S256 PKCE. You sign in to Adscriptly once from inside the client; no API keys are pasted into a config file, and no Google credentials are handed to the model.

Can Claude write GAQL against my account?

Yes. run_gaql and execute_gaql_query take a raw GAQL string, and list_gaql_resources tells the model which resources and fields it is allowed to select from, so it can compose a query it has not seen before.

What does it cost?

The MCP server is included with any paid plan or an unexpired free trial. Every request checks for an active plan, so an expired trial stops answering rather than degrading silently.

Ask your ad account a question.

Free for 7 days, then $129/mo. We'll remind you 3 days before your first charge. Cancel anytime.

Get Started For Free Read the docs