Open source · Apache 2.0 · Local-first
Find waste, audit changes, run ad accounts safely. Works with Claude Code, Cursor, Codex, and Gemini — mureo sits on top of the official ad-platform MCPs and gives your AI a strategy to follow, an outcome to be measured against, and an audit trail — credentials never leave your machine.
Local-first. Strategy-grounded. Safety-gated.
Six properties that distinguish mureo from generic LLM wrappers.
Every decision reads STRATEGY.md — persona, USP,
brand voice, goals.
Rollback allow-list, GAQL guards, BYOD read-only by default, credential guard.
Google Ads, Meta Ads, Search Console, GA4 — one workflow across all four.
Append-only action log with rollback for every mutation.
Credentials never leave your machine. No cloud relay.
/learn builds account-specific knowledge over
time.
Coming v0.9 (Q3 2026) Outcome correlation — link platform metrics with your CRM, sales, and LTV.
Two commands and a local browser UI for most people — or drop to the scriptable 3-modes × 3-hosts matrix if you prefer the terminal.
The easy way · recommended
$ pip install mureo
$ mureo configure mureo configure opens a local browser UI (bound to
127.0.0.1, ephemeral port — no remote access) that
walks you through everything: pick your Claude app, register the
MCP server, credential-guard hook, and skills, run Google / Meta
OAuth in the browser, register the official MCP providers, and
scaffold a Demo scenario or import a BYOD bundle — no terminal
secret-pasting, no JSON editing.
The terminal flow still works and is fully scriptable;
mureo configure is just the friendlier front door to
the same operations. Start with a synthetic scenario, drop in your
own XLSX bundle, or wire up the OAuth path for full execution —
same agents, same workflows, only the data source changes.
Mode A · 2 min · synthetic data
Try mureo end-to-end on a generated scenario. Four come built in
(seasonality-trap, halo-effect,
hidden-champion, strategy-drift) — each
ships STRATEGY.md, STATE.json, and a
synthetic ad bundle so the agent has something real to react to.
$ pip install mureo
$ mureo setup claude-code --skip-auth
$ mureo demo init --scenario seasonality-trapMode B · 5 min · no OAuth
Drop a Sheet-bundle XLSX into mureo and get a strategy-grounded
multi-platform diagnosis. Every mutation tool returns
skipped_in_byod_readonly — the agent analyzes and
recommends but never writes to your real account.
$ pip install mureo
$ mureo setup claude-code --skip-auth
$ mureo byod import ~/Downloads/mureo-google-ads.xlsxMode C · OAuth · full execution
Connect mureo directly to Google Ads / Meta Ads APIs. Required
to actually execute changes (/rescue,
/budget-rebalance, /creative-refresh,
rollback apply) and for GA4 / Search Console support.
$ pip install mureo
$ mureo auth setup
$ mureo setup claude-code