AdsAgent — Google Ads MCP

creatives_list_cloud

Read-only

Deprecated; answers until 2026-11-18. Use creatives_list, which returns uploaded and cloud files together (filter with library_source='cloud'). This tool returns the same cloud items with a deprecation notice. Each item includes folder_path, modified_time (Drive modified time, or null) and indexed_at. Supported types: image/gif, image/jpeg, image/png, image/webp, video/mp4, video/quicktime, video/webm. Maximum file size is 1073741824 bytes (1 GiB). A larger file returns error_code cloud_file_too_large. Any other type returns error_code cloud_file_type_unsupported. Google Ads images are limited to 5242880 bytes (5 MiB). No writes.

Input Schema

Name	Required	Description
`q`	No
`limit`	No
`parent_id`	No	Drive folder id copied from an earlier item parent_id.
`connection_context`	No

Output Schema

Name	Required	Description	Default
`ok`	No
`code`	No
`meta`	No
`note`	No
`count`	No
`error`	No
`items`	No
`needs`	No
`total`	No
`reason`	No
`status`	No
`folders`	No
`bind_url`	No
`complete`	No
`retryable`	No
`error_code`	No
`invite_url`	No
`cloud_count`	No
`next_action`	No
`next_cursor`	No
`support_ref`	No
`total_count`	No
`folder_count`	No
`folder_limit`	No
`user_message`	No
`invalid_fields`	No
`library_source`	No
`rejected_paths`	No
`upload_library`	No
`expires_in_days`	No
`origin_support_ref`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 28, 2026

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "properties": {
+    "bind_url": {
+      "type": "string"
+    },
+    "cloud_count": {
+      "anyOf": [
+        {
+          "type": "integer"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "code": {
+      "type": "string"
+    },
+    "complete": {
+      "type": "boolean"
+    },
+    "count": {
+      "type": "integer"
+    },
+    "error": {
+      "anyOf": [
+        {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "additionalProperties": true,
+              "properties": {
+                "code": {
+                  "type": "string"
+                },
+                "details": {
+                  "additionalProperties": true,
+                  "properties": {},
+                  "type": "object"
+                },
+                "message": {
+                  "type": "string"
+                },
+                "retryable": {
+                  "type": "boolean"
+                },
+                "support_ref": {
+                  "type": "string"
+                }
+              },
+              "type": "object"
+            }
+          ]
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "error_code": {
+      "type": "string"
+    },
+    "expires_in_days": {
+      "anyOf": [
+        {
+          "type": "integer"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "folder_count": {
+      "anyOf": [
+        {
+          "type": "integer"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "folder_limit": {
+      "anyOf": [
+        {
+          "type": "integer"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "folders": {
+      "items": {
+        "additionalProperties": true,
+        "properties": {},
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "invalid_fields": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "invite_url": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "items": {
+      "items": {
+        "additionalProperties": true,
+        "properties": {
+          "folder_path": {
+            "type": "string"
+          },
+          "library_source": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "read_only": {
+            "type": "boolean"
+          },
+          "selection_key": {
+            "type": "string"
+          },
+          "thumbnail_status": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "thumbnail_url": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "library_source": {
+      "type": "string"
+    },
+    "meta": {
+      "additionalProperties": true,
+      "properties": {
+        "complete": {
+          "type": "boolean"
+        },
+        "has_more": {
+          "type": "boolean"
+        },
+        "limit": {
+          "type": "integer"
+        },
+        "next_continuation": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "next_cursor": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "pagination_complete": {
+          "type": "boolean"
+        },
+        "returned_count": {
+          "type": "integer"
+        },
+        "source": {
+          "type": "string"
+        },
+        "total_count": {
+          "anyOf": [
+            {
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "truncated": {
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "needs": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "next_action": {
+      "anyOf": [
+        {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "additionalProperties": true,
+              "properties": {},
+              "type": "object"
+            }
+          ]
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "next_cursor": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "note": {
+      "type": "string"
+    },
+    "ok": {
+      "type": "boolean"
+    },
+    "origin_support_ref": {
+      "type": "string"
+    },
+    "reason": {
+      "type": "string"
+    },
+    "rejected_paths": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "retryable": {
+      "type": "boolean"
+    },
+    "status": {
+      "type": "string"
+    },
+    "support_ref": {
+      "type": "string"
+    },
+    "total": {
+      "anyOf": [
+        {
+          "type": "integer"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "total_count": {
+      "anyOf": [
+        {
+          "type": "integer"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "upload_library": {
+      "type": "boolean"
+    },
+    "user_message": {
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

Changed1 schema field changedOct 18, 2026

addedInput schema / properties / parent_id

Added value: +{
+  "description": "Drive folder id copied from an earlier item parent_id.",
+  "maxLength": 200,
+  "type": "string"
+}

AddedOct 14, 2026

TDQS

A4.4/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true and destructiveHint=false, and the description still adds substantial context: the returned fields (folder_path, modified_time, indexed_at), supported MIME types, the 1 GiB limit with its error_code, the 5 MiB Google Ads image limit, and the 'No writes' guarantee. Nothing behavioral is left implicit.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with the deprecation and replacement, which is the most decision-relevant information. The trailing limits and error-code list is dense but each item is actionable; it reads slightly like a spec dump rather than prose.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Covers deprecation, return shape, type/size constraints, and error codes, and an output schema exists so return values needn't be re-explained. The only real hole is the undocumented query/limit/connection_context parameters.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is only 25% — only parent_id is documented — and the description does not explain q, limit, or connection_context at all. The one filter mentioned (library_source='cloud') belongs to the replacement tool, not this one's parameters, so the low-coverage gap is not compensated.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb+resource (lists cloud creatives) and immediately distinguishes it from the sibling creatives_list, including the exact filter (library_source='cloud') that reproduces its behavior. An agent can route correctly without opening either schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly marks the tool deprecated with a sunset date (2026-11-18) and names the replacement plus the precise parameter to use instead. This is textbook when-not-to-use guidance with a concrete alternative.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All AdsAgent — Google Ads MCP tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?