Google Ads Transparency MCP

Competitor Google ads from the Google Ads Transparency Center: new, running and stopped, with shown dates.

Hosted MCP Server

npx add-mcp 'https://mcp.apify.com?tools=publicrecords/google-ads-transparency-scraper'

Installs into Claude Code, Codex, Cursor and more

Documentation

Google Ads Transparency MCP: Competitor Ads

An MCP server that tells your AI assistant which Google ads a competitor is running. Give it a website domain (nike.com), a Google advertiser ID, an Ads Transparency Center link or an exact advertiser name, and it returns the ads Google lists for that advertiser: which are new, still running or stopped in your look-back window, with first and last shown dates, days shown and links to each ad. Filter by country, or leave it on "anywhere". No Google login and no proxy setup.

Built on the public Google Ads Transparency Center data, via the Apify Actor Google Ads Transparency Scraper.

Apify Store: https://apify.com/publicrecords/google-ads-transparency-scraper
MCP server: https://mcp.apify.com?tools=publicrecords/google-ads-transparency-scraper

Example prompts

"Which Google ads did nike.com start running in the last 7 days in the US?"
"Compare the ads running right now for hubspot.com and salesforce.com."
"List the ads my competitor stopped this month, with first and last shown dates."

Tool

Tool	Input	Output
`publicrecords--google-ads-transparency-scraper`	`targets` (domains, advertiser IDs, Transparency Center links or names), `sinceDays`, `region`, `statuses`	One row per ad: advertiser, ad ID, format (text, image, video), status, first and last shown dates, days shown, target domain and the ad link

The full input schema is in tools.json, generated from the Actor's public input schema and checked for drift daily.

MCP endpoint

https://mcp.apify.com?tools=publicrecords/google-ads-transparency-scraper

Transport: Streamable HTTP (hosted by Apify, see https://docs.apify.com/mcp).

Auth

Sign in with Apify OAuth when your client prompts you, or send the header Authorization: Bearer <APIFY_TOKEN> where <APIFY_TOKEN> is your own Apify API token. Never commit a real token.

Client setup

Claude

Claude Code:

claude mcp add --transport http google-ads-transparency "https://mcp.apify.com?tools=publicrecords/google-ads-transparency-scraper"

Claude Desktop / claude.ai: Settings → Connectors → Add custom connector, and paste the MCP endpoint URL above.

Cursor

~/.cursor/mcp.json:

{
  "mcpServers": {
    "google-ads-transparency": {
      "url": "https://mcp.apify.com?tools=publicrecords/google-ads-transparency-scraper"
    }
  }
}

VS Code

.vscode/mcp.json:

{
  "servers": {
    "google-ads-transparency": {
      "type": "http",
      "url": "https://mcp.apify.com?tools=publicrecords/google-ads-transparency-scraper"
    }
  }
}

To use a token instead of OAuth, add "headers": { "Authorization": "Bearer <APIFY_TOKEN>" } next to "url".

Disclosure: I maintain this Actor.

Local stdio server (open source)

This repo also ships a small MCP server in src/ for clients that only run local stdio servers. It answers initialize and tools/list locally from tools.json, which is generated from each Actor's public input schema and checked for drift in CI and weekly, so any client or directory can inspect the tools with no token. tools/call is forwarded to the hosted Apify MCP endpoint above with your own APIFY_TOKEN; without a token a call returns a clear error instead of running anything. The token is only sent in the Authorization header and is never logged.

{
  "mcpServers": {
    "google-ads-transparency": {
      "command": "npx",
      "args": ["-y", "github:GeminiGeorge22/google-ads-transparency-mcp"],
      "env": { "APIFY_TOKEN": "YOUR_APIFY_TOKEN" }
    }
  }
}

Or from a clone:

git clone https://github.com/GeminiGeorge22/google-ads-transparency-mcp.git
cd google-ads-transparency-mcp && npm install
APIFY_TOKEN=YOUR_APIFY_TOKEN node src/server.js

Optional env: APIFY_ACTORS (comma-separated subset of the Actors above) and APIFY_MCP_URL (full endpoint override).

Tests run against an in-memory mock server, with no network and no token: npm test. Requires Node.js 18+.

Python (uvx/pip)

A matching Python version of this server lives in python/, built on the official mcp Python SDK: same tools, same APIFY_TOKEN, same hosted endpoint. Requires Python 3.10+.

{
  "mcpServers": {
    "google-ads-transparency": {
      "command": "uvx",
      "args": ["google-ads-transparency-mcp-server"],
      "env": { "APIFY_TOKEN": "YOUR_APIFY_TOKEN" }
    }
  }
}

Or with pip: pip install google-ads-transparency-mcp-server, then run google-ads-transparency-mcp-server. Python tests: cd python && pip install -e ".[test]" && env -u APIFY_TOKEN python -m pytest.