OrbiAds — Google Ad Manager

io.github.OrbiAds由 GitHub 帳號 OrbiAds 發布v1.9.0更新於 Oct 24, 2026

Automate Google Ad Manager: campaigns, line items, creatives, inventory, reporting — 51 tools.

已驗證Streamable HTTP可網頁執行資料與分析商業與電商

概覽

AI 產生的概覽

託管式 MCP 伺服器，讓 AI 助理以自然語言檢視與修改 Google Ad Manager 的廣告活動、訂單項、創意、廣告庫存與報表。

可以做什麼
  • 讀取與規劃廣告活動：檢視即時狀態、試跑、部署、暫停與回復，並管理訂單與訂單項
  • 上傳與審核創意：圖片、HTML5、影片/音訊、素材、點擊追蹤與 SSL 檢查、包裝器與格式
  • 瀏覽與調整廣告庫存：廣告單元樹、版位、指定鍵值、目標對象、藍圖
  • 報表與預測：依範本執行自訂報表、放送檢查、GA4 整合、預覽、原始 PQL 查詢
  • 管理程序化交易、公司資料、網路管理設定、稽核日誌與點數帳務
適用情境
適合已在操作 Google Ad Manager 的廣告營運人員、發布商、代理商與開發者，希望以對話方式上稿活動、查詢庫存或產出報表，而不必在 GAM 介面逐項點選或撰寫 API 腳本。
執行需求
遠端 Streamable HTTP 端點，透過 Google 帳號進行 OAuth 2.0 登入；需要免費的 OrbiAds 帳號，並在其儀表板連接 Google Ad Manager；需要網路連線。MCP 方式不需本機安裝或 Python（選用的 CLI 需 Python 3.10+）。
安裝前請注意
寫入與部署操作會消耗付費點數，試用僅含 5 個免費點數，讀取操作免費。此伺服器可建立、修改、暫停與回復線上廣告活動、交易與庫存，執行前應依賴計畫預覽與確認機制。Google Ad Manager 存取權透過 OrbiAds 以 OAuth 授予，廣告活動、庫存與帳務資料會經過該第三方服務。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 OrbiAds — Google Ad Manager，將其新增到工作區。
  2. 連接 所需的 憑證。它們會被私密儲存，絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.OrbiAds%2Fgam/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。 客戶端會在首次連接時完成 OAuth 登入。

{
  "mcpServers": {
    "orbiads-google-ad-manager": {
      "type": "http",
      "url": "https://orbiads.com/mcp"
    }
  }
}

README

OrbiAds — Google Ad Manager MCP Server

English · Français

[OrbiAds terminal workflow showing Google Ad Manager checks from the command line]
Hosted MCP for AI agents, plus a Python CLI for terminal and CI workflows.

[MCP Protocol] [GAM API] [Version] [PyPI] [Python] [License] [Docs] [GitHub stars] [Works with Claude] [Works with ChatGPT] [Works with Gemini] [Glama] [MCP.so] [Smithery]

OrbiAds is a hosted Google Ad Manager MCP server that gives AI assistants — Claude, ChatGPT, Gemini, Cursor, and OpenAI Codex — direct, natural-language access to Google Ad Manager. It covers 270+ operations across campaigns, orders, line items, creatives, inventory, targeting, and reporting, on the current GAM API (v202605), with OAuth and confirm-before-write guardrails.

→ Get started free at orbiads.com · ★ Star this repo

Try in 3 Minutes

Hosted MCP, no local install

  1. Create a free OrbiAds account at orbiads.com and connect Google Ad Manager.
  2. Add this MCP endpoint to Claude, ChatGPT, Gemini, Cursor, Codex, or Warp:
    text
    https://orbiads.com/mcp
  3. Ask your agent:
    text
    Connect to my GAM account and show me my active networks.

CLI smoke test

bash
pip install orbiads-cliorbiads auth loginorbiads network info

Want a deeper setup path? Start with the CLI guide or the agent install guides.

Trust Signals

SignalStatusLink
Public repoMIT licensed mirror of the OrbiAds MCP distributionLICENSE
PyPI CLIPublished as orbiads-cli for terminal and CI workflowspypi.org/project/orbiads-cli
Hosted MCPRemote Streamable HTTP endpoint with OAuthhttps://orbiads.com/mcp
GlamaIndexed MCP registry pageglama.ai
MCP.soIndexed MCP directory pagemcp.so
Official MCP registryserver.json manifest ready for registry publicationserver.json
SmitherySubmission target prepared for hosted/external MCP listingsmithery.ai/new
Safety modelPlan → confirm → execute on write actionsSafety docs

Two Ways to Connect

OrbiAds offers two integration methods — choose the one that fits your workflow.

Option A: MCP Server (AI agents)

Connect your AI assistant (Claude, ChatGPT, Gemini) to GAM via the hosted MCP endpoint. Conversational, guided, zero-install.

MCP endpoint: https://orbiads.com/mcp

Option B: CLI (terminal & scripts)

A lightweight Python CLI for developers, CI/CD pipelines, and headless automation. Same API, same credits, same guardrails.

bash
pip install orbiads-cliorbiads auth loginorbiads network info

[!IMPORTANT] Windows/macOS/Linux PATH Warning: If you install the CLI via pip (especially with --user), ensure the Python scripts directory is added to your user PATH. Without this, your terminal and local AI agents (like Claude Code, Cursor, or Gemini) will fail to find or execute the orbiads command. See the Troubleshooting section in the CLI Guide for quick setup commands.

Comparison

CriteriaMCP ServerCLI
InterfaceAI agent (Claude, ChatGPT, Gemini)Terminal / command line
InstallationURL to paste into agent settingspip install orbiads-cli
AuthenticationOAuth via browser (automatic)OAuth Device Flow (code displayed)
Best forExploration, conversations, guided workflowsScripts, CI/CD, headless automation
Output formatNatural language via the agentJSON or structured table
CreditsSame consumption gridSame consumption grid
OfflineNo — requires internetNo — requires internet
Python requiredNoYes (3.10+)

Both methods share the same backend, credits, and safety guardrails.

CLI Quick Reference

CommandDescription
orbiads auth loginAuthenticate via Google OAuth Device Flow
orbiads auth statusCheck authentication status
orbiads network infoShow current GAM network details
orbiads network listList accessible GAM networks
orbiads orders listList orders in the network
orbiads line-items list --order IDList line items for an order
orbiads creatives listList creatives
orbiads inventory ad-unitsList ad units
orbiads forecast check --ad-unit IDCheck inventory availability
orbiads report run --template IDRun a delivery report

Full command reference: orbiads.com/docs/cli/commands

Installation Guide

OrbiAds offers three integration pathways depending on your environment.

1. Zero-Install MCP Server (ChatGPT, Gemini, Claude Desktop)

Connect your AI assistant to our hosted server using the Model Context Protocol:

  • Claude Desktop: Add this to your claude_desktop_config.json:
    json
    {  "mcpServers": {    "orbiads": {      "type": "http",      "url": "https://orbiads.com/mcp"    }  }}
  • Gemini / AI Studio: Go to Tools → MCP configuration → Add https://orbiads.com/mcp
  • ChatGPT: Go to Settings → Connectors → Add connector → MCP URL: https://orbiads.com/mcp
  • GLAMA / MCP Registry: Access, test, and connect the server directly in your browser via glama.ai/mcp/servers/OrbiAds/Orbiads-GAM-MCP
  • Other environments (Cursor, Codex, Warp): Add the https://orbiads.com/mcp endpoint to your configuration and copy AGENTS.md to your project root.

2. Claude Code Plugin (Slash Commands)

Add the /adops command set directly into your Claude Code CLI terminal:

bash
claude plugin install orbiads

3. Agent Skills (Structured Workflows)

Install our markdown-based guidelines permanently into Claude Code's memory:

  1. Clone this repository locally.
  2. Run the skill installer:
    bash
    ./install.sh skills --copy

This copies our 6 consolidated skill files to your ~/.claude/skills/ directory. Claude Code will automatically leverage them to prevent hallucinations and strictly apply the plan-before-mutate workflow.

→ Installation guides: Claude · ChatGPT · Gemini · OpenAI Codex

What is OrbiAds?

OrbiAds is a hosted MCP server that connects your AI assistant directly to Google Ad Manager (GAM). Instead of clicking through the GAM interface or writing API scripts, you describe what you want in plain language — OrbiAds handles the API calls, guardrails, and audit trail.

text
You: "Check inventory availability on the homepage banner for a 300x250 in France next week"OrbiAds: [runs forecast] → Available: 1.2M impressions. Pressure: low. Safe to traffic.
You: "Create the line item for Renault, €15 CPM, Monday to Friday"OrbiAds: [applies guardrails] → Preview ready. Confirm to push?

No scripts. No API tokens to manage. No switching tabs.

Who is this for?

  • AdOps managers who traffic campaigns daily and want to move faster without making mistakes
  • Publishers who manage their own GAM network and want AI-assisted workflows
  • Media agencies running multiple GAM accounts who want a consistent, auditable process
  • Developers building AdOps automation on top of Claude, ChatGPT, or Gemini

Supported AI Platforms

PlatformSetup guideMode
Claude (Desktop / claude.ai / Claude Code)docs/install/claude.mdPlugin + MCP remote
ChatGPT (Pro connector)docs/install/chatgpt.mdMCP remote (HTTP)
Geminidocs/install/gemini.mdMCP remote
GLAMA (MCP registry)glama.ai/mcp/servers/OrbiAds/Orbiads-GAM-MCPMCP registry
Cursor / Codex / Warp / otherAGENTS.mdAGENTS.md + MCP wiring

All platforms connect to the same hosted MCP endpoint at https://orbiads.com/mcp.

7 Slash Commands

After installing the plugin, these /adops commands are available directly in Claude Code.

CommandWhat it does
/adops campaignRead live state, plan deployment, dry-run (ExecutionPlan), deploy, pause, rollback — with mandatory plan→confirm→execute gate
/adops auditMulti-dimensional account audit: delivery, inventory, security, creatives, billing
/adops reportCustom reports, delivery queries, CSV export, billing summaries, forecasts
/adops dealPMP deals, private auctions, Marketplace PG/PD proposals
/adops creativeUpload creatives, QA compliance, SSL validation, preview URLs, line item association
/adops inventoryBrowse ad units, manage placements and targeting taxonomy, run blueprints
/adops adminTeams, sites, labels, custom fields, network settings (MCP surface only)

What's Inside (MCP Tools & Skills)

The OrbiAds surface maps the Google Ad Manager API into parent tools and hundreds of actions, organized into 6 core domain Agent Skills plus an orchestrator, to keep context usage clean. See docs/tool-matrix/README.md for the live generated tool and action counts.

Click on any domain below to see which tools and capabilities are included:

1. Campaigns & Creative QA (orbiads-campaigns)
  • campaign — Read live campaign state, plan deployment, dry-run, deploy, pause, and rollback campaigns.
  • orders — Create and list orders, contacts, and roles.
  • line_items — Define line item delivery rules, CPMs, and targeting logic.
  • creatives — Upload creatives (images, HTML5, video/audio) and configure native styles.
  • creative_assets — Manage associated image and file assets.
  • creative_qa — Audit click-trackers, perform compliance scans, and validate SSL certificates.
  • creative_wrapper_skill — Manage third-party wrappers and delivery presets.
  • formats — Discover and configure ad creative formats.
  • jobs & gam_jobs — Monitor async campaign compilation and deployment workflows.
2. Inventory & Targeting (orbiads-inventory)
  • inventory — Retrieve ad unit trees, sizes, and generate ads.json manifests.
  • placements — Create, update, and list ad placement groups.
  • targeting — Manage custom targeting keys/values, countries, and categories.
  • audiences — Retrieve and modify first-party audience segments.
  • blueprint — Generate and push structured network inventory blueprints.
3. Reporting & Forecasting (orbiads-reporting)
  • reporting — Run custom reports from templates, check line item delivery, and integrate GA4.
  • preview — Verify inventory coverage and export preview URLs.
  • pql — Run raw PQL database queries.
4. Programmatic Deals (orbiads-deals)
  • deals — Manage PMP deals, private auctions, and marketplace buyers.
  • companies — Manage agency and advertiser company profiles.
5. Network Admin (orbiads-admin)
  • gam_admin — Access advanced fields, network labels, teams, and site records.
  • gam_features — Query active Google Ad Manager beta and system features.
  • network — List accessible networks and switch active network context.
  • settings — Configure default CPMs, pacing, and brand naming templates.
  • tenant_catalog — Access tenant-specific catalogs.
6. Audits & Billing (orbiads-audit)
  • audit_skill — Run automated security, hygiene, and wrapper coverage audits.
  • billing — Fetch credit balances and transaction histories.
  • audit — Search network audit logs.

See docs/tool-matrix/README.md for the complete parity matrix detailing exact costs, writes, and parameters for all 270+ actions.

Safety by Design

Every write action requires an explicit ExecutionPlan preview and confirmation token. No campaign goes live by accident.

  • Plan-before-mutate on campaign, deal, and product writes — preview the signed ExecutionPlan before you push
  • Dry-run mode on all deployment actions — confirmationToken TTL 300 seconds
  • Forecast gate before inventory commits — availability verified upfront
  • Audit trail on every action — who did what, when, with what result
  • Credit guard — read operations are always free, writes deduct credits transparently

Quick Start (3 steps)

1. Create your free account

Go to orbiads.com and sign up. You get 5 free credits — no credit card required.

2. Connect Google Ad Manager

From the OrbiAds dashboard, click Connect GAM and authorize with your Google account. OrbiAds uses OAuth — your GAM credentials never leave Google's infrastructure.

3. Configure your AI assistant

Pick your platform and follow the guide:

Then start with:

"Connect to my GAM account and show me my active networks"

MCP Server Details

PropertyValue
Endpointhttps://orbiads.com/mcp
Transportstreamable-http (default) · sse
AuthOAuth 2.0 — Google account via OrbiAds
GAM API versionv202605
MCP Protocol2025-03-26

Repository Structure

text
skills/           ← orchestrator skill + 6 consolidated dual-surface domain skills (generated)                     Each domain skill has SKILL.md (thin) + references/actions.md (full catalogue)commands/         ← 7 /adops slash commands for Claude Codeagents/           ← Parallel audit subagents (audit-delivery, audit-inventory, …)hooks/            ← Claude Code hooks (hooks.json)cli/              ← OrbiAds CLI package (pip install orbiads-cli)docs/             ← Installation guides, tool matrix, custom-skill authoring guide_docs/            ← Internal: legacy tool mapping, anti-collision rules.claude-plugin/   ← Claude plugin manifest (plugin.json, marketplace.json)AGENTS.md         ← Cross-LLM contract for Cursor, Codex, Gemini, Warp, etc.CLAUDE.md         ← Claude Code project guidance

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.

Pricing

PlanPriceCredits
TrialFree5 credits (no card)
Starter€39/month50 credits/month
Early Access€29/month ← locked for life50 credits/month
Pack S€29 one-time+50 credits
Pack L€45 one-time+100 credits

Reads are always free. Credits are only consumed on write and deploy operations.

Start free →

License

The 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.

The 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.


[OrbiAds Brand Logo]

來源：README.md，提交 8cb648a

工具

0
該伺服器需要登入，因此 SourceWeft 無法在沒有帳號的情況下讀取其工具，也未收錄。已連接帳號所能看到的內容可能因帳號及其權限而異。

版本歷史

1
  1. v1.9.0最新Sep 16, 2026

評分

已滿足適用檢查項的 85%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分