Skip to main content
Glama

AdsAgent — Google Ads MCP

google_ads_asset_inventory_list

Read-only

Read the last complete stored creative inventory, with freshness, filters and snapshot-bound pagination. Missing sync is unknown, not empty; never pulls Google live. Use only returned continuation with the same customer and filters.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
sortNo
searchNo
page_sizeNo
asset_typeNo
customer_idYes10-digit Google Ads customer id.
continuationNo
connection_contextNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / properties / connection_context
      Added value: +{
      +  "pattern": "^mctx_v1_[0-9a-f]{64}$",
      +  "type": "string"
      +}
  2. Added

TDQS

A3.5/5.0
Behavior4/5

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

Annotations already declare readOnlyHint, destructiveHint=false and openWorldHint=false, so the safety profile is covered. The description adds substantive behavior beyond that: snapshot-bound pagination, the 'unknown, not empty' semantic for unsynced data, and the no-live-pull guarantee. It omits freshness/rate-limit or auth details, so not a 5.

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

Conciseness5/5

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

Three tight sentences with the core purpose front-loaded and no filler. Each sentence adds a distinct, load-bearing constraint (snapshot source, unknown-vs-empty semantics, pagination rule).

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

Completeness3/5

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

For a 7-parameter read tool with no output schema and low schema coverage, the description supplies the key behavioral caveats but leaves most parameters unexplained. It is adequate for the tool's core semantics but incomplete for correct invocation of its filters.

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 coverage is only 14% (just customer_id documented), so the description must carry parameter meaning. It only partially does: it explains continuation must be paired with the same customer and filters, but sort, search, page_size, asset_type and connection_context remain undocumented in both schema and description.

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

Purpose4/5

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

States a specific verb and resource: reading the last complete stored creative inventory, and clarifies it is a stored snapshot rather than a live Google pull. It does not name the closest sibling (google_ads_assets_list) to disambiguate, so an agent must infer which inventory source it wants.

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

Usage Guidelines3/5

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

Provides an explicit rule for continuation reuse ('same customer and filters') and warns that missing sync means unknown, not empty, and that it never pulls live data. However, it never states when to prefer this tool over siblings like google_ads_assets_list or creatives_list_cloud, leaving the selection decision implicit.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources