Ads MCP

Ads MCP

Remote MCP server for cross-platform ad campaign planning and creation with progress streaming.

1
Stars
0
Forks
0
Releases

Overview

Ads MCP is a remote Model Context Protocol (MCP) server for campaign planning, research, and cross-platform ad creation. It initially supports Google Ads (Search & Performance Max) and TikTok, with more networks planned. The platform enables users to plan and validate campaigns via structured prompts, generate creative variants, and assemble compliant asset bundles for end-to-end campaign deployment from MCP-enabled clients. It provides real-time progress updates for long-running operations through progress streaming (typically 5–30 seconds). Core tools include asset management (help_user_upload and validate_and_prepare_assets), which guide users to supply media links and returns an asset_bundle_id after downloading/validating assets, streaming progress when supported. Campaign creation tools include create_pmax_campaign (atomic, validate-then-commit with progress streaming) and create_search_campaign (text-first campaign creation with optional assets). The service enforces security via HTTPS, OAuth 2.1, and least-privilege scopes, supports safety annotations for tools, and implements limits and reliability measures including server-side rate limits, retry logic for image downloads, and token monitoring. Documentation and support contacts are provided via the project website and GitHub issues.

Details

Owner
amekala
Language
License
Updated
2025-12-07

Features

Progress Streaming (MCP 2025-03-26)

Protocol version negotiation with clients; Real-time progress updates via notifications/progress; Deterministic progress fields: stage, current, total, message; Supports _meta.progressToken for streaming.

Security

HTTPS URLs only; redirect cap; Private and non-routable destinations blocked; MIME sniffing and content-type checks enforced; OAuth 2.1 access tokens validated per request; Least-privilege scopes applied per operation.

Tool Safety Annotations

All tools include MCP safety metadata (_readOnlyHint, _destructiveHint, _title); Read-only tools clearly marked; Campaign creation tools non-destructive; Helps AI assistants understand tool safety characteristics.

Limits & Reliability

Server-side rate limits vary by paid tier; Time and size limits enforced per operation; Image download retry logic (2 attempts on 404); User-Agent header for CDN compatibility.

Audience

Advertisers/Marketing teamsPlan, validate, and create cross-platform ad campaigns via MCP-enabled clients.
MCP-enabled AI assistants (e.g., ChatGPT, Claude)Invoke MCP tools to generate campaigns and assets within conversational workflows.

Tags

MCPcampaign planningad creationGoogle AdsPerformance MaxTikTokasset managementasset bundlesprogress streamingSSEOAuth 2.1privacy and securitylong-running operations