MCP.so
ログイン

Google Ad Manager MCP

@MatiousCorp

Google Ad Manager MCP について

MCP server for Google Ad Manager. Manage ad campaigns, orders, line items, and creatives through AI assistants like Claude, ChatGPT, and Cursor. Automate GAM operations with natural language.

基本情報

カテゴリ

AI とエージェント

トランスポート

stdio

公開者

MatiousCorp

投稿者

Youssef BOUSSAFA

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "google-ad-manager": {
      "command": "uvx",
      "args": [
        "google-ad-manager-mcp"
      ],
      "env": {
        "GAM_CREDENTIALS_PATH": "/path/to/credentials.json",
        "GAM_NETWORK_CODE": "YOUR_NETWORK_CODE"
      }
    }
  }
}

ツール

24

List all orders with line items currently delivering ads. Returns a list of orders with their delivering line items, including impression and click statistics.

Get order details by ID or name. Args: order_id: The order ID (optional if order_name provided) order_name: The order name to search for (optional if order_id provided) Returns order details including all line items.

Create a new order for an advertiser. Args: order_name: Name for the new order advertiser_id: ID of the advertiser company Returns the created order details.

Find an existing order by name or create a new one. Args: order_name: Name of the order advertiser_id: ID of the advertiser company Returns the existing or newly created order.

Get line item details by ID. Args: line_item_id: The line item ID Returns line item details including status, dates, and statistics.

Create a new line item for an order. Args: order_id: The order ID to add line item to name: Line item name end_year: End date year (e.g., 2025) end_month: End date month (1-12) end_day: End date day (1-31) target_ad_unit_id: Ad unit ID to target (find via GAM UI or ad unit tools) line_item_type: Type of line item (STANDARD, SPONSORSHIP, etc.) goal_impressions: Impression goal (default: 100000) Returns the created line item details.

Duplicate an existing line item. Args: source_line_item_id: ID of the line item to duplicate new_name: Name for the new line item rename_source: Optional new name for the source line item Returns both the source and new line item details.

Update a line item's name. Args: line_item_id: The line item ID new_name: New name for the line item Returns the updated line item details.

List all line items for an order. Args: order_id: The order ID Returns list of line items with their status and statistics.

Upload an image creative to Ad Manager. Args: file_path: Path to the image file advertiser_id: ID of the advertiser click_through_url: Destination URL when clicked creative_name: Optional name for the creative override_size_width: Optional width to override the creative size (for serving into a different sized slot) override_size_height: Optional height to override the creative size (for serving into a different sized slot) The creative size is extracted from the filename (e.g., '300x250' in 'banner_300x250.png'). Use override_size_width and override_size_height together to serve a creative into a different sized placement (e.g., serve a 970x250 image into a 1000x250 slot). Returns the created creative details.

Associate a creative with a line item. Args: creative_id: The creative ID line_item_id: The line item ID size_override_width: Optional width for size override size_override_height: Optional height for size override Returns the association details.

Upload a creative and associate it with a line item in one step. Args: file_path: Path to the image file advertiser_id: ID of the advertiser line_item_id: ID of the line item click_through_url: Destination URL when clicked creative_name: Optional name for the creative Returns the creative and association details.

Upload all creatives from a folder and associate with a line item. Args: folder_path: Path to folder containing image files advertiser_id: ID of the advertiser line_item_id: ID of the line item click_through_url: Destination URL when clicked name_prefix: Optional prefix for creative names Supported formats: jpg, jpeg, png, gif. Returns results for all uploads.

Get creative details by ID. Args: creative_id: The creative ID Returns creative details including size and destination URL.

List creatives for an advertiser. Args: advertiser_id: The advertiser ID limit: Maximum number of creatives to return (default: 100) Returns list of creatives.

Find an advertiser by name (partial match). Args: name: Advertiser name to search for Returns list of matching advertisers.

Get advertiser details by ID. Args: advertiser_id: The advertiser/company ID Returns advertiser details.

List all advertisers. Args: limit: Maximum number of advertisers to return (default: 100) Returns list of advertisers.

Create a new advertiser. Args: name: Advertiser name email: Optional email address address: Optional address Returns the created advertiser details.

Find an advertiser by exact name or create if not found. Args: name: Exact advertiser name email: Optional email (used if creating) Returns the existing or newly created advertiser.

Verify line item setup including creative placeholders and associations. Args: line_item_id: The line item ID to verify Checks: - Creative placeholders (expected sizes) - Creative associations - Size mismatches between creatives and placeholders Returns verification results with any issues found.

Check detailed delivery status for a line item. Args: line_item_id: The line item ID to check Returns delivery progress including impressions, clicks, and goal progress.

Verify complete order setup including all line items. Args: order_id: The order ID to verify Returns comprehensive verification of the order and all its line items.

Create a complete campaign: find/create advertiser, order, line item, and upload creatives. Args: advertiser_name: Name of the advertiser order_name: Name for the order line_item_name: Name for the line item end_year: End date year end_month: End date month (1-12) end_day: End date day (1-31) creatives_folder: Path to folder containing creative images click_through_url: Destination URL for all creatives target_ad_unit_id: Ad unit ID to target (find via GAM UI or ad unit tools) goal_impressions: Impression goal (default: 100000) This is a complete workflow that: 1. Finds or creates the advertiser 2. Finds or creates the order 3. Creates the line item 4. Uploads all creatives from the folder 5. Associates creatives with the line item Returns complete campaign creation results.

概要

What is Google Ad Manager MCP?

Google Ad Manager MCP is an MCP server that integrates with Google Ad Manager's API to provide programmatic management of orders, line items, creatives, advertisers, and campaign workflows. It is built for developers and operators who need to automate Ad Manager tasks.

How to use Google Ad Manager MCP?

Build the Docker image with docker build -t google-ad-manager-mcp ., then add it to your MCP client configuration (Claude Desktop, Cursor, etc.). A service account JSON credential file and API access are required.

Key features of Google Ad Manager MCP?

  • Order management – list, create, and manage orders
  • Line item management – create, duplicate, configure line items
  • Creative management – upload images, bulk upload, associate with line items
  • Advertiser management – find, create, list advertisers
  • Verification tools – verify setup, check delivery status
  • Campaign workflow – complete campaign creation in one operation

Use cases of Google Ad Manager MCP?

  • Automate order and line item creation for ad campaigns
  • Bulk upload creatives and associate them with line items
  • Verify campaign setup and monitor delivery status
  • Manage advertisers and their relationships programmatically

FAQ from Google Ad Manager MCP

What are the runtime requirements for this server?

Google Ad Manager account with API access, service account JSON credentials, and Docker installed.

How many tools does the server provide?

The server provides 24 tools covering orders, line items, creatives, advertisers, verification, and workflows.

Who built this server?

The server was built by Matious, a company that builds custom AI tools and MCP servers.

How do I set up and run the server?

Build the Docker image using docker build -t google-ad-manager-mcp ., then add it to your MCP client config.

コメント

「AI とエージェント」の他のコンテンツ