このリポジトリには、 MCPサーバーは Google Ads API です。

道具

サーバーは Google Ads API いくつかの LLMやAIエージェントで使うためのツールとリソース。

利用可能なツール

• search:Google Adsアカウントに関する情報を取得します。
• get_resource_metadata:Google Ads APIリソースタイプ(例えば「campaign」)に関するメタデータを取得します。これはデータの構造やクエリ可能なフィールドを理解するのに役立ちます。
• list_accessible_customers:直接アクセス可能な顧客のIDを返品します 通話を認証するユーザーによって。

設定とネームスペーシングツール

Google Ads MCPサーバーは、tools_config.yamlを使って、個々のツールやツールカテゴリ(名前空間)を選択的に有効・無効にし、名前空間のプレフィックスをカスタマイズできます。

すべてのツールが有効化されたデフォルトのtools_config.yamlがパッケージにバンドルされているため、サーバーは追加のセットアップなしですぐに動作します。インストールをカスタマイズするために、サーバーは以下の順序で設定を解決します:

1. GOOGLE_ADS_MCP_TOOLS_CONFIG 環境変数を通じて明示的なパスを設定する。
2. A 'tools_config.

Google Ads MCP Server

This repo contains the source code for running an MCP server that interacts with the Google Ads API.

Tools

The server uses the Google Ads API to provide several Tools and Resources for use with LLMs and AI agents.

Tools available

• search: Retrieves information about the Google Ads account.
• get_resource_metadata: Retrieves metadata about a Google Ads API resource type, for example “campaign”. This is useful to understand the structure of the data and what fields are available for querying.
• list_accessible_customers: Returns ids of customers directly accessible by the user authenticating the call.

Configuring and Namespacing Tools

The Google Ads MCP server uses the tools_config.yaml to let you selectively enable or disable individual tools or tool categories (namespaces) and customize their namespace prefixes.

A default tools_config.yaml with all tools enabled is bundled with the package, so the server works out of the box with no extra setup. To customize your installation, the server resolves the configuration in the following order:

1. An explicit path set via the GOOGLE_ADS_MCP_TOOLS_CONFIG environment variable.
2. A tools_config.yaml file in the current working directory.
3. The default tools_config.yaml bundled with the package.

If an explicitly requested configuration file (via the environment variable) is missing, or any resolved file is invalid, the server raises an error and fails to start.

Configuration Example:

namespaces:
  # Option 1: Enable category 'customers' with default prefix -> "customers_list_accessible_customers"
  customers: true

  # Option 2: Enable category 'search' with a custom prefix -> "query_search"
  search: "query"

  # Option 3: Fine-grained control over tools in a category
  metadata:
    enabled: true
    prefix: "metadata"
    enabled_tools:
      - get_resource_metadata: true

Resources available

• discovery-document: Retrieve the Google Ads API discovery document. Provides the discovery document for the latest version of the Google Ads API, which describes the API surface, including resources, methods, and schemas. Host LLMs should access this resource to understand the structure of the Google Ads API and discover available features.
• metrics: Retrieve information about the metrics available for reporting in the Google Ads API.
• segments: Retrieve information about the segments available for reporting in the Google Ads API.
• release-notes: Retrieve the release notes for the latest version of the Google Ads API.

Notes

1. The MCP Server will expose your data to the Agent or LLM that you connect to it.