Set hard per-purchase and daily spending limits for AI agents. Approve exceptions, pause access instantly, and get signed proof of every purchase made through Receipt.
2 installs
Data & analysis
Ad Budget Governor
Try itCross-platform rolling ad-spend cap that blocks overspend across multiple ad platforms combined, not just per-platform daily limits. Fails closed on unreadab...
What it does
Cross-platform rolling ad-spend cap that blocks overspend across multiple ad platforms combined, not just per-platform daily limits. Fails closed on unreadable spend data.
The skill document
Ad Budget Governor
Most per-platform ad tools (Meta, TikTok, Google, etc.) only enforce their own daily spend cap. If your agent runs ad spend across more than one platform, none of them know about each other — total combined spend can exceed what you actually intended even when every individual platform "cap" is technically respected.
This skill adds one rolling-window cap that sums spend across all platforms you configure, and blocks any spend action that would push the combined total over your limit — regardless of which platform is asking.
Why fail-closed matters
If the spend ledger for a platform is corrupted, missing in an unexpected way, or fails to parse, this skill treats that platform's spend as unknown, not zero, and blocks new spend until it's resolved. A governor that silently assumes "unreadable = $0 spent" will let real overspend through at exactly the moment something is already wrong. This is the single most important property of this skill — don't change it.
Setup
- Copy
ad_budget_governor.pyinto your project. - Edit
LEDGER_PATHSto point at your own platform spend-tracking files. Each ledger is a JSON file containing a list of records shaped like:
Extra fields are ignored. If your platform wrapper doesn't already log spend in this shape, add that logging before wiring this in.{"timestamp": "2026-06-22T14:00:00Z", "amount_usd": 12.50} - Call
check_rolling_budget(amount_usd)before every spend action, on every platform:from ad_budget_governor import check_rolling_budget ok, reason = check_rolling_budget(amount_usd=25.00) if not ok: # do not spend — surface `reason` to the operator ... - Set your cap (defaults to $0 — intentionally, so nothing spends before
a real number is chosen):
from ad_budget_governor import set_cap set_cap(300.0, note="initial cap")
API
| Function | Returns |
|---|---|
check_rolling_budget(amount_usd) | (ok: bool, reason: str | None) |
rolling_spend_usd(window_days=30) | (total: float, had_read_error: bool) |
get_status() | dict with cap, spent, remaining, at_cap, ledger_read_error |
set_cap(new_cap_usd, note="") | updated status dict |
Tested against
Built and verified in production governing real Meta + TikTok ad spend for a live marketing campaign before being generalized for publication here.
Related skills
Use when the user asks to "check pacing", "am I over/under-spending", "is this campaign on track to hit budget", or "why did spend spike/stall mid-flight"; r...
1 installs
Resolve a brand or domain to a Google advertiser id, then pull every ad it runs across Search, YouTube, Shopping, Maps and Play, and open one creative with its full region and impression history. 3 endpoints, 1 credit each.
Use when the user asks to "allocate my influencer budget", "optimize spend across tiers", or "compare budget scenarios"; produces a tier/platform/content all...
1 installs
Manage Google Ads & Meta (Facebook) Ads from your AI coding tool. 113 MCP tools for auditing, creating, and optimizing ad accounts using natural language.
71 installs1 stars
Search the Meta Ad Library by keyword or Facebook Page id and walk full cursor pagination through every ad, with creative, run dates, platforms and political spend. 3 endpoints, 1 credit per page.
1 installs