get_creator
Every indexed sponsorship for one YouTube creator.
Args:
handle: YouTube handle, with or without the leading '@'.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| handle | Yes |
Every indexed sponsorship for one YouTube creator.
Args:
handle: YouTube handle, with or without the leading '@'.
| Name | Required | Description | Default |
|---|---|---|---|
| handle | Yes |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are present, so the description carries the burden of behavioral disclosure. It clarifies that the result is limited to 'indexed' sponsorships and that the handle may include or omit '@', but it does not disclose return format, pagination, or failure behavior.
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 entire definition is two terse lines. It front-loads the main purpose and keeps the parameter note minimal and relevant.
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 low-complexity single-parameter lookup, the description covers what the tool returns, the required input, and the accepted input format. With no output schema, some return structure detail would strengthen it, but none of the core information needed to call it correctly is missing.
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 description coverage is 0%, and the description compensates by explaining the handle parameter: a YouTube handle with optional leading '@'. This adds real meaning over the schema's bare 'Handle' title, though it stops short of providing an example or normalization behavior.
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 states a clear resource ('one YouTube creator') and scope ('every indexed sponsorship'), which is unambiguous for a getter tool. However, it lacks an explicit verb and does not name any sibling tool to set itself apart.
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 over get_brand, list_categories, or search_sponsorships. The only implicit context is that the caller wants sponsorship data associated with a specific creator handle.
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.
Each tool targets a distinct access pattern: get_brand by brand slug, get_creator by YouTube handle, list_categories for taxonomy, and search_sponsorships for filtered discovery. There is slight overlap between get_brand and search_sponsorships when looking up a brand, but the exact-slug vs substring/filter distinction makes the boundaries clear.
Tool names follow a consistent verb_noun pattern: get_ for direct lookup, list_ for enumeration, and search_ for queries. Naming style is uniform with lowercase and underscores.
Four tools is a well-scoped size for a read-only sponsorship index. Each tool covers a core access pattern without redundant additions.
The tool surface covers the main lookup and discovery workflows: by brand, by creator, by category, and by filtered search. Minor gaps like pagination or a full index dump are absent, but agents can still answer typical sponsorship questions.