What is Measure Paid Media MCP?

An open-source MCP server that lets an AI assistant audit campaigns, validate tracking, compare platforms and recommend optimisations across your paid-media stack — read-only and safe by design. It is part of the Measure AI ecosystem and depends on only measure-sdk (shared auth, config, logging and domain models); it never depends on another MCP.

"Audit all active campaigns from the last 30 days."
"Find campaigns with spend but no conversions."
"Compare Google Ads and Meta Ads ROAS for the last 14 days."
"Check if my conversion tracking pixels are healthy."
"Generate a paid media performance report by platform."
"What optimizations should I make this week?"

Relationship to Measure SDK

This product is a thin, focused layer on top of measure-sdk:

Shared result types — AuditFinding, Recommendation, Report, Metric, HealthScore, Connection, ValidationResult — all come from the SDK and are never redefined here.

Install

pip install measure-paid-media-mcp     # pulls measure-sdk automatically
measure login                          # Google OAuth (from the SDK)
measure doctor                         # what's connected
measure-paid-media                     # start the MCP server (stdio)

Configuration is optional and non-secret (defaults, thresholds, feature flags). For Google Ads, set MEASURE_ADS_DEVELOPER_TOKEN and MEASURE_ADS_CUSTOMER_ID. Credentials are never stored in .env.

Try it instantly (demo mode)

No account? Explore every tool with realistic sample data — no credentials:

MEASURE_PM_DEMO=true measure-paid-media

Demo mode serves sample Google Ads + Meta campaigns and tracking signals, so audit_campaigns, get_cross_channel_performance, generate_optimization_recommendations, etc. all return rich output. It is clearly labelled as DEMO in check_platform_health and never hits a live API.

Connect to Claude Desktop

See examples/claude_desktop/config.json.

Supported platforms

Adding a platform is a new connector under connectors/ implementing one Protocol — no engine or tool changes required.

MCP tools (MVP)

Architecture (Clean Architecture)

src/measure_paid_media/
├── core/          # domain: Campaign/TrackingSignal models, enums, connector PORT
├── config/        # settings (extends SDK CoreSettings; optional, non-secret)
├── connectors/    # infrastructure: one vertical per platform (implements the port)
│   ├── google_ads/  meta_ads/  linkedin_ads/  tiktok_ads/  microsoft_ads/  cm360/
├── engines/       # application: pure use cases → SDK domain models
│   ├── audit/  tracking/  reporting/  recommendations/  alerts/
├── services/      # orchestration: connectors → engines (the tools call this)
├── validators/    # input validation → SDK ValidationResult
├── mcp/           # interface: server.py + tools/ (one module per group)
└── cli/           # interface: the measure-paid-media entry point

Dependencies point inward: mcp/cli → services → engines → core; connectors implement core's port. Engines are pure and platform-agnostic, so the same audit rules run on every platform. See docs/architecture/overview.md.

Security & disclaimer

This MCP is read-only: it audits, analyses and recommends. It never modifies, pauses or rebudgets campaigns. Any future write capability will require preview → dry-run → explicit user confirmation → audit log, gated by the SDK's permission policy. See SECURITY.md.

Develop

git clone https://github.com/measure-mcp/measure-paid-media-mcp.git
cd measure-paid-media-mcp
python3.12 -m venv .venv && source .venv/bin/activate
pip install -e ../measure-sdk          # or the published measure-sdk
pip install -e ".[dev]"
ruff check . && ruff format --check . && mypy . && pytest

Ecosystem

See CHANGELOG.md · ROADMAP.md · SECURITY.md · CONTRIBUTING.md · CODE_OF_CONDUCT.md.

License

Apache-2.0. Contributions welcome.