For AI tools · MCP server
Run Honest Growth inside your AI client.
Native MCP server. Install once and the audit becomes a tool your assistant can call — for diffs, history, single-finding lookups, and live verdicts.
The hosted endpoint is the goal — today you can run the same server from local source with uv run honest-growth-mcp. The JSON config is in the setup section below.
Claude Desktop · MCP: honest-growth
Why this matters
We don't put an AI agent in your account.
We put one in your workflow.
- 01
The math runs on our server
Your assistant calls the tool. The tool runs deterministic Python — the same engine that powers the CSV audit. The result is a verdict with the math attached. Your assistant cannot improvise the numbers.
- 02
Your assistant explains
Once it has the verdict, your assistant is great at the thing assistants are great at — explaining, prioritizing, rewriting in plain English. Without inventing numbers.
- 03
Read-only, always
No tool we expose can write to your Meta account. The connected tools read from your live audit history; they cannot modify campaigns. The wedge is the architecture.
The tool catalog · 3 free, 6 with a subscription
Nine tools, in one server.
The three free tools work the moment you install. The six subscriber tools light up once you connect a Meta account and the Watchtower goes live (Q1 2027). No second install, no second credential — just more tools through the same server.
run_audit_from_csvFreeFull audit on a CSV you paste in. Returns ranked findings, math, and fix steps. Same engine as /audit.
In Claude
“Run an Honest Growth audit on this CSV: …”
list_detectionsFreeReturns the catalog of all 24 detection rule families with their current thresholds and plain-English names.
In Claude
“What does Honest Growth check for?”
get_methodologyFreeReturns the full math, threshold values, and false-positive notes for any specific rule.
In Claude
“Explain the frequency saturation rule.”
run_audit_on_connected_accountSubscriptionRuns the full audit against your live Meta account via OAuth — read-only. Skip the CSV export.
In Claude
“Audit my account right now.”
get_live_findingsSubscriptionReturns the most recent verdict from your account's Watchtower run — ranked by recoverable dollars.
In Claude
“What's wrong with my account right now?”
get_account_timelineSubscription90-day history of every campaign push, budget shift, and finding that fired beside it.
In Claude
“What changed in my account this week?”
compare_to_last_auditSubscriptionDiff between this week's audit and the previous one — resolved, worsened, or new findings.
In Claude
“What's new since yesterday's audit?”
get_finding_historySubscriptionFor a single rule, every week it has fired in the last 90 days — with the dollar impact each time.
In Claude
“Has frequency saturation fired on this account before?”
acknowledge_findingSubscriptionTag a finding "fixed" or "intentional" for a window you choose — it stops re-surfacing until then.
In Claude
“Mark the placement imbalance as intentional for the quarter.”
The free tier isn't a trial. The server runs inside the process your client spawns, so a pasted CSV never leaves your machine. If you never subscribe, the free tools keep working forever.
Sample prompts
Things to ask your assistant.
Drop these into Claude Desktop, Cursor, or any MCP-aware client after the server is installed. The assistant picks the right tool, calls it, and shows you the verdict with the math.
run_audit_on_connected_account
“Audit my Meta account this week and rank findings by dollar impact.”
compare_to_last_audit
“What changed in my account since last Monday's audit?”
get_finding_history
“Has the 'frequency saturation' finding fired before? When?”
get_methodology
“Explain the math behind the audience overlap rule.”
run_audit_from_csv
“Take this CSV from Ads Manager and run a full audit on it.”
acknowledge_finding
“Acknowledge the placement imbalance finding as intentional — don't resurface it.”
Installation · 60 seconds
Three lines, in your assistant's config.
~/.config/claude/claude_desktop_config.json
# Claude Desktop · MCP config
{
"mcpServers": {
"honest-growth": {
"command": "uv",
"args": [
"--directory",
"/abs/path/to/Honest-Growth/apps/api",
"run",
"honest-growth-mcp"
]
}
}
}STEP 01
Install uv
Python package manager. One-line install from astral.sh.
STEP 02
Clone the repo
git clone the Honest-Growth repo, cd apps/api, uv sync.
STEP 03
Add the config block
Paste the snippet above into your client's MCP config.
STEP 04
Restart, then ask
"Run an Honest Growth audit on this CSV: …"
Works with Claude Desktop, Cursor, Continue, and any MCP-compatible client. The three free tools work without an API key. The six connected tools require a $29/mo subscription and a one-time OAuth handshake (shipping Q1 2027).
One install
Install free. Subscribe later when you want the watchtower inside your AI client too.
The free tier doesn't expire. The MCP server runs on CSVs forever, regardless of subscription.