mcpField
B
budget-pacer

budget-pacer

github.com/kelpi-aiMarketing & growth555 installsUpdated 17w ago
Repository

About budget-pacer

A marketing skill for proposing disciplined Meta Ads budget pacing based on recent ad set performance and user-defined targets. It drafts pause rules, scaling steps, and spend alerts; no changes are made until approved.

Key features

  1. 01Reviews 14 days of ad set results
  2. 02Evaluates performance against a user-set target
  3. 03Drafts pause rules for underperformers
  4. 04Plans budget increases in 20% steps
  5. 05Proposes spend alerts and review dates

Use cases

  1. 01Plan gradual increases for a performing ad set
  2. 02Set draft pause rules for campaigns with no results
  3. 03Review proposed spend safeguards before applying them

MCP support

Requires a Meta Ads MCP with write access to prepare budget-change drafts. Changes remain drafts until a human approves them.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/kelpi-ai/meta-ads-skills --skill budget-pacer

After installing, type/budget-pacerin Claude Code to confirm it loaded.

Bundled filesskill.meta.json

Details

From the project README

Budget Pacer

Doctrine

"Every time I touch a winning campaign it crashes" is a scaling story, not a curse: big budget jumps reset learning, and panic edits kill compounding winners. Pacing means the boring version: scale in ~20% steps, no more than once a day, pause what has proven it loses, and let rules carry the discipline your fingers do not have. The loop decides the ceiling: scale only what returns its spend fast enough to fund the next round.

When to use

  • An angle has spent 2-3x target cost-per-result and holds. Time to feed it.
  • You keep manually raising and lowering budgets on vibes.
  • Needs a Meta Ads MCP with write access; everything is proposed as a draft first.

Run it

Budget pacing proposal, draft only, change nothing yet:

1. Read the last 14 days by ad set: spend, results, cost per result.
2. Identify what has EARNED a raise (enough spend to judge, cost per result at or under my target of [$X]) and what has earned a pause (2-3x target spent, no results).
3. Propose:
   - a pause rule: pause any ad set whose cost per result exceeds [$X * 1.5] over a 3-day window,
   - a scaling plan for the winner: +20% budget steps, at most one step per day, with the next review date,
   - a spend guardrail: a rule that alerts me if daily account spend exceeds [$CAP].
4. Show me the rules exactly as they would be created. I will say "create" for the ones I want.

Guardrails

  • Drafts until the human says "create". Spend changes are the most sensitive write there is.
  • +20% steps, not doublings. A budget doubling is a learning reset wearing a growth costume.
  • Pause rules use my numbers ([$X] comes from my loop math), never an invented benchmark.
  • If the loop math says the winner still is not profitable at scale, say that instead of scaling it.

Good output looks like

Two or three rules you can read and approve by name, a winner scaling schedule with dates, and no dollar moved without a yes.

Comments

Markdown supported