Open source · Apache 2.0 · Local-first

your AI ad ops crew,
local-first, inside your agent.

Find waste, audit changes, and run ad accounts safely. 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 you can show to anyone. Works with Claude Code, Cursor, Codex, and Gemini.

Get started View on GitHub

How it works

From install to approved change in three steps.

  1. 01

    Install

    Two commands. mureo configure opens a local browser UI to register the MCP server, credential-guard hook, and skills — no JSON editing, no secret-pasting. 

    $ pip install mureo
$ mureo configure
  2. 02

    Ask your agent

    Run a workflow in plain language. A Demo account ships built in, so you can feel the loop end-to-end with no OAuth and no real account.

    > /daily-check
    demo account included · no OAuth
  3. 03

    Approve changes

    Nothing is written until you say so. Every mutation passes a safety gate and lands in an append-only log — rollback ready if you change your mind.

    budget shift proposed · +12% to top performer
    approve rollback ready

What makes mureo different

Six properties that set it apart from a generic LLM wrapper.

Strategy-grounded

Every decision reads STRATEGY.md — persona, USP, brand voice, goals.

Safety-gated

Rollback allow-list, GAQL guards, BYOD read-only by default, credential guard.

Cross-platform

Google, Meta, Amazon, TikTok, Search Console, and GA4 — one workflow across every account.

Auditable

Append-only action log with rollback for every mutation.

Local-first

Credentials never leave your machine. No cloud relay.

Learnable

/learn builds account-specific knowledge over time.

Safety by construction

The agent can move fast because it can't do harm.

Credential guard

A pre-flight hook blocks any tool call that would send credentials off your machine.

Rollback allow-list

Only allow-listed operations can be applied, and each mutation writes an undo.

Append-only audit log

Every change lands in an append-only log you can show to anyone.

Per-platform throttle

Rate limits per platform keep the agent within safe API bounds.

Platforms

One workflow across every ad account.

Google Ads

Native diagnostics and execution. OAuth for full read and write.

Meta Ads

Native diagnostics and execution across campaigns and ad sets.

Search Console

Native read access for search performance and coverage.

GA4

Conversion and audience context through the GA4 MCP.

TikTok Ads

Runs through TikTok's official hosted MCP (beta). Findings are advisory.

Amazon Ads

Runs through the official Amazon Ads MCP, bridged by mureo so your Login with Amazon credentials stay in ~/.mureo and never enter the host's MCP config. Findings are advisory.

Three ways to run it

Start synthetic, bring your data, then execute.

Demo · 2 min · no auth

Zero-friction trial

Try mureo end-to-end on a generated scenario. Four ship built in, each with STRATEGY.md, STATE.json, and a synthetic bundle. No account, no OAuth, no XLSX.

BYOD · read-only · no OAuth

Diagnose your own data

Drop a Sheet-bundle XLSX in and get a strategy-grounded, multi-platform diagnosis. Every mutation returns skipped_in_byod_readonly — analyze and recommend, never write.

Live API · full · OAuth

Full execution

Connect directly to the Google Ads, Meta Ads, and Amazon Ads APIs to execute changes and enable GA4 and Search Console support.

Commercial edition

Need a cloud-hosted service or a local Agency edition for teams and agencies? The OSS you see here stays free and local-first.

Plans & pricing