1. Campaigns & Creative QA (orbiads-campaigns)

\n\n* `campaign` — Create, update, pause, and rollback campaigns.\n* `orders` — Create and list orders, contacts, and roles.\n* `line_items` — Define line item delivery rules, CPMs, and targeting logic.\n* `creatives` — Upload creatives (images, HTML5, video/audio) and configure native styles.\n* `creative_assets` — Manage associated image and file assets.\n* `creative_qa` — Audit click-trackers, perform compliance scans, and validate SSL certificates.\n* `creative_wrapper_skill` — Manage third-party wrappers and delivery presets.\n* `formats` — Discover and configure ad creative formats.\n* `jobs` & `gam_jobs` — Monitor async campaign compilation and deployment workflows.\n

\n\n

2. Inventory & Targeting (orbiads-inventory)

\n\n* `inventory` — Retrieve ad unit trees, sizes, and generate ads.json manifests.\n* `placements` — Create, update, and list ad placement groups.\n* `targeting` — Manage custom targeting keys/values, countries, and categories.\n* `audiences` — Retrieve and modify first-party audience segments.\n* `blueprint` — Generate and push structured network inventory blueprints.\n

\n\n

3. Reporting & Forecasting (orbiads-reporting)

\n\n* `reporting` — Run custom reports from templates, check line item delivery, and integrate GA4.\n* `preview` — Verify inventory coverage and export preview URLs.\n* `pql` — Run raw PQL database queries.\n

\n\n

4. Programmatic Deals (orbiads-deals)

\n\n* `deals` — Manage PMP deals, private auctions, and marketplace buyers.\n* `companies` — Manage agency and advertiser company profiles.\n

\n\n

5. Network Admin (orbiads-admin)

\n\n* `gam_admin` — Access advanced fields, network labels, teams, and site records.\n* `gam_features` — Query active Google Ad Manager beta and system features.\n* `network` — List accessible networks and switch active network context.\n* `settings` — Configure default CPMs, pacing, and brand naming templates.\n* `tenant_catalog` — Access tenant-specific catalogs.\n

\n\n

6. Audits & Billing (orbiads-audit)

\n\n* `audit_skill` — Run automated security, hygiene, and wrapper coverage audits.\n* `billing` — Fetch credit balances and transaction histories.\n* `audit` — Search network audit logs.\n

\n\n> See [`docs/tool-matrix/README.md`](https://github.com/OrbiAds/Orbiads-GAM-MCP/blob/main/docs/tool-matrix/README.md) for the complete parity matrix detailing exact costs, writes, and parameters for all 270+ actions.\n\n---\n\n## Safety by Design\n\nEvery write action requires explicit confirmation. No campaign goes live by accident.\n\n- **Dry-run mode** on all deployment actions — preview before you push\n- **Forecast gate** before inventory commits — availability verified upfront\n- **Audit trail** on every action — who did what, when, with what result\n- **Credit guard** — read operations are always free, writes deduct credits transparently\n\n---\n\n## Quick Start (3 steps)\n\n### 1. Create your free account\n\nGo to [orbiads.com](https://orbiads.com) and sign up. You get **5 free credits** — no credit card required.\n\n### 2. Connect Google Ad Manager\n\nFrom the OrbiAds dashboard, click **Connect GAM** and authorize with your Google account. OrbiAds uses OAuth — your GAM credentials never leave Google's infrastructure.\n\n### 3. Configure your AI assistant\n\nPick your platform and follow the guide:\n\n- [Claude setup →](https://github.com/OrbiAds/Orbiads-GAM-MCP/blob/main/docs/install/claude.md)\n- [ChatGPT setup →](https://github.com/OrbiAds/Orbiads-GAM-MCP/blob/main/docs/install/chatgpt.md)\n- [Gemini setup →](https://github.com/OrbiAds/Orbiads-GAM-MCP/blob/main/docs/install/gemini.md)\n- [Other tools (Cursor, Codex, Warp) →](https://github.com/OrbiAds/Orbiads-GAM-MCP/blob/main/AGENTS.md)\n\nThen start with:\n\n> *\"Connect to my GAM account and show me my active networks\"*\n\n---\n\n## MCP Server Details\n\n| Property | Value |\n| --- | --- |\n| Endpoint | `https://orbiads.com/mcp` |\n| Transport | `streamable-http` (default) · `sse` |\n| Auth | OAuth 2.0 — Google account via OrbiAds |\n| GAM API version | `v202605` |\n| MCP Protocol | `2025-03-26` |\n\n---\n\n## Repository Structure\n\n```text\nskills/ ← 27 parent-tool sub-skills + orchestrator (generated from backend)\ncommands/ ← 5 /adops slash commands for Claude Code\nagents/ ← Parallel audit subagents (audit-delivery, audit-inventory, …)\nhooks/ ← Claude Code hooks (hooks.json)\ncli/ ← OrbiAds CLI package (pip install orbiads-cli)\ndocs/ ← Installation guides, tool matrix, query library\n_docs/ ← Internal: legacy tool mapping, anti-collision rules\n.claude-plugin/ ← Claude plugin manifest (plugin.json, marketplace.json)\nAGENTS.md ← Cross-LLM contract for Cursor, Codex, Gemini, Warp, etc.\nCLAUDE.md ← Claude Code project guidance\n```\n\n> Skills and the tool matrix are **generated** from the backend catalogue — do not hand-edit them. See `CLAUDE.md` for the generated vs. hand-authored breakdown.\n\n---\n\n## Pricing\n\n| Plan | Price | Credits |\n| --- | --- | --- |\n| Trial | Free | 5 credits (no card) |\n| Starter | €39/month | 50 credits/month |\n| Early Access | **€29/month** ← locked for life | 50 credits/month |\n| Pack S | €29 one-time | +50 credits |\n| Pack L | €45 one-time | +100 credits |\n\nReads are always free. Credits are only consumed on write and deploy operations.\n\n[**Start free →**](https://orbiads.com)\n\n---\n\n## License\n\nThe contents of this repository — distribution scaffold, skills, agents, workflows, JSON schemas, CLI client, platform integration manifests, documentation, and examples — are released under the [MIT License](https://github.com/OrbiAds/Orbiads-GAM-MCP/blob/main/LICENSE).\n\nThe OrbiAds MCP server backend and Cloud Run services that the hosted endpoint at `https://orbiads.com/mcp` connects to are NOT in this repository and are governed by separate proprietary terms — [see terms at orbiads.com](https://orbiads.com).\n\n

\n
\n $\"OrbiAds$ \n

\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"categoryDisplayName","Developer Tools","upstream",{"_95":96,"_97":98,"_99":100,"_101":102,"_103":104},"requiredSecrets",[],"tags",[],"assets",[],"stats",{"_93":80,"_94":80},"ratingAvg","reviewCount","topics",[105,106,107,108,109,110,111,112],"license","MIT","language","Python","registryName","io.github.OrbiAds/gam","homepage","https://orbiads.com/","ad-manager","adops","adops-tools","gam","google-ad-manager","mcp-server","mcp-tools","trafficking","ENV",{"_115":116,"_117":118,"_119":120},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]

OrbiAds — Google Ad Manager