Google has open-sourced a Mannequin Context Protocol (MCP) server that exposes read-only entry to the Google Advertisements API for agentic and LLM purposes. The repository googleads/google-ads-mcp implements an MCP server in Python that surfaces two instruments right this moment: search (GAQL queries over Advertisements accounts) and list_accessible_customers (enumeration of buyer sources). It consists of setup through pipx, Google Advertisements developer tokens, OAuth2 scopes (https://www.googleapis.com/auth/adwords), and Gemini CLI / Code Help integration by way of a normal MCP consumer configuration. The venture is labeled “Experimental.”
So, why it issues?
MCP is rising as a typical interface for wiring fashions to exterior techniques. By delivery a reference server for the Advertisements API, Google lowers the mixing value for LLM brokers that want marketing campaign telemetry, price range pacing, and efficiency diagnostics with out bespoke SDK glue.
The way it works? (developer view)
- Protocol: MCP standardizes “instruments” that fashions can invoke with typed parameters and responses. The Advertisements MCP server advertises instruments mapped to Google Advertisements API operations; MCP shoppers (Gemini CLI/Code Help, others) uncover and name them throughout a session.
- Auth & scopes: You allow the Google Advertisements API in a Cloud venture, get hold of a developer token, and configure Software Default Credentials or the Advertisements Python consumer. Required scope is
adwords. For manager-account hierarchies, set a login buyer ID. - Consumer wiring: Add a
~/.gemini/settings.jsonentry pointing to the MCP server invocation (pipx run git+https://github.com/googleads/google-ads-mcp.git google-ads-mcp) and go credentials through env vars. Then question through/mcpin Gemini or by prompting for campaigns, efficiency, and so forth.
Ecosystem sign
Google’s server arrives amid broader MCP adoption throughout distributors and open-source shoppers, reinforcing MCP as a practical path to agent-to-SaaS interoperability. For PPC and progress groups experimenting with agentic workflows, the reference server is a low-friction solution to validate LLM-assisted QA, anomaly triage, and weekly reporting with out granting write privileges.
Key Takeaways
- Google open-sourced a read-only Google Advertisements API MCP server, showcasing two instruments:
search(GAQL) andlist_accessible_customers. - Implementation particulars: Python venture on GitHub (
googleads/google-ads-mcp), Apache-2.0 license, marked Experimental; set up/run throughpipxand configure OAuth2 with thehttps://www.googleapis.com/auth/adwordsscope (dev token + non-compulsory login-customer ID). - Works with MCP-compatible shoppers (e.g., Gemini CLI / Code Help) so brokers can problem GAQL queries and analyze Advertisements accounts by way of natural-language prompts.
Conclusion
In sensible phrases, Google’s open-sourced Google Advertisements API MCP server offers groups a standards-based, read-only path for LLM brokers to run GAQL queries towards Advertisements accounts with out bespoke SDK wiring. The Apache-licensed repo is marked experimental, exposes search and list_accessible_customers, and integrates with MCP shoppers like Gemini CLI/Code Help; manufacturing use ought to account for OAuth scope (adwords), developer token administration, and the data-exposure caveat famous within the README.
Try the GitHub Web page and technical weblog. Be at liberty to take a look at our GitHub Web page for Tutorials, Codes and Notebooks. Additionally, be at liberty to comply with us on Twitter and don’t overlook to hitch our 100k+ ML SubReddit and Subscribe to our Publication. Wait! are you on telegram? now you possibly can be part of us on telegram as nicely.
Michal Sutter is an information science skilled with a Grasp of Science in Information Science from the College of Padova. With a stable basis in statistical evaluation, machine studying, and knowledge engineering, Michal excels at remodeling complicated datasets into actionable insights.
