Skip to main content
Glama

Server Details

Create, inspect, and manage Wubble music, speech, voice, and sound-effect requests through MCP.

Status
Healthy
Last Tested
Transport
Streamable HTTP
URL

Glama MCP Gateway

Connect through Glama MCP Gateway for full control over tool access and complete visibility into every call.

MCP client
Glama
MCP server

Full call logging

Every tool call is logged with complete inputs and outputs, so you can debug issues and audit what your agents are doing.

Tool access control

Enable or disable individual tools per connector, so you decide what your agents can and cannot do.

Managed credentials

Glama handles OAuth flows, token storage, and automatic rotation, so credentials never expire on your clients.

Usage analytics

See which tools your agents call, how often, and when, so you can understand usage patterns and catch anomalies.

100% free. Your data is private.
Tool DescriptionsB

Average 3.3/5 across 28 of 28 tools scored. Lowest: 2.6/5.

Server CoherenceA
Disambiguation4/5

Most tools have distinct purposes (e.g., generate vs extend, lyrics vs song), but a few could be confused (e.g., generate_track vs generate_song). Descriptions help clarify, so ambiguity is low overall.

Naming Consistency5/5

All tools follow a consistent `wubble_verb_noun` snake_case pattern. The verb is descriptive (generate, get, upload, etc.) and the naming is uniform across all 28 tools.

Tool Count4/5

28 tools is somewhat high but reasonable for a full-featured audio generation/processing platform. The count reflects the breadth of functionality without being excessive.

Completeness4/5

The tool set covers generation, editing, analysis, voice management, dubbing, and account info. Minor gaps exist (e.g., no delete or list projects), but core workflows are well supported.

Available Tools

28 tools
wubble_analyze_lyricsAnalyze Wubble lyricsB
Destructive
Inspect

Analyze Wubble lyrics. Consumes Wubble requests or credits.

ParametersJSON Schema
NameRequiredDescriptionDefault
upload_audio_idYesUploaded Wubble audio ID to analyze.

Output Schema

ParametersJSON Schema
NameRequiredDescription
dataNo
errorNoDeveloper-service error envelope when the call fails.
successYesWhether the developer-service request succeeded.
Behavior3/5

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

Annotations already declare destructiveHint=true. Description adds 'Consumes Wubble requests or credits', which is useful resource usage info. However, it does not disclose what side effects occur (e.g., what gets destroyed) or any other behavioral traits.

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?

Two-sentence description is concise and front-loaded with the purpose. Each sentence adds value, though the second sentence could be integrated more smoothly.

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

Completeness2/5

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

Given tool complexity (1 param, annotations, output schema), the description is minimal. It does not explain what 'analyze' entails, the return value, or how it differs from many similar siblings, leaving gaps.

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

Parameters3/5

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

Schema coverage is 100% with parameter description, so baseline is 3. Description adds no additional meaning beyond the schema for the single parameter.

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?

Description clearly states 'Analyze Wubble lyrics' with a specific verb and resource, but does not distinguish this tool from sibling tools like wubble_generate_lyrics or wubble_speech_to_text. The mention of consuming credits adds some uniqueness.

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

Usage Guidelines2/5

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

No guidance on when to use this tool versus alternatives. Does not state prerequisites, when-not-to-use, or compare to siblings, leaving the agent without decision support.

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

wubble_change_voiceChange Wubble voiceA
Destructive
Inspect

Change Wubble voice. Consumes Wubble requests or credits.

ParametersJSON Schema
NameRequiredDescriptionDefault
model_idNoOptional model ID.
source_urlYesHTTPS URL for MCP to fetch and convert.
file_formatNoOptional file format.
output_formatNoOptional output format.
target_voice_idYesTarget Wubble voice ID.

Output Schema

ParametersJSON Schema
NameRequiredDescription
dataNo
errorNoDeveloper-service error envelope when the call fails.
successYesWhether the developer-service request succeeded.
Behavior4/5

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

Annotations already indicate destructive=true. The description adds that the tool 'consumes Wubble requests or credits', which is useful behavioral context beyond annotations. It does not contradict annotations (readOnlyHint=false, destructiveHint=true).

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?

Description is two short sentences, front-loads the purpose, and contains no filler. Every word is necessary.

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?

With output schema present (not shown, but indicated), the description does not need to explain return values. It mentions a key constraint (credit consumption) and the source URL format. However, it lacks context on how this differs from sibling tools or what typical use cases are. Overall acceptable given available structured fields.

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

Parameters3/5

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

Input schema covers 100% of parameters with descriptions. The tool description does not add any extra meaning or constraints for parameters like file_format or model_id. Per guidelines, baseline of 3 is appropriate when schema coverage is high.

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?

Title and description clearly state it changes a Wubble voice. The verb 'Change' and resource 'voice' are specific. However, it doesn't differentiate from siblings like 'wubble_isolate_voice' or 'wubble_dub_audio' which also involve voice modification. The description could be more precise about what aspect of voice is changed.

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

Usage Guidelines2/5

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

The description provides no guidance on when to use this tool vs alternatives like wubble_text_to_speech or wubble_dub_audio. It only mentions that it consumes credits, which is a side effect, not a usage condition.

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

wubble_create_podcastCreate Wubble podcastC
Destructive
Inspect

Create Wubble podcast. Consumes Wubble requests or credits.

ParametersJSON Schema
NameRequiredDescriptionDefault
promptYesPodcast topic or direction.
voicesNo
conversationsNo
background_musicNoWhether to include background music.

Output Schema

ParametersJSON Schema
NameRequiredDescription
dataNoWubble developer-service response data.
errorNoDeveloper-service error envelope when the call fails.
successYesWhether the developer-service request succeeded.
Behavior3/5

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

The description adds that the tool consumes 'Wubble requests or credits', which is a behavioral detail beyond the destructiveHint annotation. However, it does not elaborate on what exactly gets destroyed, authentication needs, or cost implications. Given the destructiveHint annotation, this is adequate but not exceptional.

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

Conciseness3/5

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

Two sentences, no fluff. However, the description is extremely brief and could benefit from additional context without becoming overly verbose. It is concise but under-informative.

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

Completeness2/5

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

The description covers the basic action and cost, but fails to provide context for parameter usage, expected output, or differentiation from similar tools. Given the tool has 4 parameters and an output schema, the description should at least summarize the creation process or point to documentation. It is not contextually complete.

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?

The description provides no parameter-level information. The schema covers only 50% of parameters with descriptions, leaving `voices` and `conversations` undocumented. The description fails to clarify their purpose or format. For a tool with low schema coverage, the description should compensate but does not.

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?

The description clearly states the action ('Create') and resource ('Wubble podcast'), and adds a constraint about consuming requests or credits. It distinguishes from siblings that deal with songs or audio editing. However, it does not elaborate on what constitutes a podcast in this context.

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

Usage Guidelines2/5

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

No guidance on when to use this tool versus alternatives. The description only states the basic action and resource consumption, but does not differentiate from sibling tools like wubble_generate_song or wubble_text_to_speech. Agents would need to infer usage from the name alone.

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

wubble_describe_audioDescribe Wubble audioC
Destructive
Inspect

Describe Wubble audio. Consumes Wubble requests or credits.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlYesWubble-owned or user-provided audio URL to describe.
modelNoOptional model.

Output Schema

ParametersJSON Schema
NameRequiredDescription
dataNo
errorNoDeveloper-service error envelope when the call fails.
successYesWhether the developer-service request succeeded.
Behavior3/5

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

The description adds that the tool 'Consumes Wubble requests or credits,' which partially aligns with destructiveHint=true (consumption). However, beyond that, no further behavioral context (e.g., side effects, required permissions, retry behavior) is disclosed. The annotation already signals destructiveness, so the description adds marginal value.

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?

The description is a single concise sentence with no wasted words. However, it is overly terse and could include more informative context without becoming verbose. It earns its place but lacks depth.

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

Completeness2/5

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

Given the tool's complexity (2 parameters, output schema exists, many siblings), the description is incomplete. It does not explain the optional model parameter's significance, nor does it differentiate from similar audio tools. The presence of an output schema partially compensates, but overall the description leaves significant gaps for an agent.

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

Parameters3/5

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

Schema description coverage is 100% (both 'url' and 'model' have schema descriptions). The description does not add any parameter semantics beyond what the schema already provides—'Wubble-owned or user-provided audio URL' is duplicated. Baseline score of 3 is appropriate as description adds no extra meaning.

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

Purpose3/5

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

The description states 'Describe Wubble audio' which is a verb+resource but remains vague about what 'describe' means—caption, summary, analysis? While it mentions consuming requests/credits, it does not distinguish from siblings like wubble_analyze_lyrics or wubble_speech_to_text. Purpose is somewhat clear but not specific.

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

Usage Guidelines2/5

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

No guidance is provided on when to use this tool versus alternatives. Context signal shows many audio siblings, but the description offers no when-to-use or when-not-to-use criteria. The agent must infer usage from the tool name and title alone.

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

wubble_dub_audioDub Wubble audioC
Destructive
Inspect

Dub Wubble audio. Consumes Wubble requests or credits.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameNoOptional dubbing job name.
end_timeNoOptional end time.
watermarkNoWhether to watermark output.
source_urlYesHTTPS URL for MCP to fetch and dub.
start_timeNoOptional start time.
source_langNoOptional source language code.
target_langYesTarget language code.
num_speakersNoOptional number of speakers.
dubbing_studioNoWhether to enable dubbing studio.
highest_resolutionNoWhether to request highest resolution.
use_profanity_filterNoWhether to use profanity filter.
disable_voice_cloningNoWhether to disable voice cloning.
drop_background_audioNoWhether to drop background audio.

Output Schema

ParametersJSON Schema
NameRequiredDescription
dataNo
errorNoDeveloper-service error envelope when the call fails.
successYesWhether the developer-service request succeeded.
Behavior3/5

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

Annotations already indicate destructiveHint=true and readOnlyHint=false. Description adds 'Consumes Wubble requests or credits', disclosing cost/consumption, but does not explain what is destroyed (e.g., original audio) or other traits like authorization needs or rate limits.

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?

Two sentences, no wasted words. However, the first sentence is redundant given the title, and the description could be more informative without sacrificing conciseness.

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

Completeness2/5

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

With 13 parameters and many siblings, the description is too brief. It does not explain return values (though output schema exists), process expectations, or how it fits among related tools. Incomplete for effective agent selection.

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

Parameters3/5

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

Schema description coverage is 100%, so the schema documents all 13 parameters. The tool description adds no extra meaning beyond the schema; baseline score of 3 is appropriate.

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

Purpose3/5

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

The description states 'Dub Wubble audio' with a verb and resource, but 'dub' is ambiguous among many audio siblings like wubble_text_to_speech or wubble_speech_to_text. No differentiation or specifics about what dubbing entails.

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

Usage Guidelines2/5

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

No guidance on when to use this tool versus alternatives like wubble_get_dubbing_transcript or other audio processing tools. Lacks context for appropriate usage.

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

wubble_edit_trackEdit Wubble trackA
Destructive
Inspect

Edit Wubble track. Consumes Wubble requests or credits.

ParametersJSON Schema
NameRequiredDescriptionDefault
lyricsNoOptional replacement lyrics.
edit_endYesEdit region end in milliseconds.
track_idNoCaller-owned track/song request ID.
edit_startYesEdit region start in milliseconds.
upload_audio_idNoUploaded Wubble audio ID.
source_duration_msNoOptional source duration in milliseconds.

Output Schema

ParametersJSON Schema
NameRequiredDescription
dataNo
errorNoDeveloper-service error envelope when the call fails.
successYesWhether the developer-service request succeeded.
Behavior4/5

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

Annotations already declare destructiveHint=true, and the description adds the behavioral trait that it consumes Wubble requests or credits, which is valuable beyond the annotations. No contradictions. The description does not elaborate on other traits, but the score is good because it adds meaningful context.

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?

The description is two sentences with zero waste. It is front-loaded with the core purpose and includes an essential behavioral note. Every word earns its place.

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?

Given the tool has 6 parameters, a full schema, and an output schema, the description is minimal but adequate. It captures the main action and a key behavioral aspect. It could add more context about the editing process, but the annotations and schema cover much of the needed information.

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

Parameters3/5

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

Schema description coverage is 100%, so the schema already documents all parameters. The description adds no additional meaning beyond what the schema provides, meeting the baseline expectation.

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?

The description clearly states the action ('Edit') and the resource ('Wubble track'), using a specific verb and resource. It distinguishes from sibling tools by naming the specific editing function. The addition of consumption info adds further specificity.

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

Usage Guidelines2/5

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

The description provides no guidance on when to use this tool versus alternatives like wubble_remix_song or wubble_generate_track. It lacks explicit context for when to edit vs create or transform.

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

wubble_extend_lyricsExtend Wubble lyricsB
Destructive
Inspect

Extend Wubble lyrics. Consumes Wubble requests or credits.

ParametersJSON Schema
NameRequiredDescriptionDefault
lyricsYesExisting lyrics to extend.
promptNoOptional direction for the extension.

Output Schema

ParametersJSON Schema
NameRequiredDescription
dataNo
errorNoDeveloper-service error envelope when the call fails.
successYesWhether the developer-service request succeeded.
Behavior3/5

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

Annotations indicate destructiveHint=true, and the description adds that it consumes Wubble requests or credits, providing cost context. However, it does not disclose what exactly is destroyed or modified, nor any side effects. With annotations present, the description adds some value but remains incomplete.

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?

The description is very short at two sentences, with no wasted words. It is front-loaded with the purpose. However, it sacrifices explanatory depth for brevity, which is acceptable given the simplicity of the tool.

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

Completeness2/5

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

Given the tool has an output schema (from context) and two well-documented parameters, the description could be more complete. It omits important details like what 'extending' entails, whether it creates a new version or modifies the original, and any constraints. For a destructive tool, this is insufficient guidance.

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

Parameters3/5

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

Schema description coverage is 100%, so baseline is 3. The description does not add any meaning beyond what the schema already provides for the two parameters (lyrics and prompt). It simply restates the tool's purpose.

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?

The description clearly states 'Extend Wubble lyrics' indicating the specific verb (extend) and resource (lyrics). It differentiates from siblings like wubble_generate_lyrics (generate new) and wubble_extend_song (extend a song) by focusing solely on lyrics, though it does not explicitly call out these distinctions.

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

Usage Guidelines2/5

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

No guidance on when to use this tool versus alternatives such as wubble_generate_lyrics or wubble_extend_song. The only additional note is about credit consumption, which is a cost concern, not a usage context.

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

wubble_extend_songExtend Wubble songA
Destructive
Inspect

Extend Wubble song. Consumes Wubble requests or credits.

ParametersJSON Schema
NameRequiredDescriptionDefault
modelNoOptional model.
lyricsYesLyrics for the extension.
promptNoOptional extension prompt.
song_idYesCaller-owned completed song request ID.
extend_atYesExtension position in milliseconds.
extend_typeNoWhere to extend the song.

Output Schema

ParametersJSON Schema
NameRequiredDescription
dataNo
errorNoDeveloper-service error envelope when the call fails.
successYesWhether the developer-service request succeeded.
Behavior4/5

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

The description adds the behavioral detail that the tool 'Consumes Wubble requests or credits,' which goes beyond the annotations (destructiveHint: true, readOnlyHint: false) by informing the agent of cost implications. No contradiction with annotations.

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?

The description is two sentences with no wasted words. It front-loads the purpose and then adds a critical behavioral note. Perfectly concise and well-structured.

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?

Given the availability of a full input schema (6 parameters, all described), annotations, and an output schema, the description is adequate. It could mention prerequisites like needing a completed song, but the schema's 'completed song request ID' covers that. The description is minimal but sufficient when combined with structured fields.

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

Parameters3/5

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

With 100% schema description coverage, the baseline is 3. The description adds no parameter-specific information beyond what the schema already provides, so it does not improve or worsen the semantic understanding.

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?

The description clearly states the action 'Extend Wubble song' (verb+resource). However, it does not differentiate from sibling tools like wubble_extend_lyrics or wubble_remix_song, though the name and schema provide some distinction.

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

Usage Guidelines2/5

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

The description provides no guidance on when to use this tool versus alternatives. There is no mention of prerequisites, exclusions, or when not to use it, leaving the agent to infer context from the schema or tool name.

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

wubble_generate_instrumentalGenerate Wubble instrumentalA
Destructive
Inspect

Generate Wubble instrumental. Consumes Wubble requests or credits.

ParametersJSON Schema
NameRequiredDescriptionDefault
promptYesDescription of the instrumental track to generate.

Output Schema

ParametersJSON Schema
NameRequiredDescription
dataNo
errorNoDeveloper-service error envelope when the call fails.
successYesWhether the developer-service request succeeded.
Behavior4/5

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

The description adds that the tool consumes 'Wubble requests or credits,' which is not present in annotations. This gives the agent awareness of resource usage beyond the destructiveHint annotation. However, it does not disclose what the output entails or any side effects.

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?

The description is very concise with two sentences, no redundant information, and the key action is front-loaded. Every sentence adds value.

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?

Given that an output schema exists and annotations cover safety, the description minimally covers purpose and resource consumption. However, it lacks context on output format, limitations, and how it differs from similar tools, leaving the agent with incomplete guidance.

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

Parameters3/5

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

The schema already provides 100% coverage of the single parameter 'prompt' with a description. The tool's description does not add further semantic meaning beyond what the schema offers, earning a baseline score of 3.

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?

The description clearly states the tool generates an instrumental, using a specific verb and resource. However, it does not differentiate from sibling tools like wubble_generate_song or wubble_generate_track, which could produce overlapping results.

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

Usage Guidelines2/5

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

No guidance is provided on when to use this tool versus alternatives, such as wubble_generate_song for vocal tracks or wubble_generate_sound_effect for non-musical audio. The description lacks context about prerequisites or exclusions.

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

wubble_generate_lyricsGenerate Wubble lyricsB
Destructive
Inspect

Generate Wubble lyrics. Consumes Wubble requests or credits.

ParametersJSON Schema
NameRequiredDescriptionDefault
styleNoOptional lyric style.
promptYesDescription of the lyrics to generate.

Output Schema

ParametersJSON Schema
NameRequiredDescription
dataNo
errorNoDeveloper-service error envelope when the call fails.
successYesWhether the developer-service request succeeded.
Behavior3/5

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

Annotations already indicate destructiveHint=true and readOnlyHint=false. The description adds that it consumes 'Wubble requests or credits', providing some resource consumption context. However, it does not elaborate on the destructive aspect (e.g., what is overwritten or lost).

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?

Two concise sentences, front-loaded with the primary action. Every word is informative and no wasted text.

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?

Given the complex sibling toolset and presence of an output schema, the description is minimally adequate. It lacks details on what the output is (though schema covers it) and when to use this over other generation tools. More context would improve completeness.

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

Parameters3/5

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

Schema description coverage is 100%, so the description need not add parameter details. The description does not mention parameters, but the schema already covers them. Baseline score of 3 is appropriate.

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?

The description clearly states 'Generate Wubble lyrics' which is a specific verb and resource. However, it does not explicitly differentiate from siblings like 'wubble_extend_lyrics', though the contrast is implied.

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

Usage Guidelines2/5

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

The description provides no guidance on when to use this tool versus alternatives (e.g., 'wubble_extend_lyrics' or other generation tools). The mention of consuming requests/credits is a constraint, not a usage guideline.

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

wubble_generate_songGenerate Wubble songB
Destructive
Inspect

Generate Wubble song. Consumes Wubble requests or credits.

ParametersJSON Schema
NameRequiredDescriptionDefault
lyricsNoOptional lyrics to use for the song.
promptYesDescription of the song to generate.

Output Schema

ParametersJSON Schema
NameRequiredDescription
dataNo
errorNoDeveloper-service error envelope when the call fails.
successYesWhether the developer-service request succeeded.
Behavior3/5

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

Annotations indicate destructiveHint=true (potential data loss) and readOnlyHint=false (mutates state). The description adds context that it consumes requests/credits, which is valuable. However, it does not explain the destructive nature or any side effects beyond consumption.

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?

Two sentences with no extraneous words. The description is front-loaded with the primary purpose and immediately adds the consumption detail.

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

Completeness2/5

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

Given the complexity (output schema exists, sibling tools like wubble_get_request_status imply async operations), the description lacks mention of result retrieval, queuing, or generation duration. It is insufficient for an agent to fully understand the lifecycle.

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

Parameters3/5

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

Schema description coverage is 100%, so the schema already provides full parameter meanings. The description adds no additional detail beyond what is in the schema, meeting the baseline.

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?

The description clearly states 'Generate Wubble song' which is a specific verb and resource. It distinguishes itself from sibling tools like wubble_generate_lyrics or wubble_generate_instrumental, which have more specific outputs.

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

Usage Guidelines2/5

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

No guidance on when to use this tool versus alternatives such as wubble_generate_lyrics or wubble_generate_instrumental. The description does not mention prerequisites, when to avoid, or context for selection.

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

wubble_generate_sound_effectGenerate Wubble sound effectA
Destructive
Inspect

Generate Wubble sound effect. Consumes Wubble requests or credits.

ParametersJSON Schema
NameRequiredDescriptionDefault
loopNoWhether the sound effect should loop.
textYesSound effect description.
output_formatNoOptional output format.
duration_secondsNoOptional duration from 0.5 to 30 seconds.
prompt_influenceNoOptional prompt influence from 0 to 1.

Output Schema

ParametersJSON Schema
NameRequiredDescription
dataNo
errorNoDeveloper-service error envelope when the call fails.
successYesWhether the developer-service request succeeded.
Behavior3/5

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

Annotations already declare destructiveHint=true and readOnlyHint=false. The description adds the detail that the tool consumes credits, which aligns with destructiveness but does not provide additional behavioral context beyond what annotations imply.

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?

The description is extremely concise at two sentences, with no wasted words. It front-loads the core purpose and includes resource consumption context.

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?

While the tool has 5 parameters, an output schema, and many siblings, the description provides only basic information. It lacks details about prerequisites, what the output is, or how to use parameters effectively. Adequate but not comprehensive.

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

Parameters3/5

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

Schema coverage is 100%, with all 5 parameters described in the input schema. The description adds no extra parameter-level meaning, so a baseline score of 3 is appropriate.

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?

The description clearly identifies the tool as generating a Wubble sound effect, with a specific verb and resource. This distinguishes it from sibling tools that generate songs, instrumentals, or other audio types.

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

Usage Guidelines2/5

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

The description mentions resource consumption ('Consumes Wubble requests or credits') but gives no guidance on when to use this tool versus other generation tools like wubble_generate_instrumental or wubble_generate_song. There is no explicit when-not or alternative specification.

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

wubble_generate_trackGenerate Wubble trackC
Destructive
Inspect

Generate Wubble track. Consumes Wubble requests or credits.

ParametersJSON Schema
NameRequiredDescriptionDefault
lyricsNoOptional lyrics.
promptNoOptional generation prompt.
song_idNoCaller-owned completed song request ID.
generate_endNoEnd time in milliseconds.
vocal_genderNoOptional vocal gender.
generate_typeYesTrack type to generate.
generate_startNoStart time in milliseconds.
upload_audio_idNoUploaded Wubble audio ID.

Output Schema

ParametersJSON Schema
NameRequiredDescription
dataNo
errorNoDeveloper-service error envelope when the call fails.
successYesWhether the developer-service request succeeded.
Behavior2/5

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

Description adds that tool 'consumes Wubble requests or credits,' which aligns with destructiveHint=true, but does not elaborate on side effects or resource consumption beyond annotations. openWorldHint=true suggests unknown side effects, not addressed.

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?

Two sentences, front-loaded with action (generate track) and a brief note on resource consumption. No unnecessary words, but could be more structured.

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

Completeness2/5

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

Given 8 parameters, many optional, and numerous sibling tools, the description is too minimal. It does not explain parameter relationships (e.g., lyrics vs prompt) or output, leaving the agent without sufficient context to use the tool effectively.

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

Parameters3/5

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

Schema coverage is 100%, so description does not need to repeat parameter details. It adds no extra meaning beyond what schema already provides, so baseline 3 is appropriate.

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

Purpose3/5

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

Description states action and resource ('Generate Wubble track'), but does not differentiate from sibling tools like wubble_generate_instrumental or wubble_generate_song. Purpose is clear but vague without scoping.

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

Usage Guidelines2/5

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

No guidance on when to use this tool versus alternatives. Lacks context on prerequisites or exclusions.

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

wubble_get_creditsGet Wubble creditsA
Read-only
Inspect

Get Wubble credits. Reads information from the connected Wubble account.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
dataNo
errorNoDeveloper-service error envelope when the call fails.
successYesWhether the developer-service request succeeded.
Behavior3/5

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

Annotations already declare readOnlyHint=true, so 'reads information' is consistent but adds little new. The mention of 'connected Wubble account' clarifies scope but does not delve into potential side effects or rate limits.

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?

Two succinct sentences with no filler. Every word contributes to understanding the tool's purpose and scope.

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

Completeness5/5

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

For a simple read-only tool with no parameters and an existing output schema, the description adequately covers the essential behavior. The output schema handles return value details.

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

Parameters4/5

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

With no parameters, the description does not need to elaborate. It adds context by specifying that credits come from the 'connected Wubble account', which is a useful detail beyond the empty schema.

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?

The description clearly states it retrieves 'Wubble credits' and reads from the connected account. It distinguishes itself from sibling tools like wubble_get_usage by specifying a different resource (credits vs usage).

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

Usage Guidelines2/5

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

No guidance on when to use this tool versus alternatives such as wubble_get_usage. There is no explicit context for when it is appropriate or when to avoid it.

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

wubble_get_dubbing_transcriptGet Wubble dubbing transcriptA
Read-only
Inspect

Get Wubble dubbing transcript. Reads information from the connected Wubble account.

ParametersJSON Schema
NameRequiredDescriptionDefault
formatYesTranscript format.
dubbingIdYesDubbing provider/request ID.
language_codeYesTranscript language code.

Output Schema

ParametersJSON Schema
NameRequiredDescription
dataNo
errorNoDeveloper-service error envelope when the call fails.
successYesWhether the developer-service request succeeded.
Behavior3/5

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

Annotations already indicate readOnlyHint=true and destructiveHint=false, so the safety profile is clear. The description adds 'Reads information from the connected Wubble account', which is consistent with annotations but adds minimal new behavioral context (e.g., requires an active account connection). No contradictions.

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?

The description is extremely concise: two sentences with no redundant information. It front-loads the action and follows with a single clarifying statement, making it easy to parse quickly.

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?

Given the presence of an output schema and annotations that cover safety, the description is largely sufficient. However, it could benefit from mentioning that the dubbing request must be completed before fetching the transcript, but this is a minor gap for a simple get operation.

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

Parameters3/5

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

Schema coverage is 100% with descriptions for all three parameters. The description does not add further meaning or usage hints beyond the schema, so it meets the baseline expectation for high-coverage schemas.

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?

The description clearly states the verb 'Get' and the specific resource 'dubbing transcript', making the tool's purpose unambiguous. Among sibling tools, it uniquely identifies this read operation, differentiating it from tools like wubble_speech_to_text or wubble_get_request_status.

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

Usage Guidelines2/5

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

No guidance is provided on when to use this tool versus alternatives. The description does not mention prerequisites, context of use, or excluded scenarios, leaving the agent without decision support.

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

wubble_get_request_statusGet Wubble request statusA
Read-only
Inspect

Get Wubble request status. Reads information from the connected Wubble account.

ParametersJSON Schema
NameRequiredDescriptionDefault
requestIdYesWubble request ID to inspect.

Output Schema

ParametersJSON Schema
NameRequiredDescription
dataNo
errorNoDeveloper-service error envelope when the call fails.
successYesWhether the developer-service request succeeded.
Behavior3/5

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

Annotations already declare readOnlyHint=true and destructiveHint=false, clearly indicating a safe read operation. The description adds no additional behavioral context beyond 'Reads information'. For a read tool, this is minimally sufficient but does not disclose traits like whether status is polled or fetched once, or that it requires a valid requestId.

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?

The description is two short sentences, front-loading the key action. Every sentence is essential, with no redundant or vague phrasing. It achieves maximum information density without fluff.

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?

Given that an output schema exists (describing return values), the description need not explain results. With a single required parameter and annotations conveying safety, the description feels complete for its purpose. A minor gap is lack of mention that the requestId must come from a previous submission, but this is implied by the sibling context.

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

Parameters3/5

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

Schema coverage is 100% (only parameter requestId has a clear description 'Wubble request ID to inspect'). The tool description does not add meaning beyond the schema. Per baseline, score is 3 since schema handles parameter documentation adequately.

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?

The description clearly states the tool's action ('Get Wubble request status') and the resource ('Wubble account'). It specifies a read operation, distinguishing it from mutation tools like wubble_change_voice or wubble_generate_song. The single parameter 'requestId' further clarifies the scope.

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?

The description implies usage for checking status but provides no explicit guidance on when to use this tool versus alternatives like wubble_wait_for_request (which polls until completion) or wubble_get_speech_status. The context of sibling tools is not leveraged to differentiate usage scenarios.

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

wubble_get_speech_statusGet Wubble speech statusB
Read-only
Inspect

Get Wubble speech status. Reads information from the connected Wubble account.

ParametersJSON Schema
NameRequiredDescriptionDefault
requestIdYesSpeech request ID to inspect.

Output Schema

ParametersJSON Schema
NameRequiredDescription
dataNo
errorNoDeveloper-service error envelope when the call fails.
successYesWhether the developer-service request succeeded.
Behavior3/5

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

Annotations already declare readOnlyHint=true and destructiveHint=false. Description adds 'Reads information from the connected Wubble account,' which is minimally helpful beyond annotations. No additional behavioral details.

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?

Two concise sentences, front-loaded. Second sentence adds some context but slightly vague. No wasted content.

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?

Given the tool's simplicity (1 param, read-only, output schema present), the description is adequate. It clearly states the purpose and read nature, though it could explain status content.

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

Parameters3/5

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

Schema has 100% coverage for the single parameter (requestId) with description 'Speech request ID to inspect.' Description does not add extra meaning beyond the schema, so baseline 3.

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?

Description states specific verb and resource ('Get Wubble speech status'), and indicates it reads information. However, it does not differentiate from sibling 'wubble_get_request_status', which may cause confusion.

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

Usage Guidelines2/5

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

No guidance on when to use this tool versus alternatives like 'wubble_get_request_status'. The description provides no context for selection.

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

wubble_get_usageGet Wubble usageB
Read-only
Inspect

Get Wubble usage. Reads information from the connected Wubble account.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
dataNo
errorNoDeveloper-service error envelope when the call fails.
successYesWhether the developer-service request succeeded.
Behavior2/5

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

Annotations already declare readOnlyHint=true, so the description's 'Reads information' is consistent but adds no new behavioral context (e.g., no mention of authentication requirements, latency, or side effects). The description does not leverage the opportunity to add value beyond annotations.

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?

The description is extremely concise: two short sentences that front-load the action. Every word earns its place with no redundancy. It is well-structured for quick comprehension.

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?

Given no parameters, existing annotations, and presence of an output schema, the description is minimally adequate. However, it lacks context about what specific usage data is returned (e.g., numeric counts, account status). While the output schema covers return values, the description could briefly summarize the kind of information provided.

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

Parameters4/5

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

There are zero parameters with 100% schema coverage. Per rubric, baseline is 4. The description does not add param semantics, but none are needed. The description is adequate for a parameterless tool.

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?

Description clearly states verb 'Get' and resource 'Wubble usage', and elaborates 'Reads information from the connected Wubble account.' This distinguishes it from many sibling tools that perform actions like analyze, change, or generate. However, 'usage' could be more specific (e.g., API usage, credits, storage), preventing a perfect score.

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

Usage Guidelines2/5

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

No guidance is provided on when to use this tool versus alternatives like wubble_get_credits or wubble_get_request_status. The description lacks any when-to-use or when-not-to-use context, leaving the agent to infer usage from the name alone.

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

wubble_isolate_voiceIsolate Wubble voiceB
Destructive
Inspect

Isolate Wubble voice. Consumes Wubble requests or credits.

ParametersJSON Schema
NameRequiredDescriptionDefault
source_urlYesHTTPS URL for MCP to fetch and isolate vocals from.
file_formatNoOptional file format.

Output Schema

ParametersJSON Schema
NameRequiredDescription
dataNo
errorNoDeveloper-service error envelope when the call fails.
successYesWhether the developer-service request succeeded.
Behavior3/5

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

With annotations already indicating destructiveHint=true and readOnlyHint=false, the description adds that it consumes requests or credits, which aligns but does not elaborate on what is destroyed or other behavioral traits.

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?

Extremely concise with two short sentences that front-load the purpose. No wasted words.

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

Completeness2/5

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

Despite having an output schema, the description fails to mention what the tool returns or any side effects beyond credit consumption. More context about the isolation process would be helpful.

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

Parameters3/5

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

Schema coverage is 100%, so the description adds no parameter-level information beyond what the schema already provides.

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?

The description clearly states the action (isolate voice) and resource (Wubble voice). However, it does not distinguish this tool from sibling tools like 'wubble_separate_stems', which might perform a similar function.

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

Usage Guidelines2/5

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

No guidance on when to use this tool versus alternatives. The only hint is that it consumes credits, but no context for selection among siblings.

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

wubble_list_voicesList Wubble voicesA
Read-only
Inspect

List Wubble voices. Reads information from the connected Wubble account.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
dataNo
errorNoDeveloper-service error envelope when the call fails.
successYesWhether the developer-service request succeeded.
Behavior3/5

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

Annotations already provide readOnlyHint=true and destructiveHint=false. The description adds 'Reads information from the connected Wubble account', which is helpful but minimal. It does not detail data freshness, scope, or access constraints.

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?

Two sentences, front-loaded with the core action. Every word earns its place; no redundancy.

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

Completeness5/5

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

Tool is simple with zero parameters and an output schema. The description fully suffices for understanding what the tool does. No additional context needed.

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

Parameters4/5

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

No parameters exist, so baseline is 4. Description adds no parameter details since none are needed. The schema coverage is 100% (vacuous). Adequate.

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?

Description explicitly states 'List Wubble voices', clearly identifying the action and resource. It differentiates itself from siblings like wubble_generate_voice or wubble_analyze_lyrics which do not list voices.

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?

No explicit when-to-use or alternatives are provided. The description implies use for retrieving voice information, but does not exclude other scenarios or mention prerequisites.

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

wubble_remix_songRemix Wubble songA
Destructive
Inspect

Remix Wubble song. Consumes Wubble requests or credits.

ParametersJSON Schema
NameRequiredDescriptionDefault
nNoOptional number of variations.
lyricsYesLyrics for the remix.
promptNoOptional remix prompt.
song_idNoCaller-owned completed song request ID.
upload_audio_idNoUploaded Wubble audio ID.

Output Schema

ParametersJSON Schema
NameRequiredDescription
dataNo
errorNoDeveloper-service error envelope when the call fails.
successYesWhether the developer-service request succeeded.
Behavior4/5

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

The description adds 'Consumes Wubble requests or credits' which provides behavioral context beyond the destructiveHint=true annotation. However, it does not elaborate on what exactly gets destroyed (e.g., original song version) or the full side effects.

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?

The description is very concise with two short sentences. Every word is functional, stating the action and a key behavioral note about resource consumption. No wasted text.

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?

Given the tool has 5 parameters and many siblings, the description is minimal. It omits details about parameter relationships, expected output, and when to use vs. other tools. However, the presence of an output schema mitigates the need for return value explanation.

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

Parameters3/5

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

Schema coverage is 100%, so the baseline is 3. The description does not add any parameter-specific information beyond what the schema already provides, such as how 'song_id' relates to existing songs or how 'n' variations are created.

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?

The description states 'Remix Wubble song' which is a clear verb+resource combination. However, it does not differentiate from sibling tools like wubble_extend_song or wubble_generate_song, leaving room for confusion about which specific action is performed.

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

Usage Guidelines2/5

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 instead of alternatives such as generating a new song or extending lyrics. The description does not mention prerequisites or context, leaving the agent without decision criteria.

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

wubble_separate_stemsSeparate Wubble stemsB
Destructive
Inspect

Separate Wubble stems. Consumes Wubble requests or credits.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlYesWubble-owned or user-provided audio URL for stem separation.
modelNoOptional model.

Output Schema

ParametersJSON Schema
NameRequiredDescription
dataNo
errorNoDeveloper-service error envelope when the call fails.
successYesWhether the developer-service request succeeded.
Behavior3/5

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

The description adds that the tool consumes requests or credits, which is useful behavioral info. However, given destructiveHint=true, it does not explain what gets destroyed, leaving some opacity.

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?

The description is exceptionally concise: two sentences that state purpose and cost with no redundant information. Every word serves a purpose.

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?

Given the output schema exists and annotations provide some hints, the description is adequate but does not cover prerequisites, return format, or error scenarios. Completeness is moderate.

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

Parameters3/5

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

Schema coverage is 100% with descriptions for both parameters. The tool description adds no extra parameter details, so baseline 3 is appropriate.

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?

The description clearly states the action ('Separate') and the resource ('Wubble stems'), making the purpose understandable. However, it does not differentiate from sibling tools like wubble_isolate_voice, which might have similar functionality.

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

Usage Guidelines2/5

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

The description provides no guidance on when to use this tool versus alternatives. It only states the action and cost, lacking context for selection.

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

wubble_speech_to_textTranscribe Wubble speechB
Destructive
Inspect

Transcribe Wubble speech. Consumes Wubble requests or credits.

ParametersJSON Schema
NameRequiredDescriptionDefault
diarizeNoWhether to diarize speakers.
keytermsNo
model_idNoOptional model ID.
source_urlYesHTTPS URL for MCP to fetch and transcribe.
language_codeNoOptional language code.
detect_speaker_rolesNoWhether to detect speaker roles.
timestamps_granularityNoTimestamp granularity.

Output Schema

ParametersJSON Schema
NameRequiredDescription
dataNo
errorNoDeveloper-service error envelope when the call fails.
successYesWhether the developer-service request succeeded.
Behavior3/5

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

Annotations already indicate destructiveHint=true and readOnlyHint=false. The description adds that it consumes requests or credits, offering behavioral context beyond the annotations. This is helpful but not extensive.

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?

Two sentences with no wasted words. Essential information is front-loaded.

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

Completeness2/5

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

Despite having an output schema and 7 parameters, the description is minimal. It doesn't discuss output, parameter relationships, or typical use cases, leaving the agent with insufficient context for a complex tool.

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

Parameters3/5

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

Schema description coverage is 86%, so the schema already documents parameters well. The description adds no additional parameter semantics beyond what the schema provides, meeting the baseline.

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?

The description clearly states the tool transcribes Wubble speech, a specific verb and resource. It distinguishes from siblings like wubble_text_to_speech (generates speech) and wubble_describe_audio (describes audio).

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

Usage Guidelines2/5

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

No explicit guidance on when to use this tool versus alternatives. It only mentions credit consumption but doesn't provide context for selection among siblings.

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

wubble_text_to_dialogGenerate Wubble dialogC
Destructive
Inspect

Generate Wubble dialog. Consumes Wubble requests or credits.

ParametersJSON Schema
NameRequiredDescriptionDefault
seedNoOptional deterministic seed.
inputsYes
model_idNoOptional model ID.
settingsNoOptional dialog settings.
language_codeNoOptional language code.
output_formatNoOptional output format.
apply_text_normalizationNoText normalization mode.
pronunciation_dictionary_locatorsNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
dataNo
errorNoDeveloper-service error envelope when the call fails.
successYesWhether the developer-service request succeeded.
Behavior3/5

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

Annotations already indicate destructive and non-read-only nature; the description adds that it consumes credits, which is useful, but does not elaborate on side effects or resource limits.

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

Conciseness3/5

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

The description is a single sentence, which is concise, but it is too brief to cover the tool's complexity, lacking structure and additional context.

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

Completeness2/5

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

With 8 parameters, nested objects, and an output schema, the description does not address important aspects like input structure, behavior, or side effects, making it incomplete despite the presence of annotations and output schema.

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 75%, but the description adds no parameter-specific meaning beyond the schema, missing an opportunity to explain the 'inputs' array or other key fields.

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

Purpose3/5

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

The description states 'Generate Wubble dialog', which is a clear verb-resource pair, but lacks specificity about what 'dialog' entails, especially compared to siblings like wubble_text_to_speech or wubble_generate_lyrics.

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

Usage Guidelines2/5

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

No guidance on when to use this tool versus alternatives; the mention of consuming 'requests or credits' hints at cost but does not clarify use cases or exclusions.

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

wubble_text_to_speechGenerate Wubble speechB
Destructive
Inspect

Generate Wubble speech. Consumes Wubble requests or credits.

ParametersJSON Schema
NameRequiredDescriptionDefault
textYesText to synthesize.
model_idNoOptional model ID.
voice_idNoOptional Wubble voice ID.
language_codeNoOptional language code.
output_formatNoOptional output format. Use mp3_44100_128 for MP3 audio; shorthand mp3 is accepted and normalized.
voice_settingsNoOptional voice settings.

Output Schema

ParametersJSON Schema
NameRequiredDescription
dataNo
errorNoDeveloper-service error envelope when the call fails.
successYesWhether the developer-service request succeeded.
Behavior3/5

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

The description adds the behavioral trait of credit/request consumption beyond annotations (destructiveHint=true). However, it does not detail what exactly is destroyed or any rate limits, leaving some gaps.

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?

Two concise sentences with no fluff. Every word serves a purpose, making it easy to read quickly.

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?

Given the presence of an output schema and high schema coverage, the description is adequate but lacks context on sync/async behavior or error states, which could be inferred from sibling tools like wubble_wait_for_request.

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

Parameters3/5

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

Schema description coverage is 100%, so the baseline is 3. The description adds no additional parameter information; it merely restates the tool's function.

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?

The description 'Generate Wubble speech' clearly indicates the tool's verb and resource. However, among siblings like wubble_text_to_dialog and wubble_generate_song, it lacks explicit differentiation, relying on the tool name and category for distinction.

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

Usage Guidelines2/5

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

No guidance on when to use this tool over alternatives. The only added context is 'Consumes Wubble requests or credits,' which hints at cost but not usage scenario or exclusions.

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

wubble_upload_audioUpload Wubble audioB
Destructive
Inspect

Upload Wubble audio. Consumes Wubble requests or credits.

ParametersJSON Schema
NameRequiredDescriptionDefault
purposeNoOptional upload purpose.
filenameNoOptional filename for the uploaded audio.
source_urlYesHTTPS URL for MCP to fetch and upload to Wubble.
content_typeNoOptional media content type.

Output Schema

ParametersJSON Schema
NameRequiredDescription
dataNo
errorNoDeveloper-service error envelope when the call fails.
successYesWhether the developer-service request succeeded.
Behavior3/5

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

Annotations already indicate a write operation with destructive potential. The description adds that it consumes requests or credits, which is valuable behavioral context beyond annotations. However, it does not detail other side effects or prerequisites.

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?

The description is extremely concise: one sentence and a fragment. Every word adds value—the action and a key behavioral trait. No waste.

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?

With an output schema present, the description does not need to explain return values. However, it omits contextual details like error behavior, prerequisites, or rate limits. The minimal info combined with good schema/annotations is adequate but not thorough.

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

Parameters3/5

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

All four parameters have descriptions in the schema (100% coverage), so the description adds no parameter-specific meaning beyond what the schema provides. Baseline score applied.

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?

The description uses specific verb ('Upload') and resource ('Wubble audio'), making the primary action clear. It implicitly differentiates from siblings like 'wubble_upload_vocal' by being more general, but does not explicitly distinguish.

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

Usage Guidelines2/5

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

No guidance is provided on when to use this tool versus alternatives. The description only states what it does and that it consumes credits, missing explicit when/when-not or alternative references.

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

wubble_upload_vocalUpload Wubble vocalB
Destructive
Inspect

Upload Wubble vocal. Consumes Wubble requests or credits.

ParametersJSON Schema
NameRequiredDescriptionDefault
filenameNoOptional filename for the uploaded vocal.
source_urlYesHTTPS URL for MCP to fetch and upload as a vocal reference.
content_typeNoOptional media content type.

Output Schema

ParametersJSON Schema
NameRequiredDescription
dataNo
errorNoDeveloper-service error envelope when the call fails.
successYesWhether the developer-service request succeeded.
Behavior3/5

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

Annotations already indicate destructiveHint=true and readOnlyHint=false, so the description's value is limited. It adds the context that the tool 'consumes Wubble requests or credits', which is a useful behavioral trait beyond the annotations. No contradiction.

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?

The description is short (two sentences) and front-loaded: first sentence states the purpose, second adds usage cost. Every sentence is relevant. It could be more concise, but it is appropriately sized for the information given.

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?

Given the presence of an output schema and annotations, the description provides the essential purpose and cost context. However, it lacks details such as whether uploads overwrite existing vocals, size limits, or format constraints. It is adequate but not complete.

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

Parameters3/5

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

Schema description coverage is 100%, so baseline is 3. The description adds no additional meaning to the parameters beyond what the schema already provides. Therefore, no extra value.

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?

Clearly states 'Upload Wubble vocal', specifying the verb (Upload) and resource (Wubble vocal). However, it does not differentiate from the sibling tool 'wubble_upload_audio', which likely has a similar purpose. A score of 4 reflects clear purpose but missing sibling distinction.

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

Usage Guidelines2/5

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

The description provides no guidance on when to use this tool versus alternatives like 'wubble_upload_audio' or other upload tools. It mentions credit consumption but lacks exclusions or context-specific usage. This is minimal guidance.

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

wubble_wait_for_requestWait for Wubble requestC
Read-only
Inspect

Wait for Wubble request. Reads information from the connected Wubble account.

ParametersJSON Schema
NameRequiredDescriptionDefault
requestIdYesWubble request ID to wait for.
timeout_secondsNoMaximum seconds to wait in this tool call. Max 45.
poll_interval_secondsNoSeconds between status checks. Max 10.

Output Schema

ParametersJSON Schema
NameRequiredDescription
dataNo
errorNoDeveloper-service error envelope when the call fails.
successYesWhether the developer-service request succeeded.
Behavior2/5

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

Annotations already declare readOnlyHint=true, so the description adds minimal value. It does not disclose timeouts, blocking behavior, or consequences of exceeding parameters, which are critical for a waiting tool.

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?

Extremely concise with no wasted words, but could include more substance without increasing length significantly.

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

Completeness2/5

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

Given the existence of an output schema, the description does not explain the waiting mechanism, what triggers completion, or how timeouts are handled. Agents need more context for correct invocation.

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

Parameters3/5

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

Schema coverage is 100% with parameter descriptions. The tool description adds no additional meaning beyond what the schema already provides.

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?

The description states the action (wait) and resource (Wubble request), and mentions reading information. However, it does not explicitly differentiate from sibling wubble_get_request_status, which likely performs a one-time status check.

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

Usage Guidelines2/5

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

No guidance on when to use this tool versus alternatives like wubble_get_request_status. The description does not indicate that this is a blocking polling operation.

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

Discussions

No comments yet. Be the first to start the discussion!

Try in Browser

Your Connectors

Sign in to create a connector for this server.

Resources