Skip to content
MCP server

AdRails

Local MCP server that lets an AI run Google Ads and SEO work inside spend caps you set

Runs locallyStatus and history
Pricing
Open source
Platforms
self-hosted, CLI
Runs
Locally
Version
0.14.4
Listing updated
3 days ago

About AdRails

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

The core idea is a policy file that no AdRails tool can write. Budget limits, end dates and spend thresholds live there, and every real change needs a fresh single-use plan ID that expires in 15 minutes. In the site's example, an agent asking for a 40 dollar daily budget is refused because the policy maximum is 25; a smaller change is planned with dry_run, then applied with the plan ID, validated by Google and committed.

It runs on your machine against your own Google Cloud project, with no hosted proxy or account. Beyond Google Ads it covers Local Services Ads, ChatGPT Ads, Search Console, AI-answer visibility and a lead book. adsops_metrics_pull keeps a daily history in a local SQLite file, and adsops_impact compares days after a change with a counterfactual, giving a verdict of helped, hurt or no clear effect.

Three optional extras are paid per job in sats or USDC: an AI visibility panel (5,000 sats), a second opinion (1,000 sats) and a Bitcoin timestamp (1,000 sats). A hosted coach connector is also offered for ChatGPT and Claude.

Install

Run in a terminal

claude mcp add adrails -- uvx adrails

Add to claude_desktop_config.json

{
  "mcpServers": {
    "adrails": {
      "command": "uvx",
      "args": [
        "adrails"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "adrails": {
      "command": "uvx",
      "args": [
        "adrails"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "adrails": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "adrails"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "adrails": {
      "command": "uvx",
      "args": [
        "adrails"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "adrails": {
      "command": "uvx",
      "args": [
        "adrails"
      ]
    }
  }
}

Tools this server provides (8)

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

adsops_set
Plans or applies a campaign change such as a budget.
adsops_metrics_pull
Pulls daily ads and Search Console history into a local store.
adsops_impact
Measures a change against an expected outcome.
adsops_search_console
Ranks organic opportunities from Search Console.
adsops_get_started
Starts onboarding.
adsops_setup_checklist
Setup checklist.
adsops_page_plan
Plans pages.
adsops_cadence
Weekly routine.

What it does

Guardrail policy
Caps live in a file no tool can write.
Single-use plan IDs
Every change needs a fresh plan ID.
Impact measurement
Compares results after a change with a counterfactual.
Local history
Daily ads, Search Console and lead data stay in local SQLite.
Lead book
Collects leads from ads, the website and AI assistants.
Optional paid extras
Visibility panel, second opinion and timestamp, per job.

Good for

  • Let an agent adjust budgets within a hard cap
  • Find pages ranking at positions 4 to 20
  • Check whether a campaign change helped
  • Build a 90-day local lead plan

Pricing

Open source

Free, Apache-2.0; optional extras from 1,000 sats per job

Prices change. Check adrails.dev before you buy.

AdRails FAQ

Is it free?

The executor is free and open source under Apache-2.0, with no subscription.

Does my data leave my machine?

The site says nothing leaves your machine; numbers stay local.

How are extras paid?

In sats on-chain or USDC on Base through x402, per job, with no account.

Is AdRails free?

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

How do I add AdRails to Claude Code?

Run this command in your terminal: claude mcp add adrails -- uvx adrails

What are the best alternatives to AdRails?

The closest alternatives to AdRails are Google Ads + Meta Ads + SEO/GEO MCP, Calven, MCP, Red Center Studio free tools and ASOScan.

Alternatives to AdRails

  1. 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
  2. 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
  3. MCP

    MCP server

    MCP server for planning, scheduling and measuring social and ad campaigns with approvals

    • Remote
    • Freemium
    • Marketing and SEO
  4. Free website checks for AI readiness, DNS dependencies, domain health and Bubble errors

    • 5 tools
    • Remote
    • Free
    • Marketing and SEO
  5. ASOScan

    MCP server

    ASO data for your own iOS and Android apps: rankings, keywords, reviews, scores

    • Remote
    • Free trial
    • Marketing and SEO
  6. PostBaton

    MCP server

    Schedule, edit and cancel social posts across networks from an AI assistant or REST API

    Not checked yet
    • Remote
    • Freemium
    • Marketing and SEO