Google Ads Intent Mcp

@davidmosiah

About Google Ads Intent Mcp

Dry-run-first Google Ads search-term intent analyzer and negative-keyword MCP for agents.

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "google-ads-intent": {
      "command": "npx",
      "args": [
        "-y",
        "google-ads-intent-mcp"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Google Ads Intent MCP?

Google Ads Intent MCP is a dry-run-first search-term intent analyzer for agents that classifies Google Ads search terms and drafts negative-keyword plans without making live account changes. It is built for MCP clients like Codex, Claude, Cursor, Hermes, and OpenClaw, helping reduce wasted spend while protecting buyer-intent queries.

How to use Google Ads Intent MCP?

Install via pipx: pipx install google-ads-intent-mcp (or pipx install "google-ads-intent-mcp[mcp]" for MCP support). Then run the MCP server with google-ads-intent-mcp. Recommended first calls: google_ads_connection_status, google_ads_privacy_audit, google_ads_analyze_search_terms, and google_ads_build_negative_plan. The CLI offers commands like google-ads-intent manifest, doctor, privacy-audit, classify, analyze-csv, and plan-negatives.

Key features of Google Ads Intent MCP

Dry-run analysis of exported search-term CSVs
Classifies intent into waste, buyer, research, or competitor
Drafts negative-keyword plans without applying them
Privacy audit and connection status introspection tools
Deterministic heuristic with optional LLM refinement
Buyer/conversion terms automatically protected from exclusion

Use cases of Google Ads Intent MCP

Reduce wasted ad spend by identifying non-converting search terms
Safely generate negative keyword plans before making live changes
Protect buyer-intent queries from accidental exclusion
Automate search-term analysis in agent-driven ad workflows
Local CSV analysis without exposing account credentials to agents

FAQ from Google Ads Intent MCP

What does Google Ads Intent MCP do differently from alternatives?

It is dry-run-first: it never mutates Google Ads accounts directly. CSV analysis is local, and negative plans are drafted but not applied, making the safe path the default.

What are the runtime requirements?

Python 3.12+ with pipx. No API keys are required for the default heuristic classifier. An optional LLM refinement path requires OPENAI_API_KEY and the openai package.

Where does the data live?

All CSV analysis is performed locally. Search terms, costs, and clicks are processed on the user’s machine. OAuth tokens and developer tokens should remain in the local environment.

What are the known limits?

The current version (v0.1) does not perform live mutations. It only analyzes CSV exports. Negative keyword plans are dry-run only.

What transport and authentication does it use?

The MCP server uses stdio transport. It does not require authentication for the server itself; account credentials are handled externally via environment variables.

Frequently asked questions

What does Google Ads Intent MCP do differently from alternatives?

It is dry-run-first: it never mutates Google Ads accounts directly. CSV analysis is local, and negative plans are drafted but not applied, making the safe path the default.

What are the runtime requirements?

Python 3.12+ with pipx. No API keys are required for the default heuristic classifier. An optional LLM refinement path requires `OPENAI_API_KEY` and the `openai` package.

Where does the data live?

All CSV analysis is performed locally. Search terms, costs, and clicks are processed on the user’s machine. OAuth tokens and developer tokens should remain in the local environment.

What are the known limits?

The current version (v0.1) does not perform live mutations. It only analyzes CSV exports. Negative keyword plans are dry-run only.

What transport and authentication does it use?

The MCP server uses stdio transport. It does not require authentication for the server itself; account credentials are handled externally via environment variables.

Comments

Basic information

More Other MCP servers

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K

Peekaboo MCP – lightning-fast macOS screenshots for AI agents

steipete

Peekaboo is a macOS CLI & optional MCP server that enables AI agents to capture screenshots of applications, or the entire system, with optional visual question answering through local or remote AI models.

4.8K

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K

ghidraMCP

LaurieWired

MCP Server for Ghidra

9.4K