Wubble
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.
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.
Tool Definition Quality
Average 3.3/5 across 28 of 28 tools scored. Lowest: 2.6/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.
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.
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.
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
33 toolswubble_analyze_lyricsAnalyze Wubble lyricsBDestructiveInspect
Analyze Wubble lyrics. Consumes Wubble requests or credits.
| Name | Required | Description | Default |
|---|---|---|---|
| upload_audio_id | Yes | Uploaded Wubble audio ID to analyze. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | No | |
| error | No | Developer-service error envelope when the call fails. |
| success | Yes | Whether the developer-service request succeeded. |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations indicate destructiveHint=true, so the description's mention of 'consumes Wubble requests or credits' adds some behavioral context. However, it does not clarify what side effects occur (e.g., is the audio deleted or modified?) beyond credit consumption. With annotations present, the bar is lower, but the description could do more.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is extremely concise with two sentences and no wasted words. It is front-loaded and every sentence earns its place, though some may argue it is too sparse.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the destructiveHint annotation, the description should clarify what gets destroyed. The presence of an output schema does not excuse the lack of explanation about side effects or return value expectations. The description is insufficient for safe invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% with a single parameter adequately described in the schema. The description adds no additional meaning beyond what the schema provides, warranting a baseline score of 3.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool analyzes Wubble lyrics, using a specific verb and resource. However, it does not differentiate from sibling tools like wubble_generate_lyrics or wubble_extend_lyrics, lacking explicit sibling distinction.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternatives. The description fails to provide context for appropriate usage or exclusion criteria.
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 voiceBDestructiveInspect
Change Wubble voice. Consumes Wubble requests or credits.
| Name | Required | Description | Default |
|---|---|---|---|
| model_id | No | Optional model ID. | |
| source_url | Yes | HTTPS URL for MCP to fetch and convert. | |
| file_format | No | Optional file format. | |
| output_format | No | Optional output format. | |
| target_voice_id | Yes | Target Wubble voice ID. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | No | |
| error | No | Developer-service error envelope when the call fails. |
| success | Yes | Whether the developer-service request succeeded. |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already indicate destructiveHint=true and readOnlyHint=false, so the mutation aspect is clear. The description adds value by noting that the tool 'Consumes Wubble requests or credits', which is important cost-related behavior not captured in annotations. This additional context justifies a score above baseline.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is very concise with two short sentences, no filler. However, it is perhaps too brief given the tool's complexity and sibling set; it could be slightly expanded to improve clarity without losing conciseness.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Despite having an output schema and multiple parameters, the description does not explain what the tool returns or provide operational context. It leaves the agent without full understanding of the tool's end-to-end behavior, making it insufficiently complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% with all parameters described. The description does not add any new meaning or clarify parameter usage beyond what the schema already provides, so the score remains at the baseline of 3.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states 'Change Wubble voice' which is a verb+resource pair, but the meaning is vague: it doesn't clarify whether it changes the voice of an existing audio or converts audio to a target voice. The schema implies conversion from source_url to target_voice_id, but the description lacks this detail, making it less specific than it could be.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives like wubble_text_to_speech or wubble_dub_audio. It only mentions credit consumption but no context about prerequisites, exclusion criteria, or comparative scenarios.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
wubble_create_instrumental_and_waitCreate Wubble instrumental and waitBDestructiveInspect
Create Wubble instrumental and wait. Consumes Wubble requests or credits.
| Name | Required | Description | Default |
|---|---|---|---|
| prompt | Yes | Description of the instrumental track to generate. | |
| timeout_seconds | No | Maximum seconds to wait for completion. Max 45. | |
| poll_interval_seconds | No | Seconds between status checks. Max 10. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | No | |
| error | No | Developer-service error envelope when the call fails. |
| success | Yes | Whether the developer-service request succeeded. |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare destructiveHint=true, so the description adds value by noting credit consumption. It doesn't disclose other behavioral traits like what gets destroyed or failure behavior, but annotations cover the safety profile.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two succinct sentences with no wasted words. The purpose is front-loaded, followed by cost implication. Every sentence earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the output schema exists, the description needn't explain return values. However, it lacks context about wait behavior (timeout, polling) beyond what's in parameter descriptions. For a creation tool, more behavioral context would help, but it's minimally adequate.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, and the description adds no parameter details beyond the schema. Baseline 3 is appropriate since the schema fully documents parameters.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it creates an instrumental and waits for completion. It distinguishes from siblings like wubble_generate_instrumental (which may be async), but doesn't explicitly contrast, leaving some ambiguity.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description mentions consumption of requests or credits, hinting at cost, but gives no guidance on when to use this tool vs alternatives (e.g., async generation or other creation tools). No when-not-to-use 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_create_podcastCreate Wubble podcastADestructiveInspect
Create Wubble podcast. Consumes Wubble requests or credits.
| Name | Required | Description | Default |
|---|---|---|---|
| prompt | Yes | Podcast topic or direction. | |
| voices | No | ||
| conversations | No | ||
| background_music | No | Whether to include background music. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | No | Wubble developer-service response data. |
| error | No | Developer-service error envelope when the call fails. |
| success | Yes | Whether the developer-service request succeeded. |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already indicate destructiveHint=true, so the description adds value by revealing that the tool consumes 'Wubble requests or credits,' a resource cost not captured by annotations. This goes beyond what annotations provide.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two short sentences, each earning its place: the first states the action, the second adds a critical resource constraint. No wasted words.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the presence of an output schema, the description does not need to explain return values. However, it omits context like supported voice formats or expected conversation structure. Still, it is adequate for a simple tool with annotations and output schema.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 50% (only prompt and background_music have descriptions). The tool description does not elaborate on any parameter usage or constraints, so it provides no additional help beyond the schema. With moderate coverage, a score of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description uses a specific verb+resource ('Create Wubble podcast') and immediately distinguishes from siblings like 'generate_song' or 'text_to_dialog' by focusing on podcast creation. The resource consumption note further clarifies scope.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No explicit when-to-use or alternatives are provided. The tool's consumption of requests/credits hints at cost considerations, but there is no guidance on when this tool is preferred over siblings like 'wubble_text_to_dialog' for multi-speaker audio.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
wubble_create_song_and_waitCreate Wubble song and waitADestructiveInspect
Create Wubble song and wait. Consumes Wubble requests or credits.
| Name | Required | Description | Default |
|---|---|---|---|
| lyrics | No | Optional lyrics to use for the song. | |
| prompt | Yes | Description of the song to generate. | |
| timeout_seconds | No | Maximum seconds to wait for completion. Max 45. | |
| poll_interval_seconds | No | Seconds between status checks. Max 10. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | No | |
| error | No | Developer-service error envelope when the call fails. |
| success | Yes | Whether the developer-service request succeeded. |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already mark the tool as destructive (destructiveHint=true). The description adds value by stating it 'consumes Wubble requests or credits,' which informs the agent about resource consumption—a behavioral trait not covered by annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is concise (two sentences) and front-loaded with the action. No wasted words, but it could be slightly more informative without becoming verbose.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (synchronous creation with wait), an output schema exists, and parameters are well-documented, the description is adequate but incomplete. It doesn't explain what happens on timeout or failure, or clarify that the tool blocks until completion.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, meaning the input schema already documents all four parameters. The description adds no further parameter-specific meaning beyond stating resource consumption, which is generic. Baseline score of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states 'Create Wubble song and wait,' specifying the verb (create), resource (Wubble song), and blocking behavior (wait). It differentiates from siblings like 'wubble_generate_song' which likely only initiates creation, and 'wubble_wait_for_request' which is a separate polling tool.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage for synchronous song creation but provides no explicit guidance on when to use this tool versus alternatives like 'wubble_generate_song' or 'wubble_wait_for_request'. No when-not or exclusion criteria are given.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
wubble_create_sound_effect_and_waitCreate Wubble sound effect and waitBDestructiveInspect
Create Wubble sound effect and wait. Consumes Wubble requests or credits.
| Name | Required | Description | Default |
|---|---|---|---|
| loop | No | Whether the sound effect should loop. | |
| text | Yes | Sound effect description. | |
| output_format | No | Optional output format. | |
| timeout_seconds | No | Maximum seconds to wait for completion. Max 45. | |
| duration_seconds | No | Optional duration from 0.5 to 30 seconds. | |
| prompt_influence | No | Optional prompt influence from 0 to 1. | |
| poll_interval_seconds | No | Seconds between status checks. Max 10. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | No | |
| error | No | Developer-service error envelope when the call fails. |
| success | Yes | Whether the developer-service request succeeded. |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Adds 'Consumes Wubble requests or credits' beyond annotations, which already declare destructiveHint=true. No contradiction. However, no mention of other behavioral traits like rate limits or failure modes.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Concise at two sentences with front-loaded purpose. No wasted words, though could benefit from more structured presentation.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Despite good schema and annotations, the description is minimal and fails to explain the creation workflow, when to wait vs not, or how it differs from sibling tools. Leaves agent underinformed.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% with full parameter descriptions. The tool description adds no additional meaning to parameters, meeting the baseline expectation.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description clearly states 'Create Wubble sound effect and wait' with a specific verb and resource. However, it does not differentiate from the sibling tool 'wubble_generate_sound_effect', leaving ambiguity about when to use this tool instead.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No explicit guidance on when to use this tool versus alternatives like 'wubble_generate_sound_effect' or other creation tools. The description lacks context for decision-making.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
wubble_create_voiceover_and_waitCreate Wubble voiceover and waitBDestructiveInspect
Create Wubble voiceover and wait. Consumes Wubble requests or credits.
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | Text to synthesize into a finished voiceover. | |
| model_id | No | Optional model ID. | |
| voice_id | No | Optional Wubble voice ID. | |
| language_code | No | Optional language code. | |
| output_format | No | Optional output format. Use mp3_44100_128 for MP3 audio; shorthand mp3 is accepted and normalized. | |
| voice_settings | No | Optional voice settings. | |
| timeout_seconds | No | Maximum seconds to wait for completion. Max 45. | |
| poll_interval_seconds | No | Seconds between status checks. Max 10. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | No | |
| error | No | Developer-service error envelope when the call fails. |
| success | Yes | Whether the developer-service request succeeded. |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description adds waiting behavior and credit consumption beyond annotations. However, it omits details like timeout behavior, error handling, and whether the tool modifies state (destructive). Annotations already indicate destructiveHint=true and readOnlyHint=false.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is extremely brief—two short sentences—with no redundancy or unnecessary detail. It is highly concise and front-loads the core action.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Despite having 8 parameters, nested objects, and an output schema, the description provides minimal context. It does not explain the return value (output), how to handle the wait, or typical use cases. The tool is complex but the description is too sparse.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the input schema fully documents all 8 parameters. The description does not add any parameter-level information, falling short of compensating for any gaps. Baseline 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it creates a voiceover and waits, which is specific and aligns with the name. However, it does not differentiate from sibling creation tools like 'wubble_create_song_and_wait' or 'wubble_text_to_speech', which also produce audio.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description mentions credit consumption but provides no guidance on when to use this tool versus alternatives like text-to-speech or other create-and-wait tools. No scenarios, prerequisites, or exclusions are given.
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 audioCDestructiveInspect
Describe Wubble audio. Consumes Wubble requests or credits.
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Wubble-owned or user-provided audio URL to describe. | |
| model | No | Optional model. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | No | |
| error | No | Developer-service error envelope when the call fails. |
| success | Yes | Whether the developer-service request succeeded. |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already indicate destructiveHint=true and openWorldHint=true. The description adds the note about consuming credits, which aligns with destructiveHint but offers little new insight. It does not explain what gets destroyed or how the tool behaves beyond cost.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is extremely short (one sentence) and gets to the point, avoiding verbosity. However, it sacrifices necessary detail for conciseness, which is acceptable if the schema and annotations carry the burden.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (many siblings, two parameters, output schema exists), the description is insufficient. It fails to clarify what 'describe' means, how the output is structured, or how it differs from similar tools like wubble_speech_to_text.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100% with clear parameter descriptions for 'url' and 'model'. The tool description adds no extra semantic value beyond the schema, so baseline score of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb 'describe' and resource 'Wubble audio', making the tool's purpose apparent. However, it does not elaborate on what 'describe' entails (e.g., transcription, classification), leaving some ambiguity. It is distinguishable from sibling tools given its unique action.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Only mentions consumption of requests/credits, which acts as a cost warning but does not provide guidance on when to use this tool versus alternatives. There is no mention of prerequisites, exclusions, or comparative advantages among sibling tools.
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 audioBDestructiveInspect
Dub Wubble audio. Consumes Wubble requests or credits.
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Optional dubbing job name. | |
| end_time | No | Optional end time. | |
| watermark | No | Whether to watermark output. | |
| source_url | Yes | HTTPS URL for MCP to fetch and dub. | |
| start_time | No | Optional start time. | |
| source_lang | No | Optional source language code. | |
| target_lang | Yes | Target language code. | |
| num_speakers | No | Optional number of speakers. | |
| dubbing_studio | No | Whether to enable dubbing studio. | |
| highest_resolution | No | Whether to request highest resolution. | |
| use_profanity_filter | No | Whether to use profanity filter. | |
| disable_voice_cloning | No | Whether to disable voice cloning. | |
| drop_background_audio | No | Whether to drop background audio. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | No | |
| error | No | Developer-service error envelope when the call fails. |
| success | Yes | Whether the developer-service request succeeded. |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already provide destructiveHint=true and readOnlyHint=false. The description adds that it consumes requests or credits, which is useful cost context. No contradictions. However, it doesn't disclose other traits like whether it modifies existing audio or creates new output.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is very short (two sentences) and front-loaded with the purpose. It is concise but could be slightly expanded without becoming verbose to cover key behavioral aspects.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a tool with 13 parameters, 2 required, and an output schema, the description is too sparse. It does not explain what dubbing involves, what the output is, or how to interpret the many optional flags. The schema is thorough, but the description should complement it with usage context.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so baseline is 3. The description adds no parameter-level detail beyond the schema. It does not explain how or when to use the many optional parameters.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool does audio dubbing, which is a specific verb+resource. It distinguishes from siblings like text-to-speech or analyze lyrics, but doesn't explicitly contrast with similarly named tools like wubble_edit_track or wubble_remix_song.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternatives (e.g., when to dub vs. remix or edit). The only extra info is cost consumption (requests/credits), which hints at usage cost but not selection criteria.
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 trackBDestructiveInspect
Edit Wubble track. Consumes Wubble requests or credits.
| Name | Required | Description | Default |
|---|---|---|---|
| lyrics | No | Optional replacement lyrics. | |
| edit_end | Yes | Edit region end in milliseconds. | |
| track_id | No | Caller-owned track/song request ID. | |
| edit_start | Yes | Edit region start in milliseconds. | |
| upload_audio_id | No | Uploaded Wubble audio ID. | |
| source_duration_ms | No | Optional source duration in milliseconds. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | No | |
| error | No | Developer-service error envelope when the call fails. |
| success | Yes | Whether the developer-service request succeeded. |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already provide destructiveHint=true and readOnlyHint=false, so the description's statement 'Consumes Wubble requests or credits' adds useful context about cost. However, it does not disclose whether edits are reversible, what happens to the original track, or any side effects. The description adds moderate 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.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is extremely concise at two sentences, with the first sentence stating the purpose and the second adding a behavioral note. Every word earns its place, and there is no wasted text. It is front-loaded and efficient.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Despite having 6 parameters, a destructive hint, and an output schema, the description is too minimal. It does not explain what 'edit region' means, how to use upload_audio_id, or the significance of source_duration_ms. The output schema exists but is not referenced. A more complete description is needed for proper tool invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so all parameters are already documented in the schema. The description does not add any additional meaning, such as clarifying the relationship between edit_start and edit_end or how track_id relates to other parameters. Baseline 3 is appropriate given full schema coverage.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb 'Edit' and the resource 'Wubble track', making the tool's purpose immediately understandable. It also adds the behavioral note about consuming requests/credits, which is helpful. However, it does not differentiate this from sibling tools like wubble_remix_song or wubble_generate_track, which could also modify tracks.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool vs. alternatives. There is no mention of prerequisites (e.g., having a track_id), when it's appropriate to edit vs. generate a new track, or any exclusions. With 27 sibling tools, this is a significant gap.
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 lyricsBDestructiveInspect
Extend Wubble lyrics. Consumes Wubble requests or credits.
| Name | Required | Description | Default |
|---|---|---|---|
| lyrics | Yes | Existing lyrics to extend. | |
| prompt | No | Optional direction for the extension. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | No | |
| error | No | Developer-service error envelope when the call fails. |
| success | Yes | Whether the developer-service request succeeded. |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations indicate destructiveHint=true and readOnlyHint=false. The description adds that it consumes requests or credits, which is consistent with a non-read-only operation. However, it does not clarify whether the original lyrics are modified or if costs are reversible. No contradiction with annotations, but more detail on behavior would improve transparency.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is extremely concise with two short sentences. It front-loads the core action and immediately provides the cost trait. Every sentence is necessary and no filler is present.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The description is adequate for a simple tool with an output schema (so return values are documented elsewhere). It covers the main function and cost, but given the large number of sibling tools, more contextual guidance would be beneficial. Still, it is complete enough for an agent to understand the basic purpose.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, with both parameters ('lyrics' and 'prompt') described clearly in the schema. The description adds no additional meaning beyond what the schema already provides, so baseline score of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('Extend Wubble lyrics') and the resource cost ('Consumes Wubble requests or credits'). It distinguishes from siblings like 'wubble_generate_lyrics' which creates new lyrics, but does not explicitly differentiate from 'wubble_extend_song' or other similar tools.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternatives. The description only states what it does without providing context for appropriate usage, such as prerequisites or when to prefer it over other lyric-related tools.
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 songBDestructiveInspect
Extend Wubble song. Consumes Wubble requests or credits.
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | Optional model. | |
| lyrics | Yes | Lyrics for the extension. | |
| prompt | No | Optional extension prompt. | |
| song_id | Yes | Caller-owned completed song request ID. | |
| extend_at | Yes | Extension position in milliseconds. | |
| extend_type | No | Where to extend the song. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | No | |
| error | No | Developer-service error envelope when the call fails. |
| success | Yes | Whether the developer-service request succeeded. |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already indicate writability and destructiveness. The description adds that it consumes Wubble requests or credits, which is useful. However, it does not clarify what is destroyed (e.g., original song? credits?) or other behavioral traits like 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.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two short sentences deliver the core purpose and side effect with no wasted words. Ideal conciseness.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Despite having an output schema, the description omits essential context like prerequisites (completed song), failure modes (insufficient credits), and what the extension result looks like. For a 6-parameter tool, this is inadequate.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so description adds little beyond it. The description does not elaborate on any parameters beyond the schema. Baseline of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action 'Extend Wubble song' and adds a side effect (consumes requests/credits). It distinguishes from siblings like wubble_remix_song and wubble_generate_song. However, it could be more precise about what 'extend' means (e.g., adding a new section).
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description does not provide any guidance on when to use this tool versus alternatives like wubble_remix_song or wubble_generate_song. It lacks context about prerequisites (e.g., need a completed song) or scenarios where extending is preferred.
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 instrumentalBDestructiveInspect
Generate Wubble instrumental. Consumes Wubble requests or credits.
| Name | Required | Description | Default |
|---|---|---|---|
| prompt | Yes | Description of the instrumental track to generate. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | No | |
| error | No | Developer-service error envelope when the call fails. |
| success | Yes | Whether the developer-service request succeeded. |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already indicate destructiveHint=true and readOnlyHint=false. The description adds 'Consumes Wubble requests or credits,' which provides cost context beyond annotations. However, it does not detail other behavioral traits like auth requirements or what gets destroyed.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two concise sentences with zero filler. Every word serves a purpose, making it front-loaded and easy to scan.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the presence of an output schema, the description is adequate for a simple tool with one parameter. However, it lacks context on output format, prerequisites, or differences from sibling tools like wubble_generate_track, which could affect completeness for an AI agent.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the description does not need to add much. The parameter 'prompt' is well-described in the schema. The description's mention of credits is not parameter-specific, so no additional semantic value for parameters.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('Generate') and resource ('Wubble instrumental'), providing a specific verb+resource pairing. However, it does not explicitly distinguish from sibling tools like wubble_generate_track or wubble_generate_song, which could lead to confusion.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternatives. There is no mention of exclusions, prerequisites, or comparison with similar tools like wubble_generate_song or wubble_generate_track.
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 lyricsADestructiveInspect
Generate Wubble lyrics. Consumes Wubble requests or credits.
| Name | Required | Description | Default |
|---|---|---|---|
| style | No | Optional lyric style. | |
| prompt | Yes | Description of the lyrics to generate. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | No | |
| error | No | Developer-service error envelope when the call fails. |
| success | Yes | Whether the developer-service request succeeded. |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already indicate destructiveHint=true; description adds consumption of requests/credits, which aligns but doesn't disclose further behavioral traits like response format or 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.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two sentences with no wasted words; front-loaded with the core action and a key caveat about resource consumption.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Has an output schema (not shown) which likely documents return values. Description is adequate for a simple generation tool but could elaborate on differentiation from sibling generation tools.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so baseline 3. Description adds no parameter-level meaning beyond the schema's own descriptions of prompt and style.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb 'Generate' and specific resource 'Wubble lyrics', distinguishing it from siblings like wubble_generate_song or wubble_generate_instrumental.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternatives (e.g., wubble_generate_song). Only states it consumes requests/credits, implying a cost but no contextual when/when-not.
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 songBDestructiveInspect
Generate Wubble song. Consumes Wubble requests or credits.
| Name | Required | Description | Default |
|---|---|---|---|
| lyrics | No | Optional lyrics to use for the song. | |
| prompt | Yes | Description of the song to generate. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | No | |
| error | No | Developer-service error envelope when the call fails. |
| success | Yes | Whether the developer-service request succeeded. |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description adds 'Consumes Wubble requests or credits', which aligns with the destructiveHint annotation and provides cost context. However, it does not detail side effects like asynchronous operation or required polling, which are beyond the annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is very concise at two sentences with no wasted words. However, it could benefit from slightly more detail without adding bulk.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the presence of an output schema, return values are covered, but the description omits critical context: the tool likely operates asynchronously (sibling wubble_wait_for_request suggests polling). No mention of request ID, processing time, or that this is a non-blocking operation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the schema already fully describes parameters. The description adds no additional meaning to the prompt or lyrics fields, resulting in baseline score.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb 'Generate' and resource 'Wubble song', distinguishing it from siblings like wubble_generate_instrumental or wubble_generate_lyrics. However, it does not elaborate on what constitutes a 'Wubble song' versus other generated audio types.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool over alternatives such as wubble_generate_instrumental or wubble_generate_lyrics. The mention of consuming requests/credits hints at cost but does not provide explicit usage context 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_sound_effectGenerate Wubble sound effectBDestructiveInspect
Generate Wubble sound effect. Consumes Wubble requests or credits.
| Name | Required | Description | Default |
|---|---|---|---|
| loop | No | Whether the sound effect should loop. | |
| text | Yes | Sound effect description. | |
| output_format | No | Optional output format. | |
| duration_seconds | No | Optional duration from 0.5 to 30 seconds. | |
| prompt_influence | No | Optional prompt influence from 0 to 1. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | No | |
| error | No | Developer-service error envelope when the call fails. |
| success | Yes | Whether the developer-service request succeeded. |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description adds that it consumes requests or credits, which goes beyond the 'destructiveHint' annotation by specifying the resource consumed. However, it does not disclose other behaviors like whether it is synchronous or asynchronous, or if there are 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.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is extremely concise, consisting of two short sentences. It is front-loaded and contains no redundant information, earning its place fully.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given that an output schema exists (not shown but indicated) and the input schema is fully described, the description is mostly complete. It adds the crucial detail about credit consumption. However, it lacks any usage context or limitations, which prevents a perfect score.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has 100% description coverage, so the schema already documents all parameters. The description adds no additional meaning or context for any parameter, leading to a baseline score of 3.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it generates a sound effect, which is a specific resource. However, among many sibling 'generate' tools (e.g., generate_song, generate_track), there is no differentiation in scope or behavior, so it doesn't fully distinguish itself.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives (e.g., generate_instrumental, generate_track). The description merely states what it does without context on prerequisites or selection criteria.
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 trackBDestructiveInspect
Generate Wubble track. Consumes Wubble requests or credits.
| Name | Required | Description | Default |
|---|---|---|---|
| lyrics | No | Optional lyrics. | |
| prompt | No | Optional generation prompt. | |
| song_id | No | Caller-owned completed song request ID. | |
| generate_end | No | End time in milliseconds. | |
| vocal_gender | No | Optional vocal gender. | |
| generate_type | Yes | Track type to generate. | |
| generate_start | No | Start time in milliseconds. | |
| upload_audio_id | No | Uploaded Wubble audio ID. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | No | |
| error | No | Developer-service error envelope when the call fails. |
| success | Yes | Whether the developer-service request succeeded. |
Tool Definition Quality
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 behavioral context beyond what annotations provide. The annotations already mark destructiveHint=true, so the description does not contradict and adds modest value, but lacks details like reversibility or effects on existing data.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two short, direct sentences. No filler or redundancy. The first sentence states purpose, the second adds cost context. Could be slightly more structured (e.g., separate lines for purpose and usage notes), but overall efficient.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Despite having an output schema and 8 parameters, the description does not explain what distinguishes a 'track' from other wubble generate tools, nor does it provide typical use cases or output behavior. This is insufficient for an agent to choose this tool correctly among 28 siblings.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents all 8 parameters sufficiently. The tool description adds no parameter-specific information, so per guidelines the baseline of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb 'Generate' and the resource 'Wubble track', and adds the context of consuming requests or credits. However, it does not differentiate from sibling tools like wubble_generate_song or wubble_generate_instrumental, leaving ambiguity about what a 'track' specifically is.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No explicit guidance on when to use this tool versus alternatives. The mention of consuming requests or credits hints at cost, but there is no when-to-use or when-not-to-use advice, nor any reference to prerequisites or alternative tools.
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 creditsARead-onlyInspect
Get Wubble credits. Reads information from the connected Wubble account.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Output Schema
| Name | Required | Description |
|---|---|---|
| data | No | |
| error | No | Developer-service error envelope when the call fails. |
| success | Yes | Whether the developer-service request succeeded. |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true, so the description's claim of 'Reads information' adds no new behavioral insight. No non-obvious side effects or prerequisites are disclosed.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two short sentences, no filler words. Every word earns its place. The structure is front-loaded with the action.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple read operation with no parameters and an output schema, the description is adequate. It could mention that credits are a balance or that the tool is safe to call repeatedly, but not necessary.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
There are zero parameters, and the schema coverage is 100%. The description succinctly identifies the resource, which is sufficient given no parameters need explanation.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool retrieves Wubble credits via a read operation. The verb 'Get' and resource 'Wubble credits' are specific. However, it does not distinguish from siblings like wubble_get_usage, which may also involve reading account info.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. With many sibling tools performing various read and write operations, explicit usage context is missing.
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 transcriptBRead-onlyInspect
Get Wubble dubbing transcript. Reads information from the connected Wubble account.
| Name | Required | Description | Default |
|---|---|---|---|
| format | Yes | Transcript format. | |
| dubbingId | Yes | Dubbing provider/request ID. | |
| language_code | Yes | Transcript language code. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | No | |
| error | No | Developer-service error envelope when the call fails. |
| success | Yes | Whether the developer-service request succeeded. |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and destructiveHint=false, so the description adds no new behavioral traits. The phrase 'reads information from the connected Wubble account' is consistent but redundant 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.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two short sentences with no wasted words. However, the second sentence is slightly redundant given the first, and the description could be more concise while adding useful context.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The tool has an output schema and annotations covering safety, so the description is largely complete for a simple read operation. It could mention that the dubbing must exist or that it supports multiple formats, but the schema handles format details.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% with all parameter descriptions fully defined in the input schema. The description does not add any additional meaning beyond what the schema provides.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it retrieves a dubbing transcript ('Get Wubble dubbing transcript') and adds that it reads from the connected account. However, it does not differentiate this from siblings like wubble_speech_to_text or wubble_text_to_dialog, which also read transcript-like data.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternatives (e.g., wubble_speech_to_text). No mention of prerequisites, when not to use, or recommended context.
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 statusBRead-onlyInspect
Get Wubble request status. Reads information from the connected Wubble account.
| Name | Required | Description | Default |
|---|---|---|---|
| requestId | Yes | Wubble request ID to inspect. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | No | |
| error | No | Developer-service error envelope when the call fails. |
| success | Yes | Whether the developer-service request succeeded. |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and destructiveHint=false, so the description's statement 'Reads information' aligns well. However, the description adds no additional behavioral traits beyond the annotations (e.g., idempotency, error handling, or authentication needs). With annotations covering the safety profile, a 3 is appropriate.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is extremely concise with two short sentences that are front-loaded and contain no filler. Every word serves a purpose.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the simplicity of the tool (1 parameter, output schema present), the description is adequate. It covers the basic purpose and operation. However, it could briefly mention the typical response contents (e.g., 'status: pending/completed/failed') to improve completeness without burdening the description. Since output schema exists, the burden is lower, so 4 is fair.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% for the single parameter 'requestId', which is described as 'Wubble request ID to inspect' in the schema. The tool description does not add any further semantic detail about the parameter, so it provides no value beyond the schema. Baseline 3 is correct.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb 'Get' and the resource 'Wubble request status', and the phrase 'Reads information' emphasizes it is a read operation. While the purpose is clear, it does not explain what 'status' includes (e.g., pending, completed, failed), which could be more specific.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus siblings like 'wubble_wait_for_request' (which likely polls until completion) or when not to use it. It does not mention context such as prerequisites or typical 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 statusARead-onlyInspect
Get Wubble speech status. Reads information from the connected Wubble account.
| Name | Required | Description | Default |
|---|---|---|---|
| requestId | Yes | Speech request ID to inspect. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | No | |
| error | No | Developer-service error envelope when the call fails. |
| success | Yes | Whether the developer-service request succeeded. |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and destructiveHint=false. The description adds 'Reads information from the connected Wubble account,' which aligns with annotations and provides minor context but does not reveal additional behavioral traits beyond what annotations convey.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is two concise sentences with no wasted words. It front-loads the purpose and efficiently adds context about the data source.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple read-status tool with one parameter and an output schema, the description is adequate. It could mention that the output schema provides detailed status, but the presence of the output schema reduces the need for extensive description.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% with a clear description for the sole parameter 'requestId.' The description adds no extra parameter semantics beyond the schema, which is sufficient. Baseline 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose: 'Get Wubble speech status' with a specific verb and resource. It unambiguously identifies the action and distinguishes it from sibling tools like 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.
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 (e.g., wubble_get_request_status). The description does not include conditions, prerequisites, or exclusions, 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_startedGet started with WubbleARead-onlyInspect
Get started with Wubble. Reads information from the connected Wubble account.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Output Schema
| Name | Required | Description |
|---|---|---|
| data | No | |
| error | No | Developer-service error envelope when the call fails. |
| success | Yes | Whether the developer-service request succeeded. |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and destructiveHint=false. The description confirms it reads information, adding minimal context about connecting to an account. It doesn't contradict annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two sentences, very concise. The first sentence 'Get started with Wubble' is somewhat generic but the second clarifies. Minimal wasted text.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given zero parameters and an output schema, the description is reasonably complete. It could be more specific about what information is read, but the output schema likely covers that.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
No parameters exist, so the description doesn't need to explain them. Schema coverage is 100%, meeting baseline expectations.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool reads information from the connected Wubble account, with a specific verb and resource. It distinguishes itself from sibling tools that perform more specific actions (e.g., generate, analyze, edit).
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus its 32 siblings. No mention of prerequisites, alternatives, or when not to use it.
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 usageARead-onlyInspect
Get Wubble usage. Reads information from the connected Wubble account.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Output Schema
| Name | Required | Description |
|---|---|---|
| data | No | |
| error | No | Developer-service error envelope when the call fails. |
| success | Yes | Whether the developer-service request succeeded. |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description adds minimal behavioral context beyond annotations. Annotations already indicate readOnlyHint=true, and the description confirms it reads information. It adds 'from the connected Wubble account,' which provides some additional context but no new safety or 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.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two sentences with no extra words. Front-loaded with the action and object. Every sentence adds value.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple read tool with no parameters and an output schema, the description is complete. It explains the tool's purpose and data source adequately.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
There are no parameters in the input schema, so the description does not need to explain them. Baseline score of 4 applies as the schema coverage is complete.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states 'Get Wubble usage' and 'Reads information from the connected Wubble account,' which is a specific verb-resource combination. It distinguishes from sibling tools that focus on audio generation, lyrics, voices, etc.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives, such as checking usage limits or quotas. The description only states what it does without 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_isolate_voiceIsolate Wubble voiceBDestructiveInspect
Isolate Wubble voice. Consumes Wubble requests or credits.
| Name | Required | Description | Default |
|---|---|---|---|
| source_url | Yes | HTTPS URL for MCP to fetch and isolate vocals from. | |
| file_format | No | Optional file format. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | No | |
| error | No | Developer-service error envelope when the call fails. |
| success | Yes | Whether the developer-service request succeeded. |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already mark destructiveHint=true. The description adds the specific behavioral detail that it consumes 'Wubble requests or credits,' which is useful but not extensive. No additional traits like auth needs or side effects are disclosed.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two short sentences with no extraneous words. The description is front-loaded with the core action and efficiently adds the consumption detail. Every word earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple tool with an output schema, the description is adequate but minimal. It explains the core function and resource consumption but does not provide usage context or mention what the output schema contains. Given the context signals, a bit more context would improve completeness.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the schema already clearly describes both parameters. The description does not add any parameter-level context beyond the schema, meeting the baseline expectation.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action (isolate) and the resource (Wubble voice), and adds the resource consumption aspect. However, it does not differentiate from the sibling tool 'wubble_separate_stems' which might also involve voice isolation, so purpose is clear but not uniquely distinguished.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives, nor are any prerequisites or context given. It simply states what the tool does without helping the agent decide when to invoke it.
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 voicesARead-onlyInspect
List Wubble voices. Reads information from the connected Wubble account.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Output Schema
| Name | Required | Description |
|---|---|---|
| data | No | |
| error | No | Developer-service error envelope when the call fails. |
| success | Yes | Whether the developer-service request succeeded. |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and destructiveHint=false, so the description's claim 'Reads information' aligns. It adds context about the 'connected Wubble account,' which is helpful. However, it does not disclose further behavioral traits like rate limits or scope of available voices.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is extremely concise: two short sentences, no filler, and front-loaded with the core action. Every word adds value.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's simplicity (no parameters, output schema exists, annotations cover safety), the description is complete enough. It specifies the purpose and the source of data (connected account). No further details are necessary for an AI agent to use it correctly.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The tool has zero parameters, and schema description coverage is 100%. According to the rubric, a baseline of 4 is appropriate since the description does not need to explain any parameters.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states 'List Wubble voices' and 'Reads information from the connected Wubble account.' The verb 'list' and resource 'voices' are specific. It distinguishes from siblings like wubble_change_voice or wubble_text_to_speech, which are not listing tools.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. It does not mention prerequisites, limitations, or when not to use it. For a simple listing tool, some context could be useful, but it is missing.
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 songCDestructiveInspect
Remix Wubble song. Consumes Wubble requests or credits.
| Name | Required | Description | Default |
|---|---|---|---|
| n | No | Optional number of variations. | |
| lyrics | Yes | Lyrics for the remix. | |
| prompt | No | Optional remix prompt. | |
| song_id | No | Caller-owned completed song request ID. | |
| upload_audio_id | No | Uploaded Wubble audio ID. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | No | |
| error | No | Developer-service error envelope when the call fails. |
| success | Yes | Whether the developer-service request succeeded. |
Tool Definition Quality
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 useful cost information beyond the destructiveHint annotation. However, it does not detail what exactly gets destroyed or any other behavioral traits like authentication 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.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is very short (two sentences) and front-loaded with the core action. However, it sacrifices important details like parameter relationships or usage context, making it slightly under-informative for its complexity.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool has 5 parameters, is destructive, and consumes credits, the description is too sparse. It does not explain how parameters like song_id vs upload_audio_id relate, nor its role among 26 sibling tools, leaving significant gaps for correct invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the schema already documents all parameters. The description adds no additional meaning beyond what the schema provides, meeting the baseline expectation for high coverage.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action (Remix) and the resource (Wubble song), with a verb+resource structure. However, it does not differentiate from sibling tools like wubble_generate_song or wubble_extend_song, missing a chance to clarify its unique role.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternatives. The description lacks any context about prerequisites, exclusions, or comparison to similar tools, leaving the agent to infer 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_separate_stemsSeparate Wubble stemsADestructiveInspect
Separate Wubble stems. Consumes Wubble requests or credits.
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Wubble-owned or user-provided audio URL for stem separation. | |
| model | No | Optional model. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | No | |
| error | No | Developer-service error envelope when the call fails. |
| success | Yes | Whether the developer-service request succeeded. |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations (destructiveHint=true) already indicate resource consumption. The description adds that it consumes 'requests or credits', which is consistent but not deeply revealing. 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.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two short sentences, no unnecessary words. Efficiently conveys purpose and a key side effect.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With output schema present, return values are covered. However, the optional model parameter is not explained, and no usage context is given. Given openWorldHint=true, more context would be beneficial.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Input schema coverage is 100%, so parameters are documented. The description adds no extra meaning beyond schema descriptions. Baseline 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool separates stems, a distinct audio processing action. It specifies the consumption of requests or credits, differentiating it from sibling tools like isolate_voice.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool over alternatives like isolate_voice or generate_instrumental. No prerequisites or context provided beyond credit consumption.
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 speechBDestructiveInspect
Transcribe Wubble speech. Consumes Wubble requests or credits.
| Name | Required | Description | Default |
|---|---|---|---|
| diarize | No | Whether to diarize speakers. | |
| keyterms | No | ||
| model_id | No | Optional model ID. | |
| source_url | Yes | HTTPS URL for MCP to fetch and transcribe. | |
| language_code | No | Optional language code. | |
| detect_speaker_roles | No | Whether to detect speaker roles. | |
| timestamps_granularity | No | Timestamp granularity. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | No | |
| error | No | Developer-service error envelope when the call fails. |
| success | Yes | Whether the developer-service request succeeded. |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Description adds 'consumes Wubble requests or credits,' aligning with destructiveHint=true. No further behavioral details (e.g., async processing, rate limits). Adequate but not rich 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.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two compact sentences, front-loaded with purpose. Every word adds value; no redundancy. Perfectly concise.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Despite an output schema, the description omits essential context like supported audio formats, language, or whether transcription is synchronous. Minimal for a tool with 7 parameters and many siblings.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 86%, so parameters are well-documented in schema. The tool description adds no extra meaning to parameters, meeting the baseline for high coverage.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool transcribes Wubble speech, which distinguishes it from siblings like wubble_text_to_speech (generates speech) and wubble_describe_audio (describes audio). However, it is vague about what 'Wubble speech' entails (e.g., language, format).
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Only mentions credit consumption but gives no guidance on when to use this tool versus alternatives like wubble_text_to_speech or wubble_describe_audio. No exclusions or contextual clues for selection.
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 dialogBDestructiveInspect
Generate Wubble dialog. Consumes Wubble requests or credits.
| Name | Required | Description | Default |
|---|---|---|---|
| seed | No | Optional deterministic seed. | |
| inputs | Yes | ||
| model_id | No | Optional model ID. | |
| settings | No | Optional dialog settings. | |
| language_code | No | Optional language code. | |
| output_format | No | Optional output format. | |
| apply_text_normalization | No | Text normalization mode. | |
| pronunciation_dictionary_locators | No |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | No | |
| error | No | Developer-service error envelope when the call fails. |
| success | Yes | Whether the developer-service request succeeded. |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already indicate destructive (write) operation. Description adds 'Consumes Wubble requests or credits', disclosing resource usage. This adds some value beyond annotations, but no other 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.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two sentences, no fluff. Action verb first, objective stated immediately. Efficiently concise.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Output schema exists, so return values are covered. However, description lacks context on output form (e.g., audio), prerequisites, or behavior like async processing. Adequate but not comprehensive.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 75%, so baseline is 3. Description does not add extra meaning beyond schema. Parameters are mostly self-documented.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states 'Generate Wubble dialog', specifying the action (generate) and resource (dialog). It distinguishes from siblings like wubble_text_to_speech (single speech) by implying multi-turn nature, but could be more explicit.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternatives (e.g., wubble_text_to_speech). Mentions resource consumption but lacks context for proper selection.
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 speechADestructiveInspect
Generate Wubble speech. Consumes Wubble requests or credits.
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | Text to synthesize. | |
| model_id | No | Optional model ID. | |
| voice_id | No | Optional Wubble voice ID. | |
| language_code | No | Optional language code. | |
| output_format | No | Optional output format. Use mp3_44100_128 for MP3 audio; shorthand mp3 is accepted and normalized. | |
| voice_settings | No | Optional voice settings. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | No | |
| error | No | Developer-service error envelope when the call fails. |
| success | Yes | Whether the developer-service request succeeded. |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already mark it as destructive (destructiveHint=true). The description adds the specific behavior 'Consumes Wubble requests or credits,' which aligns with and clarifies the destructive hint, but does not elaborate on other potential 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.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description consists of two short, clear sentences with no unnecessary words. It effectively communicates the purpose and a key behavioral detail.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's simplicity, an output schema exists, and annotations are present, the description covers the core function and cost. However, among many sibling tools, it lacks explicit differentiation guidance.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3. The description adds no additional meaning beyond what is already in the schema for each parameter.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states 'Generate Wubble speech', specifying the action (generate) and resource (Wubble speech). This distinguishes it from sibling tools like wubble_generate_song or wubble_generate_sound_effect.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage for text-to-speech synthesis and mentions credit consumption, but does not provide explicit guidance on when to use this tool versus alternatives like wubble_create_podcast or wubble_generate_song.
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 audioBDestructiveInspect
Upload Wubble audio. Consumes Wubble requests or credits.
| Name | Required | Description | Default |
|---|---|---|---|
| purpose | No | Optional upload purpose. | |
| filename | No | Optional filename for the uploaded audio. | |
| source_url | Yes | HTTPS URL for MCP to fetch and upload to Wubble. | |
| content_type | No | Optional media content type. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | No | |
| error | No | Developer-service error envelope when the call fails. |
| success | Yes | Whether the developer-service request succeeded. |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare destructiveHint=true and openWorldHint=true. The description adds that it consumes credits, which is a useful behavioral trait. However, it does not fully disclose what is destroyed or other 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.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two concise sentences with no wasted words. The first sentence states purpose, the second adds a cost implication. Could be slightly more structured but is efficient.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given that an output schema exists and annotations cover safety, the description is adequate but lacks information on prerequisites, returned data, or how it fits with sibling tools, leaving some gaps for an agent.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so baseline is 3. The description adds no additional meaning beyond what the schema already provides for each parameter.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states 'Upload Wubble audio', which is a specific verb and resource. However, it does not differentiate from the sibling tool 'wubble_upload_vocal', which likely also uploads audio, making the purpose less distinctive.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No explicit guidance on when to use this tool versus alternatives like wubble_upload_vocal. The mention of consuming credits provides some context but does not aid in selection among similar tools.
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 vocalBDestructiveInspect
Upload Wubble vocal. Consumes Wubble requests or credits.
| Name | Required | Description | Default |
|---|---|---|---|
| filename | No | Optional filename for the uploaded vocal. | |
| source_url | Yes | HTTPS URL for MCP to fetch and upload as a vocal reference. | |
| content_type | No | Optional media content type. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | No | |
| error | No | Developer-service error envelope when the call fails. |
| success | Yes | Whether the developer-service request succeeded. |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already indicate destructive behavior (destructiveHint: true) and non-read-only (readOnlyHint: false). The description adds that it consumes requests or credits, which is useful but still lacks details on what is destroyed or modified. 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.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is concise with two front-loaded sentences. It efficiently conveys the action and cost implication, though it could benefit from slightly more context without becoming verbose.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity of an upload tool (fetching from a URL), the description is too minimal. It omits important context like prerequisites (source URL must be accessible), file size limits, or what the output is (though output schema exists). The description could be more complete for an AI agent.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema covers all 3 parameters with descriptions, so schema coverage is 100%. The description adds no additional parameter meaning beyond the schema, meeting the baseline for this dimension.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description specifies the action 'Upload' and the resource 'Wubble vocal', giving a clear purpose. However, it does not differentiate from sibling tool 'wubble_upload_audio', which likely has a similar function. The term 'vocal' is ambiguous without further context.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives like 'wubble_upload_audio' or other upload tools. It does not mention prerequisites, limitations, or when not to use it.
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 requestCRead-onlyInspect
Wait for Wubble request. Reads information from the connected Wubble account.
| Name | Required | Description | Default |
|---|---|---|---|
| requestId | Yes | Wubble request ID to wait for. | |
| timeout_seconds | No | Maximum seconds to wait in this tool call. Max 45. | |
| poll_interval_seconds | No | Seconds between status checks. Max 10. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | No | |
| error | No | Developer-service error envelope when the call fails. |
| success | Yes | Whether the developer-service request succeeded. |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true, and the description merely confirms it reads info. It fails to disclose important behavioral details such as blocking nature, polling behavior, or what happens on timeout. 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.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is short (2 sentences) but the first sentence repeats the tool title. It is adequately concise but not optimally structured.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool has an output schema and three parameters, the description lacks essential context about the waiting process, what triggers completion, and how it differs from get_request_status. It feels incomplete for a blocking operation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
With 100% schema coverage, the schema already describes all parameters. The description adds no extra meaning or usage context for parameters like requestId or timeout_seconds.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool waits for a Wubble request and reads information, which aligns with the name. However, it does not distinguish the tool from similar siblings like wubble_get_request_status, which may also check request status.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. It does not mention prerequisites, recommended scenarios, or when to avoid using it.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Claim this connector by publishing a /.well-known/glama.json file on your server's domain with the following structure:
{
"$schema": "https://glama.ai/mcp/schemas/connector.json",
"maintainers": [{ "email": "your-email@example.com" }]
}The email address must match the email associated with your Glama account. Once published, Glama will automatically detect and verify the file within a few minutes.
Control your server's listing on Glama, including description and metadata
Access analytics and receive server usage reports
Get monitoring and health status updates for your server
Feature your server to boost visibility and reach more users
For users:
Full audit trail – every tool call is logged with inputs and outputs for compliance and debugging
Granular tool control – enable or disable individual tools per connector to limit what your AI agents can do
Centralized credential management – store and rotate API keys and OAuth tokens in one place
Change alerts – get notified when a connector changes its schema, adds or removes tools, or updates tool definitions, so nothing breaks silently
For server owners:
Proven adoption – public usage metrics on your listing show real-world traction and build trust with prospective users
Tool-level analytics – see which tools are being used most, helping you prioritize development and documentation
Direct user feedback – users can report issues and suggest improvements through the listing, giving you a channel you would not have otherwise
The connector status is unhealthy when Glama is unable to successfully connect to the server. This can happen for several reasons:
The server is experiencing an outage
The URL of the server is wrong
Credentials required to access the server are missing or invalid
If you are the owner of this MCP connector and would like to make modifications to the listing, including providing test credentials for accessing the server, please contact support@glama.ai.
Discussions
No comments yet. Be the first to start the discussion!
Related MCP Servers
Alicense-qualityDmaintenanceEnables agents to create AI music videos and audio-reactive visuals from songs through MCP, including style discovery, music search, rendering, webhook registration, and media management.1MIT- Alicense-qualityDmaintenanceA comprehensive audio MCP server that enables AI agents to generate speech, transcribe audio, clone voices, analyze speech quality, design soundscapes, and manage audio assets through a standardized interface.2MIT
- Flicense-qualityBmaintenanceMCP server that exposes BytePlus Seed Audio 1.0 tools for generating natural speech and audio, checking task status, and listing voices/models.1

leanvox-mcpofficial
Alicense-qualityDmaintenanceEnables text-to-speech generation, voice cloning, dialogue creation, and other TTS operations through natural language in MCP-compatible AI assistants.16MIT