All docs
Documentation

Everything you need to run the agent

Agent Planners is a human-approved, multi-agent harness for marketing automation across Google Ads, Google Analytics, BigQuery and Search Console. Start with the basics, then dive into playbooks, billing, and configuration.

Start here
Getting started

Connect an ad account, write a goal in plain language, and approve what the agent ships. The five-minute path from sign-up to your first optimization.

Best practices
Agent best practices: getting the most out of the system

How to get reliable, safe, cost-effective results from an AI agent for ad ops — writing goals, guardrails, approvals, model choice, skills, schedules and true ROAS.

Use it
Agent playbooks

Concrete, multi-step jobs the agent runs end-to-end — audits, budget rebalancing, search-term mining, remarketing, PMax, and cross-account cleanups. Copy a goal and go.

Billing
Credits & billing

How credits work, what consumes them, the free monthly allotment, top-up packs, where to see your usage, and how to lower your credit burn.

Extend
Add your own MCP server

Connect your own tools to the agent over the Model Context Protocol (MCP), plus thousands of SaaS actions via Composio. Fields, steps, and how tools are discovered.

Extend
Connect & use Composio

Give the agent 250+ SaaS app integrations — Slack, Gmail, Google Sheets, Salesforce, Notion and more — with one Composio API key. How to connect apps and have the agent act across them, with every write approved by you.

Extend
Connect Agent Planners to Claude, Codex, Grok and Muse

Connect an AI agent to Agent Planners over MCP, by hand: Claude (claude.ai, Desktop, Claude Code), Codex, Cursor, VS Code, Windsurf, Gemini CLI, ChatGPT, Grok, Muse and any MCP client — sign in from the agent or use an API key kept in an environment variable, verify the connection, add a second workspace, call tools and raw requests, and fix common errors.

Extend
OAuth apps for your own system: consent, tokens and the REST API

Integrate your own software with Agent Planners: register an OAuth app (a server app with a client secret, or a public app with PKCE), send a person through the consent page once, keep each connection's tokens, and call the REST API — with the own-app rule (no approval step in its own workspace), raw access on by default, call logging, and publishing an app to other workspaces.

Extend
REST API: tools, tasks and accounts

Call Agent Planners from your own system over plain HTTP: authenticate, discover what your credential can do, call the same platform tools as the MCP server, assemble a provider request where no tool exists, follow writes that wait for a person, read your own audit trail and credit usage — with an API key or an OAuth access token.

Extend
Build an integration (for coding agents)

Instructions for Codex, Claude Code, Cursor and developers wiring another system to Agent Planners: choose MCP, an API key or an OAuth app; authenticate; discover with /api/v1/capabilities; call tools; handle 202 approvals and errors; verify — with a minimal Node and Python client.

Extend
Call a platform's own API (raw requests)

How an OAuth app, an API key or an MCP agent calls Google Ads, Meta, TikTok, Microsoft, Reddit, Pinterest, Snapchat, LinkedIn and the other connected platforms in each platform's own request format — credentials injected, bound to the connected account, writes approved by a person.

Configure
Agents & models

The orchestrator plus six specialist agents, and how to choose the model for each one through the built-in AI Gateway — GPT, Claude, Gemini, Qwen, DeepSeek and more.

Configure
Bring your own model (BYOM)

Point every agent at your own OpenAI-compatible endpoint — Azure AI, vLLM, OpenRouter or any self-hosted model. LLM tokens on your endpoint aren't billed as platform credits; you pay your provider directly.

Connect
Connect your platforms

Natively connect Google Ads, Microsoft Advertising, DV360, Campaign Manager 360, Search Ads 360, Meta Ads, TikTok Ads, Reddit Ads, Pinterest Ads, Snapchat Ads, LinkedIn Ads, X Ads, Google Ad Manager, AdSense, AdMob, Google Analytics, Search Console, BigQuery, Tag Manager, Merchant Center, YouTube, Klaviyo, HubSpot, GitHub, Shopify, SHOPLINE and Stripe — plus 250+ more apps (Gmail, Outlook, Slack, Notion, Salesforce…) via Composio and your own tools via custom MCP. Pick accounts with the context picker and run one task across an entire MCC.

How it works
Approvals & workflow

Plan → approve → execute. How every write pauses at an approval gate, in-app or by email magic-link, with pre-approval, auto-approve, stale-state checks and the audit log.

Automate
Schedules

Turn any goal into a recurring job on a cron — hourly, daily or weekly — in your timezone, re-evaluating against live data on every fire, with optional email approvals.

Automate
Alerts: metric thresholds, account status and review changes

Alert rules email you when a metric crosses your line, when an ad account's status turns bad (suspended, verification required, disapproved ads, campaigns not serving), or when an AdSense site or AdMob app passes review.

Use it
Dashboards: live reporting pages that refresh themselves

Build a dashboard from a built-in template or have the agent design one, put it on a refresh schedule, and share it on a stable link you can revoke. How refreshes stay deterministic, what gets emailed, and what the share link does and doesn't do.

Use it
Agent Mail: run and approve agent tasks from your inbox

Agent Mail turns your inbox into a front door for the agent. Email a task from your sign-in address and it replies with what it would run, in which organization — nothing starts until you confirm. Covers the confirm flow, @mentions, standing rules, status checks and every limit that applies.

Configure
Skills, memory & teams

Capture your methodology as Skills, keep per-account memory (targets, protected campaigns, rules), and run isolated organizations with admin/editor/member roles.

Connect
SHOPLINE: connect an International store over OAuth

Connect an International SHOPLINE store (your-store.myshopline.com) with two clicks — read store, product and order data, get an exact sales summary and anomaly detection, and make approval-gated store changes.

Connect
Shopify: generate an Admin token and let the agent make changes

Connect a Shopify store in three tiers — domain-only storefront, read-only Admin data, and approval-gated Admin writes. How to create the Admin API access token, which scopes to grant, and the use cases the agent runs against a store.

Use it
Install Agent Planners on your phone

Add Agent Planners to your home screen: it opens on your workspace, fits the notch and the keyboard, and shows an offline page instead of a browser error when the connection drops.

Feature
Generate PPT decks & reports with AI

Turn an analysis or run into a client-ready PowerPoint deck and a written report — drafted by the agent from your real data, then editable and exportable.

Automate
Projects: let the agent plan, run and monitor a campaign over weeks

A project groups the tasks, schedules, milestones and checklist items behind one goal, with its budget and KPIs, and an overseer agent that reads every channel's numbers and runs the optimization — moving budget, adjusting bids and creatives, sending reports and email. Every change follows the project's approval setting: by default each one waits for your approval, and auto-approve is a per-project opt-in.