MCP.so
ログイン

Adrails MCP Server

@antonioac1

基本情報

カテゴリ

開発者ツール

最終更新

ライセンス

Apache-2.0

作者

antonioac1

Adrails MCP Server について

AI agents run Google Ads and ChatGPT Ads with guardrails in code: plan/validate/commit, approvals, audit log. Plus AEO and direct-mail tools. Local, open source.

Adrails MCP Server の設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "adrails": {
      "command": "python3",
      "args": [
        "-m",
        "adsops",
        "--config",
        "/absolute/path/config.json"
      ]
    }
  }
}

Adrails MCP Server のツール

12

Lists the campaigns this deployment may operate: keys, accounts, state files, and the active commit policy.

Live read for one campaign: status, end date, daily budget, spend today and lifetime, negative count, whether caps come from the policy file, and the guard heartbeat's age. When the state file manages URL fields it also returns `urls`: the campaign final URL suffix and, per ad group, its custom parameters, final URL suffix and the final URLs of each enabled ad.

Clicked search terms for the last N days (1–90, default 14): term, matched keyword, clicks, cost.

Pure diff of the desired-state file against live state; writes nothing. Covers budget, status, end date, negatives and the URL fields below. Returns the operations, notes (one `url: ...` line per URL change), `ops_count`, the exposure increases it found, and a single-use **`plan_id`** with its expiry.

Validate-only unless `commit=true`. A commit needs `commit_policy.allow_commit`, a clean git-tracked state file, a fresh guard heartbeat when the change adds exposure, and the **`plan_id`** from `adsops_plan` when the policy requires it.

Proposes a budget / status / end-date / negatives change with a short `reason`; checks it against policy caps and live state, writes the state file and commits it to git. `dry_run=true` returns a **`plan_id`** instead of writing; `apply=true` needs that `plan_id` when the policy requires it.

Reads spend and pauses the campaign if the daily or lifetime threshold is crossed. Pause only: it never enables, raises a budget or edits keywords. Validate-only unless `commit=true`.

Metering summary for the tenant: calls, errors, units, ops and median latency per tool.

Read-only. Classifies the last N days (1–90, default 30) of search terms (renter, job, HOA/condo, vacation, DIY/software, out-of-area, competitor brand) with deterministic rules and an optional local-model hook you supply, and proposes PHRASE negatives with cost and click evidence. Skips terms and phrases your existing negatives already cover, never suggests words on your protect list, and returns a ready-to-paste `negatives_add` patch plus a basis note. It writes nothing: the patch goes through the desired-state file like any other change.

Read-only. Per ad group, Google's quality-score components (expected CTR, ad relevance, landing page experience) plus a plain HTTP check of each final URL: status, response time, bytes, and whether the title and H1 echo the ad group's keywords and town. Returns plain-English findings, worst first. No browser and no JavaScript, so a headline built by script shows as missing.

Read-only. The AdRails Intel weekly report from the free sources (Auction Insights you imported, cached Transparency Center data, your own stats snapshots). Needs `intel_config` in the config; makes no network call.

Imports an Auction Insights CSV/TSV export or a pasted table into the local intel database (replaces rows for the same date range). Writes only that local SQLite file. Needs `intel_config`.

概要

What is Adrails?

AI agents run Google Ads and ChatGPT Ads with guardrails in code: plan/validate/commit, approvals, audit log. Plus AEO and direct-mail tools. Local, open source.

How to use Adrails?

The README includes setup instructions such as uvx --from adrails adsops-mcp --config /absolute/path/config.json.

Key features of Adrails

  • Your keys. It runs on your machine against your own Google Cloud project and Google Ads
  • Your caps. Caps live in a policy file that no AdRails tool writes; with require_plan_id
  • Free, with optional paid extras. Everything runs free. Three hosted extras are paid per job in
  • It is a threshold with automatic pause attempts, not a hard spend ceiling. The guard
  • Google can deliver up to 2x the average daily budget on a given day. A daily budget is an

Use cases of Adrails

  • Connect an MCP-compatible client to this repository's service.
  • Review the README-backed setup before enabling it in production.

よくある質問

1

Where is the source code for Adrails?

The source code is linked from the repository URL on this page.

2

Does Adrails include a standard MCP config?

If the README contains a parseable MCP configuration block, it is shown in the Config tab.

コメント

「開発者ツール」の他のコンテンツ