Orbiads GAM MCP

What OrbiAds/Orbiads-GAM-MCP MCP server does

The hosted service gives compatible AI clients a natural-language interface to Google Ad Manager (GAM). It covers operational work across networks, orders, line items, creatives, inventory, targeting, forecasts, and reports. The repository describes more than 270 operations, including support for image, video, HTML5, and native creative workflows.

Typical requests include listing accessible networks, reviewing active orders, checking delivery availability for an ad unit, exploring inventory, running a delivery report, or preparing a campaign change. The service is intended for ad-operations teams and publishers that manage GAM and want an agent to guide API-driven tasks.

How it works

The hosted MCP endpoint is https://orbiads.com/mcp. An MCP-capable client connects to that URL and presents the available GAM operations to the agent. Authentication uses Google OAuth, with the hosted flow handled through the service rather than requiring users to manage GAM API tokens in the client configuration.

Write operations use a plan, confirmation, and execution sequence. This allows an agent to show the proposed mutation before it is sent to GAM. The hosted server and the command-line client use the same backend, credit system, and safety rules. Internet access is required; the hosted MCP path does not run offline.

For teams evaluating the OrbiAds/Orbiads-GAM-MCP MCP server, the main distinction is between conversational agent use and scripted automation. The hosted MCP route is designed for guided work in an AI client, while the Python CLI is intended for terminal commands, CI/CD pipelines, and headless workflows.

Setup and configuration

Create an OrbiAds account, connect Google Ad Manager, and add the endpoint URL to the MCP client. The README gives configurations for Claude Desktop, Gemini, and ChatGPT, and also identifies Cursor, OpenAI Codex, and Warp as supported connection environments. Claude Desktop uses an HTTP MCP server entry pointing to the hosted URL.

The repository also documents a CLI installation:

pip install orbiads-cli
orbiads auth login
orbiads network info

The CLI requires Python 3.10 or newer. Its login command uses Google OAuth Device Flow. On Windows, macOS, and Linux, the Python scripts directory may need to be added to PATH after a user-level pip installation.

Tools and capabilities

Supported operation areas include:

• Network discovery and network information
• Orders and line-item management
• Image, video, HTML5, and native creatives
• Ad-unit and inventory exploration
• Targeting and availability forecasting
• Interactive delivery reporting
• Ad-operations compliance checks
• Confirmed write workflows for mutations

Use the OrbiAds/Orbiads-GAM-MCP MCP server when the agent needs current data from a connected GAM network or must prepare and confirm changes rather than only answer questions from static documentation. The CLI exposes related commands such as orders list, line-items list, creatives list, inventory ad-units, forecast check, and report run.

Limitations and notes

The hosted MCP service requires an OrbiAds account, a connected Google Ad Manager account, OAuth authentication, and an internet connection. Usage is subject to the service’s credit system; the README advertises a free account and trial credits, but does not establish that all future hosted usage is free. The public repository is described as an MIT-licensed mirror of the distribution, while the hosted endpoint remains an external service.