이 저장소에는 실행 시 MCP 서버는 구글 광고 API.

도구

서버는 구글 광고 API 여러 명을 제공하기 위해 LLM 및 AI 에이전트와 함께 사용할 수 있는 도구와 자원.

사용 가능한 도구

• search: 구글 광고 계정 정보를 조회합니다.
• get_resource_metadata: 예를 들어 "캠페인"과 같은 구글 광고 API 리소스 유형에 대한 메타데이터를 검색합니다. 이는 데이터 구조와 쿼리 가능한 필드를 이해하는 데 유용합니다.
• 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.