MCP Reference
Operate your Google Ads accounts from Claude Code, Codex, or claude.ai — the same read and propose tools the dashboard uses, over MCP.
Bid & Scale has two machine surfaces. This one is a remote MCP server at /api/mcp that exposes the Ads
copilot's tools — every read and every gads_propose_* write — to any MCP client. An agent in Claude Code
operates an account exactly as the dashboard does, behind the same
safe-apply policy.
Reach for MCP when a person is driving an agent. Reach for the REST API when your own code is driving: it has a versioned URL scheme, typed error codes, and its own keys.
Authorization
OAuth 2.1, what a session reaches, and the projectId-first flow.
Connect Claude Code
Add the server over OAuth, or install the plugin.
Connect claude.ai
Add a custom connector via OAuth.
Set up over MCP
Connect and import an account without leaving your client.
The endpoint
| URL | <your-app-origin>/api/mcp |
| Transport | Streamable HTTP |
| Auth | OAuth 2.1 — the client discovers the authorization server and prompts in a browser. No header to configure. |
The result envelope
Every tool returns a JSON object. Success is { "ok": true, … }; failure is
{ "ok": false, "error": "…" }. Read the error — it usually tells you the next step (connect the account,
trigger a sync, pass a projectId).
Reads are safe, writes move money
Read tools (gads_list_*, gads_get_*, gads_run_gaql_query, …) never change the account. Write tools are all
named gads_propose_* and are money-moving: each is dry-run validated, then auto-applied or queued by the
policy. Every connected session can call them — the policy, not a credential scope, is the bound.
Tool categories
| Category | Tools | What they do |
|---|---|---|
| Reads | 23 | Performance, inventory, plan, change history, audit, GAQL. |
| Setup & connection | 9 | Connect, discover, import, sync, targets. |
| Writes | 34 | Every money-moving gads_propose_* change. |
| Approvals | 3 | Approve, reject, revert (MCP-only). |
| Keyword expansion | 2 | Silo discovery and ideation. |
| Free audit | 3 | Generate and share a client-ready report. |
| Projects | 2 | List accounts, update the brief. |
| Skills & web | 3 | Load a playbook, fetch a URL, read an attachment. |
The MCP server also ships always-on instructions at connect time and, for clients that install the plugin,
runtime playbooks — so a fresh client already knows the golden paths without reading these pages.