Walled gardens

Google Ads

  • Interfaces4
  • TypesREST, MCP
  • Exact tasks3 of 3
  • Last re-checked14 Nov 2026
  • Maturity index49 · rank 42

States are what public documentation describes for each interface, not account entitlement or tested behaviour. Dataset v2026-11-15.30. How the Atlas decides.

Open the full record Suggest a correction

  1. REST

    Google Ads API

    Released · no GA label

    • Readdocumented
    • Writedocumented
    • Optimizedocumented
    • Activatelimited
    Access
    Approved partners or by request
    Sign-in
    OAuth, cloud IAM
    Qualifies for
    Claims reviewed
    Not re-checked yet; research dated 12 Nov 2026 · 2 sources on the record
    Sources watched
    Weekly watch read 2 of 2 cited pages, last 13 Nov 2026
    Endpoint probed
    Not probed
    Task scope from
    Reviewed use-case tag only (objects not typed)
    In the Atlas since
    Release v2026-11-12-proto.1 (when we recorded it, not a launch date)

    Setup not mapped yet: start from the vendor's docs linked on the full record.

    Notes and sources Correct M086

  2. MCP

    Google Ads MCP server

    Released · no GA label · since 7 Oct 2025 (announcement)

    • Readdocumented
    • Writelimited
    • Optimizeexcluded
    • Activatelimited
    Access
    Approved partners or by request
    Sign-in
    OAuth, cloud IAM
    Claims reviewed
    Re-checked 14 Nov 2026, corrected · 3 sources on the record
    Sources watched
    Weekly watch read 2 of 3 cited pages, last 13 Nov 2026
    Endpoint probed
    Not probed
    Task scope from
    Typed objects or effects from the record
    Compared side by side
    Walled-garden ads MCP servers
    Evidence depth
    Each of read, write, optimize, activate, access, auth, launch is tied to one decisive vendor source, checked 14 Nov 2026. Sources and paraphrases on the full record.
    In the Atlas since
    Release v2026-11-12-proto.1 (when we recorded it, not a launch date)
    Set it up from the vendor's own pages, checked 14 Nov 2026
    Provider
    Google (official, open source)
    Hosting
    You run it: locally over stdio, or as your own Streamable HTTP server on Cloud Run. No Google-hosted endpoint is published.
    Before you start
    • A Google Cloud project with the Google Ads API enabled; that alone gives test-account access
    • Production accounts need an approved Google Ads API access level (Explorer, Basic or Standard) for that project
    • Local mode: Python 3.10+, pipx, the gcloud CLI and an OAuth client or service account
    • Optional: a manager (login) customer ID to reach client accounts
    Sign-in
    Local: Application Default Credentials (OAuth user or service account) with the adwords and cloud-platform scopes. Remote: OAuth 2.0 web-app client; each tool call runs under the caller's identity.
    Clients
    • Claude Code, Cursor, VS Code, Gemini CLI: Add the mcpServers entry below to the client's MCP config file (the README says the same format works across clients).
    • Claude.ai and ChatGPT: Remote deployment only: add a custom connector pointing at your own Cloud Run URL with the /mcp path, using your OAuth client.
    Config

    Local (stdio) entry, from the README (source). Placeholders stay placeholders; it holds no credentials.

    {
      "mcpServers": {
        "google-ads-mcp": {
          "command": "pipx",
          "args": [
            "run",
            "--spec",
            "git+https://github.com/googleads/google-ads-mcp.git",
            "google-ads-mcp"
          ],
          "env": {
            "GOOGLE_APPLICATION_CREDENTIALS": "PATH_TO_CREDENTIALS_JSON",
            "GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID"
          }
        }
      }
    }
    First read
    Tool customers_list_accessible_customers (documented prompt: "What customers do I have access to?"), then search_search with a resource and fields. Since v0.0.6 tools register with their namespace prefix by default; an empty prefix for a namespace in tools_config.yaml (for example search: "") mounts the bare name. An account-data call under your own sign-in, read-only.
    Sandbox
    Test accounts work as soon as the API is enabled in the Cloud project.Docs
    Cost
    No price stated; production use needs an approved API access level. Source
    Limits
    • Writes are limited to assets and labels; it cannot create or change campaigns, ad groups, ads, budgets or bids
    • To block writes entirely, disable the assets and labels tool namespaces in tools_config.yaml
    • The developer guide and the README differ on the project variable name (GOOGLE_CLOUD_PROJECT vs GOOGLE_PROJECT_ID)

    This page is a directory lookup: nothing here signs in, installs, writes or spends. Access, approval and the states above are separate facts; a recipe never widens them.

    Notes and sources Correct M087

  3. REST

    Merchant API — Merchant Center catalog and UCP performance

    Released · no GA label

    • Readdocumented
    • Writedocumented
    • Optimizeexcluded
    • Activatelimited
    Access
    Any customer account
    Sign-in
    OAuth, cloud IAM
    Claims reviewed
    Re-checked 13 Nov 2026 · 3 sources on the record
    Sources watched
    Cited pages not on the weekly watch yet
    Endpoint probed
    Not probed
    Task scope from
    Typed objects or effects from the record
    In the Atlas since
    Release v2026-11-14.11 (when we recorded it, not a launch date)

    Setup not mapped yet: start from the vendor's docs linked on the full record.

    Notes and sources Correct N309

  4. MCP

    Merchant API MCP Access Service (Alpha)

    Alpha

    • Readdocumented
    • Writelimited
    • Optimizeexcluded
    • Activateunknown
    Access
    Any customer account
    Sign-in
    OAuth, cloud IAM
    Claims reviewed
    Re-checked 13 Nov 2026 · 1 source on the record
    Sources watched
    Cited pages not on the weekly watch yet
    Endpoint probed
    Not probed
    Task scope from
    Typed objects or effects from the record
    In the Atlas since
    Release v2026-11-14.11 (when we recorded it, not a launch date)

    Setup not mapped yet: start from the vendor's docs linked on the full record.

    Notes and sources Correct N310

Dated changes

  1. CorrectedGoogle Ads MCP server: was Activate excluded; date not given; now Activate limited: No ad activation: cannot create, pause or enable campaigns, ad groups or ads. Video upload publishes to YouTube (unlisted by default;…
  2. Source changedGoogle Ads MCP server A cited page changed: 1 capability sentence added, 1 removed since the 2026-11-12 read. The record's states stay as they were until a person reviews the change.

Every change with its stable ID: changes.json · RSS.

Cite as: No Fluff Advisory, Agentic Ecosystem Atlas, Google Ads, dataset v2026-11-15.30, https://nofluffadvisory.com/agentic-atlas/companies/google-ads/