Skip to content
MCP server

PerfoAds MCP

Self-hosted Google Ads MCP server with 168 checks and approval-gated changes

Runs locallyStatus and history
Pricing
Open source
Platforms
self-hosted, macOS, Windows
Runs
Locally
Version
0.2.0-alpha.2
Listing updated
3 days ago

About PerfoAds MCP

PerfoAds MCP is an open-source MCP server for marketing and seo. It runs locally on your machine and is started by your AI client.

Everything runs on your own machine with your own Google Cloud project and sign-in, so, per the site, no data passes through PerfoAds. It has 25 tools: 14 read tools covering campaigns, ad groups, keywords, search terms, budgets, bidding, negative keywords, ads and assets, audiences, conversions and change history, and tools for checks and approvals.

The 168 checks involve no AI, so the same data gives the same result. A check that could not run says so rather than counting as clean, and the checks report evidence, not fix advice. Changes are off until switched on per account in a policy file that also sets spend limits and a kill switch. There are 14 kinds of change, most undoable for 30 days. A page opens in your browser showing the exact change; you approve with a 6-character code, and an AI saying yes approves nothing.

It is an early alpha, needs Node.js 22.13 or later, and the site says it is not made or endorsed by Google.

Install

Run in a terminal

claude mcp add mcp -- npx -y perfoads-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "perfoads-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "perfoads-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "perfoads-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "perfoads-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "perfoads-mcp"
      ]
    }
  }
}

Configuration

  • PERFOADS_MCP_HOMESettings folder (optional). Default ~/.config/perfoads-mcp, or %APPDATA%\perfoads-mcp on Windows. Never a folder your AI works in.

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

explain_check
Explains what a given check looks for and what it needs.

What it does

168 deterministic checks
Covers tracking, structure, budgets, Search, Performance Max and Shopping.
Read tools
14 tools read accounts including manager sub-accounts.
Approval by code
Changes need a code from a local page, outside the chat.
Policy file
Sets spend limits, budget step size and a kill switch.
Undo
Each change can be undone, most for 30 days.
Local only
Data goes between your computer and Google.

Good for

  • Find search terms that spend without a sale
  • Audit conversion tracking
  • Raise a budget within set limits after approval
  • Add negative keywords with a reviewable change

Pricing

Open source

Free, Apache-2.0; fix plans are in a separate paid app

Prices change. Check perfoads.com before you buy.

PerfoAds MCP FAQ

Does it cost anything?

No. The site says it is free and open source under Apache-2.0.

Does it work in ChatGPT on the web?

No. It works in Claude Desktop, Claude Code, the ChatGPT desktop app, Codex and Cursor.

Can the AI change my account by itself?

No. A human approves each change with a code on a page outside the model.

Is PerfoAds MCP free?

Yes. PerfoAds MCP is open source, so you can use and self-host it for free.

How do I add PerfoAds MCP to Claude Code?

Run this command in your terminal: claude mcp add mcp -- npx -y perfoads-mcp

What are the best alternatives to PerfoAds MCP?

The closest alternatives to PerfoAds MCP are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and Calven.

Alternatives to PerfoAds MCP

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  4. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  5. Calven

    MCP server

    Product marketing context from Calven delivered into Claude, ChatGPT and other AI tools

    Not checked yet
    • Remote
    • Free trial
    • 3 GitHub stars
    • Marketing and SEO
  6. CompanyData

    MCP server

    Search and enrich company records from official registers via the CompanyData API

    • 3 tools
    • Remote
    • Paid
    • 3 GitHub stars
    • Analytics and data