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.
基本信息
配置
使用下面的配置,将此服务器添加到你的 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"
}
}
}
}工具
24List 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 与智能体 分类下的更多 MCP 服务器
Shell and Coding agent for Claude and other mcp clients
rusiaamanShell and coding agent on mcp clients
Open Multi-Agent Canvas
CopilotKitThe open-source multi-agent chat interface that lets you manage multiple agents in one dynamic conversation and add MCP servers for deep research
🛡️ A.I.G（AI-Infra-Guard）
TencentA full-stack AI Red Teaming platform securing AI ecosystems via OpenClaw Security Scan, Agent Scan, Skills Scan, MCP scan, AI Infra scan and LLM jailbreak evaluation.
Web Agent Protocol
OTA-Tech-AI🌐Web Agent Protocol (WAP) - Record and replay user interactions in the browser with MCP support
Hass-MCP
voskaControl and query Home Assistant from Claude and other LLMs — a Model Context Protocol (MCP) server.
评论