# OrbiAds

> Google Ad Manager automation platform for publishers

Full reference (expanded, with the complete MCP tool catalogue): https://orbiads.com/llms-full.txt

## Documentation

### MCP Server
- [MCP Introduction](https://orbiads.com/docs/mcp): Connect AI agents to GAM via Model Context Protocol
- [MCP Quickstart](https://orbiads.com/docs/mcp/quickstart): Get started with OrbiAds MCP in 3 steps
- [MCP Configuration](https://orbiads.com/docs/mcp/configuration): Configure Claude, ChatGPT, Gemini, Cursor, Windsurf
- [MCP Tools Reference](https://orbiads.com/docs/mcp/tools): 50 MCP tools covering 476 GAM functions, organized by category
- [MCP Security](https://orbiads.com/docs/mcp/security): OAuth 2.0, KMS encryption, audit trail

### CLI
- [CLI Introduction](https://orbiads.com/docs/cli): Lightweight CLI alternative to MCP
- [CLI Quickstart](https://orbiads.com/docs/cli/quickstart): Get started with orbiads-cli in 3 steps
- [CLI Commands](https://orbiads.com/docs/cli/commands): Complete command reference
- [CLI Authentication](https://orbiads.com/docs/cli/auth): Google OAuth Device Flow setup
- [CLI Configuration](https://orbiads.com/docs/cli/configuration): Config file and settings
- [MCP vs CLI](https://orbiads.com/docs/cli/compare): Choose the right integration method

### General
- [Getting Started](https://orbiads.com/docs/getting-started): Choose the right entry point for MCP, CLI, Skills or Academy
- [Skills Overview](https://orbiads.com/docs/skills): Understand OrbiAds AI Skills and workflows
- [Install a Skill](https://orbiads.com/docs/skills/install): Install OrbiAds Skills in Codex, Claude or CLI workflows
- [Campaign Staging Draft](https://orbiads.com/docs/features/campaign-staging): Create a 7-day staging draft before deploying to GAM
- [Blueprint Change Set](https://orbiads.com/docs/features/blueprint-changeset): Scoped inventory change sets with diff and promotion
- [Plan Before Mutate](https://orbiads.com/docs/features/plan-before-mutate): Dry-run plus confirmation token workflow for GAM writes
- [Pricing](https://orbiads.com/pricing): Plans, credits, and billing
- [Privacy Policy](https://orbiads.com/privacy): Data handling and GDPR compliance
- [Terms of Service](https://orbiads.com/terms): Usage terms and conditions

## Academy
- [Academy](https://orbiads.com/academy): Guides and tutorials for Google Ad Manager automation
- [What is a Google Ad Manager MCP server](https://orbiads.com/academy/what-is-google-ad-manager-mcp): What an MCP server is and how it connects AI agents to GAM
- [Automate Ad Operations](https://orbiads.com/academy/automate-ad-operations-google-ad-manager): How to automate ad operations in Google Ad Manager
- [GAM Targeting Validation](https://orbiads.com/academy/google-ad-manager-targeting-validation): Validate key-values, placements, sizes and targeting before launch
- [GAM Key-Values Guide](https://orbiads.com/academy/gam-key-values-guide): Key-value limits, expression constraints and API creation
- [GAM Standard vs 360](https://orbiads.com/academy/gam-standard-vs-360-differences): Differences between Ad Manager Standard and Ad Manager 360
- [GAM Inventory Forecasting](https://orbiads.com/academy/gam-inventory-forecasting-guide): How inventory forecasting works in Google Ad Manager
- [Unsold Inventory](https://orbiads.com/academy/google-ad-manager-unsold-inventory): Diagnose and reduce unsold (unfilled) inventory in GAM
- [Line Item Forecast with Codex](https://orbiads.com/academy/google-ad-manager-forecast-codex): Run GAM line item forecasts from Codex
- [Daily GAM Report with Claude](https://orbiads.com/academy/gam-daily-report-claude-cowork): Build a daily GAM delivery and revenue report with Claude
- [Linked GAM REST Reporting](https://orbiads.com/academy/gam-linked-rest-reporting): Report on linked Analytics, AdSense and Ad Exchange fields via GAM REST
- [Prebid.js GAM Setup](https://orbiads.com/academy/prebid-setup-gam-guide): Set up Prebid.js header bidding line items in GAM
- [Upload GAM Creatives](https://orbiads.com/academy/upload-creatives-gam-programmatically): Upload creatives to GAM programmatically
- [Troubleshooting Quota Error](https://orbiads.com/academy/troubleshooting-quota-error): Troubleshoot GAM API QUOTA_ERROR and rate limits
- [GAM API v202602 Transition](https://orbiads.com/academy/gam-api-v202602-transition): Migrate to the Google Ad Manager API v202602 version

## API & Workflow
- MCP Endpoint: `https://orbiads.com/mcp`
- Transport: streamable-http (default), sse, stdio (local dev)
- Auth: OAuth 2.0 via Google account
- Plan-Before-Mutate: call with `dryRun=true` to receive an ExecutionPlan, then call with `confirmationToken=<token>` to execute

### Plan-Before-Mutate (MCP Pattern)
All GAM write operations should follow a two-step pattern:
1. Call with `dryRun=true` -> receive ExecutionPlan (mutations, cost, risks, confirmationToken)
2. Call with `confirmationToken=<token>` and `dryRun=false` -> execute

Key tools:
- `campaign(action='create_draft')` — create a staging draft (0 credits)
- `campaign(action='deploy', dryRun=true)` — preview deploy plan (0 credits)
- `campaign(action='create_display', dryRun=true)` — display forecast plus plan (0 credits)
- `push_inventory_blueprint(dryRun=true)` — blueprint diff plus token (0 credits)

## Installation
- MCP: Paste `https://orbiads.com/mcp` into your AI agent settings
- CLI: `pip install orbiads-cli`