# Meta Ads Stack

> Run a live Meta (Facebook/Instagram) ad account end to end with Claude Code. 6 skills + MCP setup. You approve every spend. Free and open source.

- **Type:** MCP server
- **Install:** `agentstack add mcp-sandy-zippy-meta-ads-stack`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Sandy-zippy](https://agentstack.voostack.com/s/sandy-zippy)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Sandy-zippy](https://github.com/Sandy-zippy)
- **Source:** https://github.com/Sandy-zippy/meta-ads-stack

## Install

```sh
agentstack add mcp-sandy-zippy-meta-ads-stack
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Meta Ads Stack

**Run a live Meta (Facebook/Instagram) ad account end to end with Claude Code.**
Six skills that audit, create, build, monitor, and optimize campaigns. You approve every spend. Free and open source.

> Skills are the brain. MCPs are the hands. The skills decide, the MCPs execute, and you approve before a single dollar moves.

---

## What this is

A set of Claude Code **skills** plus the **MCP setup** to drive a real Meta ad account from your terminal. Claude Code is the operator; the Meta Ads MCP is its hands; you are the approver. Nothing spends, launches, pauses, or scales without your sign-off.

## The 6 skills

| # | Skill | What it does |
|---|---|---|
| 1 | **strategy-intel** | Studies the top performance marketers and figures out the campaign structure that is winning right now. |
| 2 | **ad-creative-engine** | Scrapes the Meta Ad Library for working angles, writes the copy and CTAs, and generates the static creatives. |
| 3 | **campaign-builder** | Builds the correct structure (ABO testing, CBO scaling, retargeting) directly inside Meta, always PAUSED for your review. |
| 4 | **ad-watchdog** | Monitors live performance (CPM, CPC, CTR, cost per lead, frequency) on a schedule and proposes ranked actions. Never writes. |
| 5 | **ad-optimizer** | Executes only the actions you approved: pause losers, duplicate-and-scale winners. Every write is logged. |
| 6 | **ad-audit** | Audits an existing account for what is broken and where to focus. Optional, read-only. |

The value chain: strategy creates the ads, the ads become campaigns, the campaigns generate data, the data improves the strategy, and the loop runs again. That is not six skills. That is a Facebook ads team.

## How it connects

- **Primary:** the first-party Meta Ads MCP (`ads_create_campaign`, `ads_create_ad_set`, `ads_create_creative`, `ads_create_ad`, insights, `ads_library_search`).
- **Fallback:** [`pipeboard-co/meta-ads-mcp`](https://github.com/pipeboard-co/meta-ads-mcp).
- **Image generation:** ChatGPT Image Gen 2 for the creatives.
- Full setup (Meta app, system-user token, pixel + CAPI): see [`docs/setup-guide.md`](docs/setup-guide.md).

## Install

```bash
git clone https://github.com/Sandy-zippy/meta-ads-stack.git
cd meta-ads-stack
cp config/accounts.example.yaml config/accounts.yaml   # fill in your account
# copy the skills/ folders into your project's .claude/skills/ (or point Claude Code at them)
```

Then connect the Meta Ads MCP (see the setup guide) and tell Claude Code: *"audit my account and propose a campaign."*

## Safety model (read this)

- **Everything is created PAUSED.** Activation is always a separate, deliberate human step.
- **The watchdog never writes.** It only reports and proposes.
- **The optimizer acts only on the actions you approved**, never exceeds +20% per scale, refuses to run outside your configured business hours, and appends every write to an audit log.
- This cannot blow up your account on its own. That is the point.

## The cron

`cron/weekly-watchdog` runs the watchdog headless on a schedule and emails you a report with the proposed actions. You reply to approve. See [`cron/`](cron/).

## Credits

- Audit checks wrap [`AgriciDaniel/claude-ads`](https://github.com/AgriciDaniel/claude-ads).
- MCP fallback: [`pipeboard-co/meta-ads-mcp`](https://github.com/pipeboard-co/meta-ads-mcp).

## License

MIT. Use it, fork it, ship it.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Sandy-zippy](https://github.com/Sandy-zippy)
- **Source:** [Sandy-zippy/meta-ads-stack](https://github.com/Sandy-zippy/meta-ads-stack)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-sandy-zippy-meta-ads-stack
- Seller: https://agentstack.voostack.com/s/sandy-zippy
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.