Auto Complete
get_v1_auto_completeAuto Complete Group: Explore. Billing per call: 1 Credits.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | ||
| gl | No | ||
| hl | No |
get_v1_auto_completeAuto Complete Group: Explore. Billing per call: 1 Credits.
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | ||
| gl | No | ||
| hl | No |
Changes observed during successful MCP inspections. Dates show when Glama detected each change.
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries full burden for behavioral disclosure. The only behavioral hint is 'Billing per call: 1 Credits', which is a cost note but does not explain side effects, return behavior, or prerequisites. The description is essentially silent on what happens when the tool is called.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is extremely short, but this is under-specification rather than concise writing. It lacks substance and fails to earn its place; a few meaningless phrases are not effective structure.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a tool with 3 parameters, no output schema, and no annotations, the description is completely inadequate. It provides no information about expected inputs, return values, or edge cases, making it unusable for an agent.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 0%, so the description must compensate for parameter meaning, but it provides none. Parameters q, gl, and hl are left entirely to the schema examples, which are insufficient without context.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description 'Auto Complete Group: Explore' does not state what the tool does beyond the name and group label. It fails to describe any verb, resource, or scope, making it essentially a tautology with no functional information.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no guidance on when to use this tool versus its siblings. The description provides no context for scenarios where autocomplete would be appropriate, such as suggesting queries or terms.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Add one secure layer between your agents and this server.
Several tools have overlapping purposes, notably get_v1_video_details and get_v2_video_details likely serve the same function, and post_channel_videos vs get_v1_channel_videos could confuse agents. Other names like get_v1_channel_channels are vague and lack clear boundaries.
Naming mixes version prefixes (v1, v2) and verb variations (get, post). Many tools follow a pattern of get_v1_[category]_[resource], but exceptions like get_v1_auto_complete, get_v1_home, and get_v1_search break the consistency, creating a non-uniform convention.
20 tools is on the higher end but still plausible for a YouTube API covering multiple resource types. However, duplicate tools (v1/v2) and overlapping features inflate the count and suggest unnecessary overhead.
The tool set covers a broad range of read operations—channels, videos, playlists, community posts, search, and trending—but lacks update/delete capabilities and only has one POST action. Duplicate endpoints also indicate redundancy rather than true expansion of coverage.