A read-only MCP server for retrieving and analysing Google Ads account data through Google's query language, including campaign and conversion reports.

Use it to query campaigns, search terms, Performance Max and AI Max data, conversions, change history, and available Google Ads API v24 fields.

It gives an agent a controlled way to inspect advertising data while keeping account changes disabled by default and recording access in an audit log.

quantum-ads — Skill for Claude Code and Codex by Casius999

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent

npx skills add Casius999/quantum-ads-mcp --skill quantum-ads

Clone the repo

git clone --depth 1 https://github.com/Casius999/quantum-ads-mcp

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/casius999/quantum-ads-mcp/quantum-ads/github.svg)](https://agentmods.dev/skills/casius999/quantum-ads-mcp/quantum-ads)

Your own site

<a href="https://agentmods.dev/skills/casius999/quantum-ads-mcp/quantum-ads"><img src="https://agentmods.dev/badge/skills/casius999/quantum-ads-mcp/quantum-ads/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/casius999/quantum-ads-mcp/quantum-ads"><img src="https://agentmods.dev/badge/skills/casius999/quantum-ads-mcp/quantum-ads.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 88 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 1,009 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00088	$0.01009
Opus 5	$0.00044	$0.00504
Sonnet 5	$0.00018	$0.00202
Haiku 4.5	$0.00009	$0.00101

Measured 9d ago against content hash 4e63a657db98, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

quantum-ads scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 9d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skill/quantum-ads/SKILL.md · 65 lines

How it starts

The opening of the file, as written. The whole thing — 65 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Quantum ADS — Google marketing agency control plane (MCP, June 2026)

A FastMCP (stdio) server exposing the Google marketing stack as MCP tools, on a shared sovereign core. SP0 (this release) ships the core + a read-only Google Ads v24 connector. Write planes and other connectors (GA4, GTM, Merchant, Data Manager, DV360/CM360/SA360, …) land in later sub-projects.

Architecture in one screen

Transport: FastMCP over stdio (mcp.server / FastMCP 3.4), launched by python -m quantum_ads.
Core (shared): multi-tenant auth + secret store (tokens never reach the LLM), version manager (pinned v24, sunset guard, unknown-enum tolerance), GAQL build/validate/run engine with quota governors, safety spine (read-only by default, signed audit ledger), connector registry + meta-tool discovery.
Connector (SP0): Google Ads read — GAQL passthrough, opinionated reports, change history, field catalogs.

When to use

Pull metrics/reports from a Google Ads account (GAQL).
Inspect campaigns/search terms/PMax/AI Max/conversions, change history, or the v24 field surface.
Know the current (June 2026) API reality and what is sunset.

Critical first facts (June 2026)

Google Ads API v24.1 is current; library google-ads 31; monthly releases. v19 sunset 2026-02-11; v20 sunset 2026-06-10. This server targets v24.
Three API planes exist now: Google Ads API (v24) + Data Manager API (1st-party data — Ads-API conversion upload blocked 2026-06-15) + Merchant API (Content API sunsets 2026-08-18). SP0 covers Google Ads reads only; the others are later sub-projects.
Details: references/google-ads-2026-sota.md.

Setup (auth) — env vars, no secrets on disk

Set environment variables (or a gitignored .env); the client loads via load_from_env:

GOOGLE_ADS_USE_PROTO_PLUS=True
GOOGLE_ADS_API_VERSION=v24
GOOGLE_ADS_DEVELOPER_TOKEN=...
GOOGLE_ADS_CLIENT_ID=....apps.googleusercontent.com
GOOGLE_ADS_CLIENT_SECRET=...
GOOGLE_ADS_REFRESH_TOKEN=...
GOOGLE_ADS_LOGIN_CUSTOMER_ID=     # MCC only
QUANTUM_ADS_READ_ONLY=true        # SP0 is read-only

Full flow + secret hygiene: references/auth-and-guardrails.md.

Read the full file on GitHub · 65 lines

Files

What ships with it

4 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

9d ago First seen · 65 lines · 88 tokens per session scan A 4e63a657db98

Subscribe to this mod's changes

quantum-ads is a skill published in the GitHub repository Casius999/quantum-ads-mcp (0 stars, last pushed 1mo ago), licensed MIT. It adds 88 tokens to every session and 1,009 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Analytics and metrics Marketing and SEO fastmcp google-ads google-ads-api marketing-automation mcp model-context-protocol

fastmcp-client-cli

Query and invoke tools on MCP servers using fastmcp list and fastmcp call. Use when you need to discover what tools a server offers, call tools, or integrate MCP servers into workflows.

PrefectHQ/fastmcp · 46 tokens

swag

This skill should be used when the user says "add proxy config", "create reverse proxy", "SWAG config", "nginx proxy", "expose service", "proxy configuration", "subdomain config", "subfolder config", "configure SWAG", "list proxy configs", "view proxy config", "edit proxy config", "remove proxy config", "check proxy…

jmagar/swag-mcp · 118 tokens

security-audit

Use when auditing a web app for security vulnerabilities. Triggers on: 'audit my project', 'how could this get hacked', 'find bugs in this codebase', 'security review', 'pentest', 'bug bounty scope for X', 'GHSA collaborator invite', 'security audit this'. Handles both internal audits (sitting in your own codebase…

msradam/theodosia · 250 tokens

quantum-ads