burn-r8 docs

Claude Code Plugin

Install burn-r8 as a Claude Code plugin. One line, auto-updates.

Install

Add burn-r8 as a marketplace in your Claude Code settings:

{
  "extraKnownMarketplaces": {
    "burnr8": {
      "source": {
        "source": "github",
        "repo": "HarrisonHesslink/burnr8"
      },
      "autoUpdate": true
    }
  }
}

Then run /plugin in Claude Code and enable burn-r8.

What you get

The plugin auto-registers the MCP server and includes:

60 MCP tools

All Google Ads tools (campaigns, keywords, budgets, reporting, extensions, conversions, and more). No manual MCP configuration needed.

2 Custom agents

  • ads-optimizer — Finds and fixes wasted ad spend, recommends negative keywords, pauses underperformers. Full write access.
  • ads-auditor — Read-only account analysis. Runs audits, pulls reports, checks conversion tracking. Cannot modify your account.

5 Slash commands

CommandWhat it does
/auditRun a full 74-check Google Ads audit
/spendQuick spend summary for an account
/wasteFind and fix wasted ad spend
/launchLaunch a new search campaign
/statusShow API usage and system status

A structured 74-check audit framework covering:

  • Conversion tracking setup
  • Wasted spend identification
  • Quality score analysis
  • Ad strength evaluation
  • Negative keyword coverage
  • Budget allocation

Credentials

You still need Google Ads API credentials. Create a .env file in your project:

GOOGLE_ADS_DEVELOPER_TOKEN=your-developer-token
GOOGLE_ADS_CLIENT_ID=your-client-id
GOOGLE_ADS_CLIENT_SECRET=your-client-secret
GOOGLE_ADS_REFRESH_TOKEN=your-refresh-token

See the self-hosted setup guide for how to get these credentials.

Plugin vs Hosted

Plugin (self-hosted)Hosted (burnrate.sh)
CredentialsYour own API credentialsOAuth, no developer token needed
SetupOne line in settings.json + .envSign up, connect Google Ads
Agents2 custom agents includedUse Claude's built-in agents
Slash commands5 commands includedNot available
Audit skillIncludedNot available
PriceFree foreverFree tier (50 calls/mo), Pro $29/mo

Updates

With autoUpdate: true, the plugin updates automatically when new versions are released on GitHub.

Next steps

On this page