mureo plugin
A local toolkit for running ad accounts through an agent: diagnostics, changes with rollback and an action log.
- 64 ★ on the repository
- Last commit
- Apache-2.0
Broad access
Why this level
- In live mode the agent changes bids, budgets and ads in ad accounts, which spends real money.
- Google and Meta OAuth tokens sit in `~/.mureo/credentials.json` and open the accounts in full.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/mureoDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- In live mode the agent changes bids, budgets and ads in ad accounts, which spends real money.
- Google and Meta OAuth tokens sit in `~/.mureo/credentials.json` and open the accounts in full.
This is third-party code. Review the repository files before installing.
What it does
mureo adds an MCP server and a set of ad-operations commands to Claude Code, Cursor, Codex and Gemini CLI. The agent reads Google Ads, Meta Ads, Search Console and GA4, while Amazon Ads and TikTok Ads connect through their official MCP servers. Every decision rests on a `STRATEGY.md` file with persona, USP and goals, and state lives in `STATE.json`. Commands such as `/daily-check`, `/rescue`, `/budget-rebalance` and `/search-term-cleanup` find wasted budget, explain a drop and propose changes. Each action lands in a log with a rollback plan, and a hook blocks the agent from reading files with keys. BYOD mode takes an XLSX export of the account and stays read-only. The demo scenario runs on synthetic data without keys.
Who it is for. PPC and paid-social specialists and small teams who hand an agent the audit and daily check of Google Ads and Meta Ads accounts.
Good fit when
- In the morning you want one report across Google Ads, Meta Ads and search from a single `/daily-check` command.
- Paid search terms overlap with organic rankings and budget goes to positions already held.
- Cost per conversion rose and you must tell an account fault from a site problem.
- The agent must not touch the account, so you start with an XLSX export and read-only mode.
- Every change to bids and budgets must stay in a log with a way to roll it back.
Not a fit when
- Accounts run in Yandex Direct or VK Ads: mureo covers Google Ads, Meta Ads, Amazon Ads and TikTok Ads.
- You cannot obtain Google Ads API access: approval sometimes takes weeks, which leaves BYOD mode.
- Only a person changes budgets and bids, and the agent should see reports alone.
Example request
/daily-checkLimitations
Python 3.10 or newer is required. Own connectors cover Google Ads, Meta Ads and Search Console, the rest go through official platform MCP servers. In BYOD mode all edit commands give a preview only, and Google Ads auction data and GA4 are unavailable. Live mode needs a Google Cloud project with Google Ads API access and a Meta app. Some creatives are assembled with headless Chromium and your own image-provider key. Commercial editions with a cloud exist; their features are not in the open version.
How to disable. Remove the MCP server entry and the hook from the agent settings, then run `pip uninstall mureo`. The `~/.mureo` folder with keys and the log stays; clear it by hand.
FAQ
How can I try mureo without access to ad accounts?
Run `pip install mureo` and `mureo configure`. The local setup page offers a demo scenario on synthetic data that needs no keys or OAuth. Then open the demo folder in Claude Code and run `/daily-check`.
How do I connect mureo to Codex or Cursor?
For Codex run `mureo setup codex`: skills land in `~/.codex/skills/` and are called as `$daily-check`. For Cursor `mureo setup cursor` installs MCP tools only, without the workflow commands.
Can the agent change campaigns?
Only in live mode with OAuth. In BYOD mode every edit command returns `skipped_in_byod_readonly`, so the agent analyzes and advises but never writes to the account.
How does mureo protect keys?
`mureo setup claude-code` installs a PreToolUse hook that stops the agent from reading `~/.mureo/credentials.json` and `.env` files. Keys go only to the ad-platform APIs, and there is no telemetry.
What is STRATEGY.md?
A file with persona, USP, brand voice and goals that `/onboard` creates after a short interview. Later commands read it before deciding, so without it the advice stays generic.
Discussion
No questions or reviews yet.
Related
PluginsOne MCP server for ad accounts, analytics and CRM: Google Ads, Meta Ads, GA4, TikTok Ads and LinkedIn Ads
MCP server for Google Ads: analyze campaigns, metrics and keywords with GAQL queries right in the chat with an agent
An MCP server for Google Ads, Reddit Ads and GA4: the agent reads reports and edits campaigns, and only you turn on real spend
Adspirer remote MCP server: Google, Meta, LinkedIn, TikTok and Amazon ad campaigns are built and analyzed from a chat.
Humblytics MCP gives an agent live site analytics, funnels and A/B tests plus 12 marketing skills for finding conversion problems.
A local MCP server for advertising: Yandex Direct, Avito, VK through Click.ru and Telegram Ads in one SQLite store, changes only with confirmation
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| mureo (this card) | no | 64 | ||
| Google Ads MCP | no | OAuth | 721 | gives an agent Google Ads queries; mureo adds strategy, a log with rollback and daily-check commands across platforms |
| Facebook Ads MCP Server | yes | API key | 370 | covers Meta Ads only; mureo runs Google Ads, Meta Ads, Amazon Ads and TikTok Ads in one report |
README in short
The author calls the project a local control plane for AI ad operations. The value sits in what surrounds the API: strategy, a log with rollback and protection against key leaks.