OrbiAds/Orbiads-GAM-MCP

English · Français
Hosted MCP for AI agents, plus a Python CLI for terminal and CI workflows.
**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:
3. Ask your agent:
CLI smoke test
Want a deeper setup path? Start with the CLI guide or the agent install guides.
---
Trust Signals
| Signal | Status | Link |
| --- | --- | --- |
| Public repo | MIT licensed mirror of the OrbiAds MCP distribution | LICENSE |
| PyPI CLI | Published as orbiads-cli for terminal and CI workflows | pypi.org/project/orbiads-cli |
| Hosted MCP | Remote Streamable HTTP endpoint with OAuth | https://orbiads.com/mcp |
| Glama | Indexed MCP registry page | glama.ai |
| MCP.so | Indexed MCP directory page | mcp.so |
| Official MCP registry | server.json manifest ready for registry publication | server.json |
| Smithery | Submission target prepared for hosted/external MCP listing | smithery.ai/new |
| Safety model | Plan → confirm → execute on write actions | Safety 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.
Option B: CLI (terminal & scripts)
A lightweight Python CLI for developers, CI/CD pipelines, and headless automation. Same API, same credits, same guardrails.
> [!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
| Criteria | MCP Server | CLI |
| --- | --- | --- |
| Interface | AI agent (Claude, ChatGPT, Gemini) | Terminal / command line |
| Installation | URL to paste into agent settings | pip install orbiads-cli |
| Authentication | OAuth via browser (automatic) | OAuth Device Flow (code displayed) |
| Best for | Exploration, conversations, guided workflows | Scripts, CI/CD, headless automation |
| Output format | Natural language via the agent | JSON or structured table |
| Credits | Same consumption grid | Same consumption grid |
| Offline | No — requires internet | No — requires internet |
| Python required | No | Yes (3.10+) |
> Both methods share the same backend, credits, and safety guardrails.
CLI Quick Reference
| Command | Description |
| --- | --- |
| orbiads auth login | Authenticate via Google OAuth Device Flow |
| orbiads auth status | Check authentication status |
| orbiads network info | Show current GAM network details |
| orbiads network list | List accessible GAM networks |
| orbiads orders list | List orders in the network |
| orbiads line-items list --order ID | List line items for an order |
| orbiads creatives list | List creatives |
| orbiads inventory ad-units | List ad units |
| orbiads forecast check --ad-unit ID | Check inventory availability |
| orbiads report run --template ID | Run 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)