Internal tool · Color Ecommerce · built on the Google Ads API

An autonomous agent that runs our own ad accounts for Color Ecommerce

Built and operated in-house. The agent reads performance data through the Google Ads API, reasons about it with Claude, and applies bid, budget and keyword changes inside limits our own team configures. No third party uses it, and nothing is resold.

1 MCC

Our own manager account, nothing outside it

Hourly

Scheduled reporting sync, never on page load

20

Internal agent tools, all scoped to our accounts

100%

Of mutations logged, attributed and reversible

The agentic loop

How the agent works

Not a rule engine. A reasoning loop that runs continuously across our accounts and improves with every measured result.

01

Observe

Pulls metrics, search terms and change history through read-only reporting queries, every hour.

02

Reason

Claude analyses performance, detects anomalies and states a root cause in writing.

03

Plan

Produces an explicit change proposal with projected impact and a confidence score.

04

Act

Executes inside configured limits. High-risk changes route to a human approval queue first.

05

Learn

Measures the 7-day outcome and feeds the result back into the next decision.

Capabilities

What it does between check-ins

Goal-driven optimization

Our team sets a CPA or ROAS target per account. The agent builds a multi-week plan and works toward it without further prompting.

Explained reasoning

Every action starts with analysis. The diagnosis and the argument for the change are stored alongside the mutation, so any edit can be traced back to a reason.

Guardrails and rollback

Hard limits on bid and budget deltas, daily action caps and a confidence threshold. Changes that underperform over seven days are reverted automatically.

Human in the loop

Low-risk, high-confidence changes execute on their own. Anything above the risk threshold waits in an approval queue for a named operator. An emergency pause stops the agent instantly.

Conversational control

Operators query the agent in plain language from the internal dashboard or over MCP. Twenty tools and four resources are exposed, all scoped to our own accounts.

Multi-account under one MCC

Full manager-account hierarchy support with cross-account benchmarking. Every child account belongs to Color Ecommerce.

Google Ads API usage

What we call, and why

All access is through the official client library with OAuth 2.0, one developer token, and a single manager account as login customer.

GoogleAdsServicesearch · searchStreamHourly reporting sync: campaign, ad group, keyword and search-term metrics
CampaignBudgetServicemutateBudget adjustments within the configured daily cap
AdGroupCriterionServicemutateBid changes, negative keywords, pausing non-converting terms
CampaignServicemutateStatus changes and bidding-strategy target updates
CustomerServicelistAccessibleCustomersEnumerating accounts under our manager account
ChangeStatusServicesearchReading change history to attribute outcomes and support rollback

Policy compliance

How we meet the requirements

Internal use only

The tool manages advertising for Color Ecommerce's own accounts. It is not offered to external advertisers, agencies or resellers.

Required minimum functionality

The dashboard supports campaign creation and editing, budget and bid management, keyword management and performance reporting, not reporting alone.

Rate limits and quota

Requests are batched, cached for the hour, and retried with exponential backoff. Reporting runs on a fixed schedule rather than on page load.

Data handling

Aggregated performance data is stored on our own infrastructure with encryption at rest. No personally identifiable user data is collected, and nothing is shared with third parties.

Audit trail

Every mutation is recorded with its request payload, the reasoning that produced it, the operator who approved it where applicable, and its rollback state.

Credentials

OAuth refresh tokens and the developer token are held in a managed secret store, accessible only to the service account that runs the agent.

One advertiser. One MCC. Every change accounted for.

Access is requested solely to automate Color Ecommerce's own campaigns, under the guardrails and audit trail described above.

Contact

Talk to the team behind Hue

For questions about the tool, its API usage, or our data handling, reach the team directly.

+65 9895 5130info@colorecommerce.com
114 Lavender Street, #11-83 CT Hub 2
338729, Singapore