# LoomaScale Ads

Runs Google Ads accounts from Claude Code with strict budget protection. Helps audit wasted ad spend and draft campaigns safely.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Author: loomascale
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/loomascale/ads-mcp
- Updated: 2026-10-05
- HTML: https://affpapa.org/en/nevibecode/mcp/loomascale-ads

## What it does

This server supplies 42 tools interfacing directly with the Google Ads API. It lets an agent review account performance, conduct keyword discovery, generate Performance Max assets, and adjust bids. The underlying logic comes directly from a production engine handling live ad campaigns since 2026.

Safety controls stop the model from burning money. New campaigns cannot start delivering immediately because the creation tool intentionally omits an activation flag. Turning a campaign on requires a separate step, and the server refuses to enable campaigns built in the standard Google Ads web UI. Every budget edit is validated against `MCP_DEFAULT_MAX_DAILY_BUDGET_CENTS`. If a proposed amount exceeds the cap, the server rejects the call outright rather than silently capping it.

Running the self-hosted Docker container requires an approved Google Ads developer token, which takes several days to obtain from Google. Stored credentials stay secured with AES-256-GCM encryption, and OAuth 2.1 manages dynamic registration with PKCE. Teams wanting to skip server setup can connect directly to `https://api.loomascale.com/mcp`.

## Requirements
- Needs: Docker
- Remote server: `https://api.loomascale.com/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http ads https://api.loomascale.com/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add loomascale-ads --url https://api.loomascale.com/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "loomascale-ads": {
            "url": "https://api.loomascale.com/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "loomascale-ads": {
            "type": "http",
            "url": "https://api.loomascale.com/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http loomascale-ads https://api.loomascale.com/mcp
```

## When to use it
- audit Google Ads accounts for wasted search spend
- generate Performance Max campaign structures safely
- discover high-intent keywords using the official API
- enforce rigid daily spend caps on automated edits

## Example prompts
- Audit search terms in Google Ads and list queries with zero conversions over the last month.
- Draft a Performance Max campaign outline with asset groups and headlines.
- Increase the campaign daily budget by 10% within the configured spend cap.

## Similar
- [google-ads-report](https://affpapa.org/en/nevibecode/skills/google-ads-report.md) — skill · 476 installs
- [Ads Manager by AdKit: Google Ads, Meta Ads, TikTok Ads, LinkedIn Ads](https://affpapa.org/en/nevibecode/mcp/ads-manager-by-adkit-google-ads-meta-ads-tiktok-ads-linkedin-ads.md) — MCP server · ★ 18
- [Agency AI – Meta & Google Ads Automation](https://affpapa.org/en/nevibecode/mcp/agency-ai-meta-google-ads-automation.md) — MCP server · ★ 1
- [Google Ads MCP](https://affpapa.org/en/nevibecode/mcp/google-ads-mcp.md) — MCP server
- [Google Ads](https://affpapa.org/en/nevibecode/mcp/google-ads.md) — MCP server

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md