MiOffice — AI-Powered Workspace Studio
Server Details
125+ browser tools for PDF, Image, Video, Audio, AI, Scanner. Files never leave your device.
- 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.5/5 across 133 of 133 tools scored. Lowest: 2.1/5.
Most tools have distinct purposes, with clear naming for format conversions (e.g., specific source/target pairs). However, a few overlapping tools exist (e.g., 'mio_ai_remove_background' vs 'mio_ai_remove_background_pro', 'mio_ai_upscale_pro' vs 'mio_image_upscale'), and the high volume (133) increases the chance of agent misselection.
Tools consistently use 'mio_' or 'mioffice_' prefixes with category-based naming (e.g., 'mio_ai_*', 'mio_image_*', 'mio_pdf_*'). However, there are minor inconsistencies: 'mioffice_' vs 'mio_', redundant naming like 'mio_notes_notes', and archive tools under 'mio_pdf_*' prefix.
133 tools is excessively high for a single MCP server, making it difficult for agents to navigate and select appropriate tools. The server attempts to cover too many domains (AI, image, video, audio, PDF, scanning, etc.) that could be better served by multiple smaller, focused servers.
The tool set covers a wide range of media and document manipulation tasks, including AI generation, editing, conversion, scanning, and PDF operations. Minor gaps exist (e.g., no full document editor beyond notes, some redundant tools), but the overall surface is comprehensive for an AI-powered workspace studio.
Available Tools
133 toolsmio_ai_audio_enhancerAInspect
AI Audio Enhancer — Enhance audio — speech denoising or music mastering, depending on input. AI Studio run — dispatches to our AI workers (Modal). Credits per run vary by model and file size. Day Pass and welcome credits do not include AI Studio. Files are deleted after processing; auditable at mioffice.ai/account/tasks (retention details at mioffice.ai/privacy). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description covers key behavioral aspects: dispatch to AI workers, credit consumption, file deletion after processing, audit trail, and workspace unlocking. This provides good transparency beyond the basic operation.
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 efficiently front-loaded with the core purpose, followed by essential operational details. It is concise but includes relevant billing and data retention information, earning its sentences.
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 covers purpose, process, and billing, but lacks details about output format or return type. Given no output schema, some indication of what the tool returns (e.g., enhanced audio file) 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?
The input schema has zero parameters, so schema coverage is 100%. Per guidelines, baseline is 3. The description adds no parameter information, which is acceptable given no parameters exist.
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: 'Enhance audio — speech denoising or music mastering, depending on input.' This distinguishes it from basic audio tools like denoise or equalizer, though it does not explicitly name alternative tools for comparison.
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 AI-powered audio enhancement but lacks explicit guidance on when to use this tool versus simpler siblings like mio_audio_denoise. It mentions credit-based workspaces but does not provide decision criteria.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_ai_cartoon_filterAInspect
AI Cartoon Filter — Transform photos into anime/cartoon style art using AI. AI Studio run — dispatches to our AI workers (Modal). Credits per run vary by model and file size. Day Pass and welcome credits do not include AI Studio. Files are deleted after processing; auditable at mioffice.ai/account/tasks (retention details at mioffice.ai/privacy). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description discloses key behavioral traits: use of AI workers (Modal), variable credits, file deletion after processing, audit trail availability, and pricing model. Since no annotations are present, this detail is valuable. However, it could be more explicit about the processing flow and any constraints (e.g., file size 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 well-structured with a clear purpose statement upfront, followed by relevant details. It is slightly longer than necessary but each sentence adds value, especially regarding credits and file privacy. No redundancy.
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 no output schema, the description should explain what the user receives after processing. It mentions files are deleted but not the return format (e.g., URL, download). It also lacks information on error handling or timeouts. The description is incomplete for a tool with no input/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?
The input schema has zero properties, meaning no parameters are defined. The baseline for 0 parameters is 4, but the description fails to clarify how the photo is provided (e.g., via file upload or URL). It says 'Transform photos' but does not specify the input mechanism, reducing clarity.
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: 'Transform photos into anime/cartoon style art using AI.' The verb 'transform' and resource 'photos' are specific, and the result is well-defined. It distinguishes from siblings like 'mio_ai_image_generator' by focusing on cartoon filter.
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 lacks explicit guidance on when to use this tool versus alternatives. It discusses credits and pricing but does not compare to other image tools or specify prerequisites. The sibling list includes many image-related tools, but no guidance is provided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_ai_clip_makerAInspect
AI Clip Maker — Extract the best short clips from long videos using AI. AI Studio run — dispatches to our AI workers (Modal). Credits per run vary by model and file size. Day Pass and welcome credits do not include AI Studio. Files are deleted after processing; auditable at mioffice.ai/account/tasks (retention details at mioffice.ai/privacy). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description fully carries the behavioral burden. It discloses: execution model (dispatched to Modal workers), credit costs (vary by model/file size), credit restrictions (Day Pass/welcome credits excluded), file deletion after processing, auditability (mioffice.ai/account/tasks), and workspace unlocking. This is comprehensive for an AI tool.
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 somewhat lengthy but well-structured with a clear first sentence stating the purpose, followed by important operational details. While every sentence adds value, it could be slightly more concise, but it effectively communicates the essential information.
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 incomplete because it does not explain how the user specifies the input video. With zero parameters, the agent has no way to know which video to process. The description should clarify that the tool acts on a selected video within the workspace or via some implicit context. This is a significant gap for usability.
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 zero parameters, so the description does not need to explain parameters. The description adds contextual meaning about the tool's operation and cost structure, which is valuable beyond the empty schema. The baseline for 0 parameters is 4, and the description meets that.
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: 'Extract the best short clips from long videos using AI.' The verb 'extract' and resource 'short clips from long videos' are specific. Among siblings like manual video trimming tools, this tool is distinguished by its AI-driven approach, making its purpose distinct.
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 explicitly state when to use this tool vs alternatives. It mentions it's an AI Studio run, implying it's for AI-powered clip extraction, but no direct comparison to manual trimming tools (e.g., mio_video_trim). The guidance is implied but not explicit, suggesting a minimal viable score.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_ai_document_summarizerAInspect
AI Document Summarizer — Summarize long documents into key points using AI. AI Studio run — dispatches to our AI workers (Modal). Credits per run vary by model and file size. Day Pass and welcome credits do not include AI Studio. Files are deleted after processing; auditable at mioffice.ai/account/tasks (retention details at mioffice.ai/privacy). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description discloses key behavioral traits: it dispatches to AI workers (Modal), credits vary by model/file size, Day Pass/welcome credits exclude AI Studio, files are deleted after processing, and retention details are linked. Since no annotations are provided, the description carries the full burden and covers safety and privacy aspects well.
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 moderately concise, front-loading the purpose, then transitioning to billing and privacy. It is not overly verbose, but includes some marketing language ('AI Document Summarizer —') that could be trimmed. Overall, it's 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?
While the description covers purpose and behavioral aspects, it does not explain the output format (e.g., returns summarized text, downloadable file?). No output schema exists, so more explicit output details would have improved 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?
The tool has zero parameters, and schema coverage is vacuously 100%. The description adds no param-specific meaning, which is fine. Baseline for 0 parameters is 4, as no compensation is needed.
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: 'Summarize long documents into key points using AI.' It specifies the verb 'summarize' and the resource 'long documents', distinguishing it from sibling tools like mio_ai_document_translator and other utilities.
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 summarizing long documents but does not explicitly state when to use this tool versus alternatives like mio_ai_document_translator or pdf tools. No exclusions or when-not-to-use guidance is provided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_ai_document_translatorAInspect
AI Document Translator — Translate text between 16 languages using AI. AI Studio run — dispatches to our AI workers (Modal). Credits per run vary by model and file size. Day Pass and welcome credits do not include AI Studio. Files are deleted after processing; auditable at mioffice.ai/account/tasks (retention details at mioffice.ai/privacy). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden. It discloses that processing uses AI workers, credits vary, and files are deleted. However, it does not explain how to invoke the tool (no parameters) or what the output format is, leaving a gap.
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 a single dense paragraph covering purpose, credits, privacy, and workspace unlock. It is front-loaded but could be more structured with bullet points. Every sentence adds value, but length slightly reduces 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?
Given zero parameters and no output schema, the description should fully explain how to use the tool. It misses how the user provides text or documents for translation, making it incomplete for 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?
The input schema has no parameters and 100% schema coverage. The description adds no parameter information because none exist. Per guidelines, 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's purpose: 'Translate text between 16 languages using AI.' It uses a specific verb ('Translate') and resource ('text between 16 languages'). It distinguishes from sibling tools like mio_ai_video_translator by specifying 'document' in the title.
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 context about credit usage and privacy but does not explicitly state when to use this tool versus alternatives. No direct comparison or when-not-to-use guidance is given; usage is implied rather than explicit.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_ai_face_enhancerAInspect
AI Face Enhancer — Enhance and restore faces in photos using AI — sharpen details, fix blur, improve quality. AI Studio run — dispatches to our AI workers (Modal). Credits per run vary by model and file size. Day Pass and welcome credits do not include AI Studio. Files are deleted after processing; auditable at mioffice.ai/account/tasks (retention details at mioffice.ai/privacy). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description provides substantial behavioral context: AI workers, variable credits, file deletion, auditability, and pricing. Missing details about output format or modification behavior.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Description is a single paragraph covering multiple aspects; it is fairly concise but could be more front-loaded with core functionality.
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?
Covers purpose, credits, retention, and pricing, but misses output specification and how to specify model/file size given zero parameters. Incomplete for a tool with no 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?
Input schema has 0 parameters, yet description mentions 'model and file size' without corresponding schema entries, potentially confusing the agent. Baseline for no parameters is 4, but the mismatch reduces clarity.
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: 'Enhance and restore faces in photos using AI — sharpen details, fix blur, improve quality.' This distinguishes it from sibling tools like face swap, headshot generator, 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?
The description implies usage through context (AI Studio run, credits) but does not explicitly compare to alternatives or state when to use this tool over others.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_ai_face_swapAInspect
Face Swap — Swap faces between photos using AI. AI Studio run — dispatches to our AI workers (Modal). Credits per run vary by model and file size. Day Pass and welcome credits do not include AI Studio. Files are deleted after processing; auditable at mioffice.ai/account/tasks (retention details at mioffice.ai/privacy). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries full burden. It discloses that the tool dispatches to AI workers, uses credits, deletes files after processing, and offers auditability. This is valuable transparency, though it lacks details on processing time 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 well-structured, starting with the core purpose. Each sentence provides useful information about credits, file handling, and pricing. While slightly lengthy, it is not verbose and front-loads the main 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?
Given no output schema and zero parameters, the description covers the essential aspects: what the tool does, credit model, file deletion, and privacy links. It is functionally complete for an AI tool with these characteristics.
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 no parameters, so the baseline is 4. The description adds meaning by explaining the tool's operation and constraints beyond the empty schema.
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 ('Swap') and resource ('faces between photos using AI'), and the title 'Face Swap' reinforces this. It distinguishes from siblings like 'mio_ai_face_enhancer' by specifying the exact operation.
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 context about when to use (face swapping) and mentions credit constraints, but it does not explicitly state when not to use or offer alternatives. Usage is implied rather than prescriptive.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_ai_headshot_generatorAInspect
AI Headshot Generator — Generate professional headshots from any photo. AI Studio run — dispatches to our AI workers (Modal). Credits per run vary by model and file size. Day Pass and welcome credits do not include AI Studio. Files are deleted after processing; auditable at mioffice.ai/account/tasks (retention details at mioffice.ai/privacy). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description discloses that it dispatches to AI workers (Modal), that credits vary, that files are deleted after processing, and points to an audit trail and privacy policy. For a tool with no annotations, this provides good behavioral insight.
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 a single paragraph that efficiently covers key points: purpose, processing, credits, data policy. It is front-loaded with the purpose. Could be slightly more structured, but it is clear and 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?
The description covers many aspects but omits details about the output format (e.g., returned image or URL). With no output schema, the description should clarify what the user receives. This is a notable gap.
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 zero parameters, so schema coverage is 100%. Per guidelines, 0 parameters baseline is 4. The description adds context about the processing mechanism and credits but does not need to explain 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's purpose: 'Generate professional headshots from any photo.' This is a specific verb (generate) and resource (headshots), and it distinguishes itself from siblings like mio_ai_image_generator by focusing on headshots.
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 explains credit usage and workspace unlocking but does not explicitly compare this tool to alternatives or state when to use it versus other AI tools. The context is helpful but lacks direct usage guidance.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_ai_image_generatorAInspect
AI Image Generator — Generate images from text descriptions using AI. AI Studio run — dispatches to our AI workers (Modal). Credits per run vary by model and file size. Day Pass and welcome credits do not include AI Studio. Files are deleted after processing; auditable at mioffice.ai/account/tasks (retention details at mioffice.ai/privacy). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries full burden. It discloses that the tool dispatches to AI workers on Modal, mentions variable credits, file deletion after processing, and auditing, providing good transparency on behavior and limitations.
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 front-loaded with the main purpose but includes additional details like pricing and data handling that could be seen as extraneous. It is still relatively concise and well-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 zero parameters, no output schema, and no annotations, the description provides comprehensive context: purpose, execution method, credit usage, data retention, and links for more info. It is fully complete for this tool.
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 0 parameters, so no parameter descriptions are needed. The description adds context about the tool's operation, fulfilling the role despite no 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 'Generate images from text descriptions using AI' with a specific verb and resource. It distinguishes itself from sibling AI tools by focusing on image generation from text.
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 use case is obvious from the purpose, but there is no explicit guidance on when to use this tool versus alternatives such as other image-related AI tools. The context is clear but lacks exclusion criteria.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_ai_inpaint_proBInspect
AI Eraser Pro — Remove objects, watermarks, and unwanted elements with AI inpainting. AI Studio run — dispatches to our AI workers (Modal). Credits per run vary by model and file size. Day Pass and welcome credits do not include AI Studio. Files are deleted after processing; auditable at mioffice.ai/account/tasks (retention details at mioffice.ai/privacy). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description discloses behavioral traits beyond the missing annotations: dispatches to AI workers (Modal), credits per run, file deletion after processing, and audit trail availability. It does not contradict any annotations as none are provided.
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 moderately concise but includes extraneous details about pricing plans and workspaces that could be streamlined. It front-loads the core purpose, but some sentences could be trimmed.
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 absence of parameters and output schema, the description lacks essential information on how to provide input and what to expect as output. It does not adequately differentiate from similar sibling tools in the AI category.
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 zero parameters in the input schema, the description fails to explain how input is supplied (e.g., file upload or current document). This is a critical gap for a tool that presumably requires an image to process.
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 'Remove objects, watermarks, and unwanted elements with AI inpainting', specifying the verb and resource. It distinguishes itself from similar tools like 'mio_ai_remove_object' by mentioning 'AI inpainting', but does not explicitly differentiate from siblings.
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 'mio_ai_remove_object' or 'mio_ai_remove_background'. It discusses credits and workspaces but fails to set clear context for usage.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_ai_logo_generatorAInspect
AI Logo Generator — Generate professional logos from text descriptions. AI Studio run — dispatches to our AI workers (Modal). Credits per run vary by model and file size. Day Pass and welcome credits do not include AI Studio. Files are deleted after processing; auditable at mioffice.ai/account/tasks (retention details at mioffice.ai/privacy). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so description carries full burden. It fully discloses that processing is remote (Modal workers), credits vary, file deletion, and data auditability at a given URL.
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?
Multiple sentences but each serves a purpose: purpose, credits, retention, pricing. Efficiently structured with main purpose first.
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?
Covers purpose, cost model, data lifecycle, and audit trail. But lacks output format details (e.g., image file type) and confirmation of asynchronous nature.
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?
Zero parameters in schema, so baseline is 3 per high schema coverage. Description mentions 'text descriptions' but does not explain how to input them, missing opportunity to clarify use.
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 logos from text descriptions, with a specific title 'AI Logo Generator'. This distinguishes it from sibling tools like 'mio_ai_image_generator' which is more generic.
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?
Provides operational details (credits, workspace unlocking, file retention) but lacks explicit comparison to other AI tools for when to use this tool over alternatives like image generator.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_ai_melody_to_musicBInspect
AI Melody to Music — Upload a melody or hum a tune and AI creates a full music arrangement in your style. AI Studio run — dispatches to our AI workers (Modal). Credits per run vary by model and file size. Day Pass and welcome credits do not include AI Studio. Files are deleted after processing; auditable at mioffice.ai/account/tasks (retention details at mioffice.ai/privacy). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden. It discloses key behaviors: dispatches to AI workers (Modal), files deleted after processing, variable credits, and auditability. However, it does not mention whether the operation is async or synchronous, nor any rate limits or authentication requirements beyond credits.
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 relatively concise for the amount of information conveyed, but the inclusion of credit/workspace details could be streamlined. The structure is front-loaded with the core purpose, which is good.
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 no output schema, the description should compensate. It does not explain the output format, style selection, or how the user provides the melody (since schema has no file parameter). It also lacks details on model specifics or processing time, making it incomplete for a complex AI tool.
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 zero parameters, but the description implies an input (melody/hum) not captured in the schema. This misalignment creates confusion. While schema coverage is 100% (no params), the description adds no parameter meaning and contradicts the schema's implicit 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 tool converts a melody/hum into a full music arrangement, distinguishing it from similar sibling tools like 'mio_ai_music_generator' by the specific input type. However, the phrase 'in your style' is ambiguous and 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 useful contextual info about credits, file deletion, and auditing, but no explicit guidance on when to use this tool versus its siblings (e.g., music_generator or song_generator). The usage guidelines are informational but lack comparative recommendations.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_ai_music_generatorAInspect
AI Music Generator — Generate royalty-free instrumental background tracks from text descriptions. No vocals — perfect for video, podcast, and ad backgrounds. For songs with vocals + lyrics, see AI Song Generator.. AI Studio run — dispatches to our AI workers (Modal). Credits per run vary by model and file size. Day Pass and welcome credits do not include AI Studio. Files are deleted after processing; auditable at mioffice.ai/account/tasks (retention details at mioffice.ai/privacy). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description covers key behaviors: AI Studio run, credits, file deletion, audit link, pricing. Lacks details on rate limits but sufficiently transparent.
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?
Information-dense but well-structured with front-loaded purpose. Could be slightly tighter but earns its length.
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?
Covers many aspects: use case, exclusions, credits, file lifecycle. However, does not explain how results are delivered (async/dispatch) or output format, leaving gaps for a generative tool.
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?
Description says 'from text descriptions' implying a text parameter, but input schema has zero properties, creating a contradiction. Baseline 4 for zero params is reduced due to misleading implication.
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?
Clearly states the tool generates royalty-free instrumental background tracks from text descriptions, with explicit distinction from AI Song Generator which handles vocals.
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?
Provides explicit guidance: no vocals, use for video/podcast/ad backgrounds, and mentions AI Song Generator as alternative for vocals. Does not cover other related tools like melody_to_music but is adequate.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_ai_photo_colorizerAInspect
AI Photo Colorizer — Colorize black and white photos using AI. AI Studio run — dispatches to our AI workers (Modal). Credits per run vary by model and file size. Day Pass and welcome credits do not include AI Studio. Files are deleted after processing; auditable at mioffice.ai/account/tasks (retention details at mioffice.ai/privacy). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden. It discloses credit-per-run variability, file deletion post-processing, auditability, and workspace unlocking. However, it does not specify output format or typical processing time.
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 moderately concise at 5 sentences but includes pricing and privacy details that may be unnecessary for tool selection. Front-loaded with main purpose, but could be trimmed.
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 thorough explanation of credits and file handling, the description fails to specify how the agent should provide the photo to colorize (input schema is empty). This is a critical completeness gap for a tool that presumably requires input media.
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 has no parameters, so baseline 4 applies. The description does not need to add parameter meaning, but it does not explain how to provide the input photo, which is a gap.
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 colorizes black and white photos using AI, with a specific verb and resource. This distinguishes it from siblings like photo restorer which may have different goals.
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 conditions and file deletion but does not explicitly state when to use this tool over alternatives like photo_restorer. No direct guidance on when not to use.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_ai_photo_restorerBInspect
AI Photo Restorer — Restore old, damaged, or low-quality photos using AI. AI Studio run — dispatches to our AI workers (Modal). Credits per run vary by model and file size. Day Pass and welcome credits do not include AI Studio. Files are deleted after processing; auditable at mioffice.ai/account/tasks (retention details at mioffice.ai/privacy). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so description carries full burden. It discloses file deletion after processing, auditability, and credit costs. However, it does not specify input requirements (e.g., how to provide the photo), output format, or any potential destructive behavior. Missing critical 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?
The description is front-loaded with the purpose and includes essential credit and privacy info. It is somewhat lengthy but each sentence adds value. Could be slightly more concise without losing 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 no input parameters and no output schema, the description should explain the input mechanism and expected output (e.g., restored photo file, task ID). It covers data deletion and credits but omits how to invoke the tool and retrieve results, leaving significant gaps.
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 zero parameters (100% coverage), but the description does not explain how the tool receives its input (e.g., via file upload or context). The agent needs clarification on how to supply the photo, so the description fails to add necessary meaning.
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 name and description clearly specify the tool's action ('Restore') and resource ('old, damaged, or low-quality photos'). It distinguishes itself from sibling AI tools like photo colorizer or face enhancer.
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 context on credits, AI Studio restrictions, and pricing, but does not give explicit guidance on when to use this tool versus sibling tools like 'mio_ai_face_enhancer' or 'mio_ai_photo_colorizer'. Usage is implied for restoring old photos, but no exclusions or alternatives are mentioned.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_ai_remove_backgroundCInspect
Remove Background — Remove image background using AI. AI Studio run — dispatches to our AI workers (Modal). Credits per run vary by model and file size. Day Pass and welcome credits do not include AI Studio. Files are deleted after processing; auditable at mioffice.ai/account/tasks (retention details at mioffice.ai/privacy). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Discloses that files are deleted after processing and credits vary by model and file size. However, lacks details on processing time, output format, failure modes, or auth requirements. No annotations provided to supplement.
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?
Description is a single paragraph covering purpose, credits, and privacy. It is somewhat structured but contains redundant details (e.g., pricing references). Could be more concise and front-loaded with 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?
The tool lacks an input parameter for the image, which is essential. No output schema exists. The description does not compensate for these missing elements, leaving the agent uncertain how to invoke the tool 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 input schema is empty with 0 parameters. The description mentions AI processing and credits, but does not explain how to provide the image. Schema coverage is 100% vacuously, but the missing essential parameter is a critical gap.
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 title and description clearly state 'Remove Background' using AI, which is specific. However, the input schema has zero parameters, contradicting the need for an image input, so purpose is clear but implementation is flawed.
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?
Description mentions credit-based unlocking and pricing page references, but provides no guidance on when to use this tool vs the sibling 'mio_ai_remove_background_pro' or alternatives. No usage conditions or prerequisites are stated.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_ai_remove_background_proAInspect
AI Background Remover Pro — Remove backgrounds with AI — superior quality for complex edges, hair, and transparency. AI Studio run — dispatches to our AI workers (Modal). Credits per run vary by model and file size. Day Pass and welcome credits do not include AI Studio. Files are deleted after processing; auditable at mioffice.ai/account/tasks (retention details at mioffice.ai/privacy). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries full disclosure burden. It provides clear behavioral details: AI Studio run dispatch to Modal workers, variable credit cost, file deletion after processing, audit trail link, and credit pack usage. This is comprehensive, though it omits potential limitations like max file size.
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 front-loaded with purpose and then provides necessary background. While it is somewhat detailed, each sentence adds value for behavioral transparency. It is clear and well-structured, though could be slightly trimmed without loss.
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 incomplete regarding input and output. It does not explain how the tool receives an image (e.g., from workspace context) or what it returns (presumably a processed image). With no output schema, the description should cover these, but it does not.
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 no parameters (0, schema coverage 100%), so the description need not explain parameters. Baseline of 4 is appropriate as no additional parameter meaning is needed.
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: 'Remove backgrounds with AI — superior quality for complex edges, hair, and transparency.' It explicitly names the resource (background removal) and the action (remove), and implies a distinction from the non-Pro sibling via 'superior quality' and 'Pro' branding.
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 some usage context (credit system, AI Studio restrictions) but does not explicitly guide when to choose this tool over the sibling 'mio_ai_remove_background'. No when-to-use or when-not-to-use guidance is given relative to alternatives.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_ai_remove_objectBInspect
Remove Object — Remove watermarks, objects, or unwanted elements from images. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description should disclose behavioral traits. It only mentions browser execution and billing, but does not explain output behavior, destructive nature, or supported formats, leaving significant gaps.
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 moderately concise at 4 sentences. The first sentence clearly states the function, but the subsequent billing info is verbose and not essential for tool selection. The structure could be more streamlined.
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 no output schema and no annotations, the description lacks crucial context like how images are passed, what the output is, and typical use cases. Billing info is included but operational details are missing.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has zero parameters, so the description is not required to add param details. Per guidelines, 0 params yield a baseline of 4. The description adds no param info, which is acceptable.
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 title 'Remove Object' and description 'Remove watermarks, objects, or unwanted elements from images' clearly state the tool's purpose with a specific verb and resource. It distinguishes itself from siblings like 'mio_ai_remove_background' by specifying object removal.
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 billing details and environment info but lacks guidance on when to use this tool versus alternatives like 'mio_ai_inpaint_pro' or 'mio_ai_remove_background'. No explicit context for selection is given.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_ai_silence_removerAInspect
AI Silence Remover — Automatically remove silent gaps from videos and audio. AI Studio run — dispatches to our AI workers (Modal). Credits per run vary by model and file size. Day Pass and welcome credits do not include AI Studio. Files are deleted after processing; auditable at mioffice.ai/account/tasks (retention details at mioffice.ai/privacy). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Discloses key behaviors: dispatches to AI workers, credits vary, files deleted after processing, auditable tasks. No annotations exist, so description carries full burden. Well-covered.
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?
Four concise sentences, front-loaded with purpose, then supporting details. No wasted words; 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?
Covers purpose, process, credits, file handling, auditing, and pricing. Missing explicit mention of return value or task ID, but otherwise comprehensive for a no-parameter tool.
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 has 0 parameters; baseline is 4. Description adds meaning by explaining the tool's function and context beyond the empty schema.
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?
Clearly states the action ('remove silent gaps') and resource ('videos and audio'). Distinguishes from sibling AI tools by specifying the exact task of silence removal.
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?
Provides context on when to use: AI Studio run, credits required, file deletion, and auditing. Does not explicitly state when not to use or compare to alternatives like audio denoise.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_ai_song_generatorAInspect
AI Song Generator — Generate full songs with vocals + lyrics + instrumentation from text. Powered by MiOffice Song Engine.. AI Studio run — dispatches to our AI workers (Modal). Credits per run vary by model and file size. Day Pass and welcome credits do not include AI Studio. Files are deleted after processing; auditable at mioffice.ai/account/tasks (retention details at mioffice.ai/privacy). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries full burden. It details async dispatch to AI workers, credit-varying costs, file deletion after processing, and auditing options. However, it does not mention latency, error handling, 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 relatively long and covers multiple topics. While each sentence adds value, the structure could be tightened by front-loading the core purpose and moving credit/policy details to a secondary position. Currently, it feels dense.
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 no parameters and no output schema, the description fails to specify how input text is supplied and what the output (file ID, URL, etc.) looks like. It mentions file deletion but does not describe the return value or how to access the generated song.
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 zero parameters, so the description does not need to add parameter-level detail. However, it does not clarify how the agent provides the text prompt (e.g., via the main message) or what the output format is. This omission reduces clarity for invocation.
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: 'AI Song Generator — Generate full songs with vocals + lyrics + instrumentation from text.' This specific verb and resource distinction separates it from siblings like 'mio_ai_music_generator' and 'mio_ai_melody_to_music'.
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 background on credits and workspaces but lacks explicit guidance on when to use this tool versus alternatives like 'mio_ai_music_generator'. It does not state what input the agent should provide or when this tool is preferred.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_ai_talking_headAInspect
AI Talking Head — Animate a face photo with audio to create a talking video. AI Studio run — dispatches to our AI workers (Modal). Credits per run vary by model and file size. Day Pass and welcome credits do not include AI Studio. Files are deleted after processing; auditable at mioffice.ai/account/tasks (retention details at mioffice.ai/privacy). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Since no annotations are provided, the description carries full burden. It discloses key behavioral traits: dispatches to AI workers, credits vary, files deleted after processing, auditable via tasks, and credit pack details. This exceeds the minimum required.
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?
Moderately concise; the first sentence clearly states the purpose. Additional sentences add value (credits, retention, workspace) but could be slightly trimmed. Still well-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?
Lacks explicit description of the return value or output format. Users may wonder what they get back (video file, link, etc.). The tool has no output schema, so the description should compensate.
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 zero parameters, so per guidelines baseline is 4. The description adds no parameter info because there are none to document.
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 core function: 'Animate a face photo with audio to create a talking video.' This verb+resource pair is specific and distinguishes it from sibling tools like text-to-video or voice generators.
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?
Provides context on credit usage, workspace compatibility, and file deletion but does not explicitly compare to alternatives or state when not to use it. The information helps in decision-making.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_ai_text_to_videoAInspect
AI Text to Video — Generate video from text descriptions using AI. AI Studio run — dispatches to our AI workers (Modal). Credits per run vary by model and file size. Day Pass and welcome credits do not include AI Studio. Files are deleted after processing; auditable at mioffice.ai/account/tasks (retention details at mioffice.ai/privacy). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations, so description carries full burden. It discloses file deletion after processing, auditability, credit model, and execution target (Modal workers). Does not cover sync/async or output format, but sufficient for basic behavior.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Description is concise, front-loads the core purpose, and then expands with relevant details. No redundant sentences. Well-structured for readability.
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 covering behavioral and credit aspects, the tool's fundamental input mechanism is missing (no parameters and no instruction). This makes the description incomplete for a text-to-video tool, even with no output schema or annotations.
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 has zero parameters despite the tool requiring text input. Schema coverage is technically 100% but the description fails to explain how to provide the text. Baseline 3 would apply if parameters existed, but here the lack of parameters is a critical omission. The description adds no parameter semantics.
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 verb ('Generate video') and resource ('text descriptions') with AI. It distinguishes from siblings by specifying text-to-video generation among many AI tools. The purpose is unmistakable.
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?
Provides context on when to use (AI Studio run with credits) and limitations (Day Pass not included). Does not explicitly list alternatives but the sibling tools are distinct functions. Implicitly clear.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_ai_transcriberAInspect
AI Audio Transcriber — Convert speech to text with AI-powered transcription. AI Studio run — dispatches to our AI workers (Modal). Credits per run vary by model and file size. Day Pass and welcome credits do not include AI Studio. Files are deleted after processing; auditable at mioffice.ai/account/tasks (retention details at mioffice.ai/privacy). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description fully covers behavioral aspects: files deleted after processing, audit trail available, credit model details, and workspace unlocking policy. 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?
The description is informative but slightly long; however, it is well-structured with key details upfront and references for further information.
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 no output schema, the description covers all relevant aspects: purpose, credit usage, data retention, and pricing, making it complete for the tool.
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 no parameters, so the description cannot add parameter-specific meaning. With 100% schema coverage, 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 it is an AI audio transcriber for converting speech to text. It distinguishes itself from sibling tools like 'mio_ai_audio_enhancer' and 'mio_ai_video_subtitler' by specifying the core transcription function.
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?
Provides context about credit usage, day pass limitations, and file deletion, helping agents understand when to use the tool. However, it does not explicitly compare with alternatives for similar tasks like subtitle generation.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_ai_upscale_proAInspect
AI Image Upscaler Pro — Upscale images to 4x resolution with AI — sharper details, no artifacts. AI Studio run — dispatches to our AI workers (Modal). Credits per run vary by model and file size. Day Pass and welcome credits do not include AI Studio. Files are deleted after processing; auditable at mioffice.ai/account/tasks (retention details at mioffice.ai/privacy). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Given no annotations, the description fully covers behavioral traits: dispatches to AI workers (Modal), credits vary by model/file size, AI Studio not included in Day Pass/welcome credits, files deleted after processing, auditable at URL, and three credit workspaces unlock with one credit pack. It lacks mention of failure handling or file limits but is otherwise thorough.
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 a single paragraph of five sentences. While it front-loads the purpose, the additional details on billing, data retention, and auditing could be more structured or condensed. It is adequate but not maximally 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?
The tool has no output schema, and the description does not explain what the agent receives after upscaling (e.g., URL, file download, or storage location). This is a significant gap for an agent to use the tool effectively, despite covering cost and processing 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?
The input schema has no parameters, so schema coverage is trivially 100%. The description does not need to add parameter semantics. Baseline for zero parameters is 4, and the description meets that.
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: 'Upscale images to 4x resolution with AI — sharper details, no artifacts.' It specifies the verb ('upscale'), resource ('images'), and outcome ('4x resolution'). This distinguishes it from similar tools like 'mio_image_upscale' (basic upscaling) and other AI image tools, providing clear differentiation.
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 context on credit usage, ID restrictions, file deletion, auditability, and pricing plans. However, it does not explicitly state when to use this tool versus alternatives like 'mio_image_upscale' or when not to use it. Usage is implied but not directly guided compared to sibling tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_ai_video_background_removerAInspect
AI Video Background Remover — Remove or replace video backgrounds using AI. AI Studio run — dispatches to our AI workers (Modal). Credits per run vary by model and file size. Day Pass and welcome credits do not include AI Studio. Files are deleted after processing; auditable at mioffice.ai/account/tasks (retention details at mioffice.ai/privacy). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the burden and discloses key behaviors: dispatches to AI workers, credit consumption varies, files deleted after processing, and audit trail available. However, it does not clarify if the tool modifies the original video or creates a new output, which is a minor gap.
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 a single paragraph that efficiently covers purpose, technical execution, credits, data handling, and workspace details. Every sentence adds value, though it could be slightly more terse by merging related points.
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 no parameters and no output schema, the description fails to explain how the video input is provided or selected. This is a critical gap for a tool that requires a video to process, leaving the agent uncertain about 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?
The input schema has zero parameters, so the description need not add parameter info. Baseline 4 applies per rules for 0 parameters. The description does not introduce any parameter-related confusion.
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: 'Remove or replace video backgrounds using AI.' It differentiates from image background removers (siblings like mio_ai_remove_background) by specifying video, and mentions 'replace' as an added capability.
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 omits comparisons with sibling tools (e.g., image background removers or other video AI tools) and does not specify expected inputs or prerequisites.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_ai_video_enhancerAInspect
AI Video Enhancer — Upscale and enhance video quality using AI. AI Studio run — dispatches to our AI workers (Modal). Credits per run vary by model and file size. Day Pass and welcome credits do not include AI Studio. Files are deleted after processing; auditable at mioffice.ai/account/tasks (retention details at mioffice.ai/privacy). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description discloses key behavioral traits: it dispatches to AI workers at Modal, credits vary by model/file size, files are deleted after processing, and audits are available. This adds significant context beyond what structured fields 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?
The description is a single paragraph that efficiently conveys purpose, behavior, and links. It is concise without being overly terse, though it could be slightly more structured with line breaks.
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 no parameters or output schema, the description covers all important aspects: what it does, how it works (AI workers), costs, data handling, and references for more info. It is complete for an agent to understand and invoke the tool 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 input schema has zero parameters, so schema coverage is 100%. The description does not add parameter info because there are none. Per guidelines, 0 parameters gives baseline 4.
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: 'Upscale and enhance video quality using AI.' It specifies the verb 'upscale and enhance' and resource 'video quality', distinguishing it from siblings like video compress or crop.
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 context on when to use the tool, mentioning credits, AI workers, and plans. It notes that Day Pass and welcome credits do not include AI Studio, and refers to pricing page. However, it does not explicitly exclude alternatives or give when-not-to-use scenarios.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_ai_video_subtitlerAInspect
AI Video Subtitler — Auto-generate subtitles for any video using AI. AI Studio run — dispatches to our AI workers (Modal). Credits per run vary by model and file size. Day Pass and welcome credits do not include AI Studio. Files are deleted after processing; auditable at mioffice.ai/account/tasks (retention details at mioffice.ai/privacy). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description effectively discloses key behavioral traits: it runs on AI workers (Modal), consumes varying credits, excludes Day Pass/welcome credits, deletes files after processing, provides auditing, and clarifies credit pack usage. This goes beyond the minimal duty.
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 well-structured, starting with the core purpose, then explaining the AI run, credits, file handling, and pricing. Each sentence adds value, though some pricing details could be streamlined; overall it's appropriately sized for the 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 no output schema and empty input schema, the description covers the essential aspects: purpose, AI processing, credits, file deletion, and auditing. However, it lacks details about the output format (e.g., SRT, VTT) and supported video formats, leaving some context gaps.
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 is empty (0 parameters), so the baseline is 4. The description adds meaning by explaining the tool's function and operational context, even though no parameters need description.
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 auto-generates subtitles for any video using AI, with a specific verb (auto-generate) and resource (subtitles). It distinguishes itself from siblings like 'mio_video_auto_captions' by emphasizing the AI Studio run, making its purpose clear.
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 lacks explicit guidance on when to use this tool vs. alternatives like 'mio_video_auto_captions' or 'mio_ai_transcriber'. It only provides credit and pricing context but no direct comparison or when-not-to-use advice.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_ai_video_translatorAInspect
AI Video Translator — Translate and dub videos into other languages using AI. AI Studio run — dispatches to our AI workers (Modal). Credits per run vary by model and file size. Day Pass and welcome credits do not include AI Studio. Files are deleted after processing; auditable at mioffice.ai/account/tasks (retention details at mioffice.ai/privacy). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description discloses that it is an AI Studio run (dispatched to Modal workers), credits vary by model/file size, files are deleted after processing, and task auditing is available. This adds value beyond no annotations, though the output format (e.g., dubbed video vs translation file) is not explicitly stated.
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 information-dense but well-structured: it starts with the core purpose, then follows with key details (credits, retention, workspace). Each sentence adds value, though it could be slightly more concise by grouping related details.
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 covers cost, data retention, and workspace requirements, but lacks explicit input specifications (e.g., supported video formats, target language selection) and output description (e.g., result is a downloadable file or task ID). Given no output schema, these gaps reduce 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?
There are 0 parameters and schema description coverage is 100% (no params to describe). Baseline score of 4 is appropriate as description cannot add parameter semantics.
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 starts with 'AI Video Translator — Translate and dub videos into other languages using AI', which clearly states the specific verb (translate/dub) and resource (videos). This distinguishes it from siblings like video_subtitler (subtitling) and text_to_video (generation).
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 context about AI Studio dispatch, credit costs, and workspace unlocking, but does not explicitly state when to use this tool vs alternatives like video_subtitler or video_background_remover. It lacks 'when not to use' guidance.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_ai_vocal_removerAInspect
AI Vocal Remover — Remove vocals from any song to create instrumentals or karaoke tracks. AI Studio run — dispatches to our AI workers (Modal). Credits per run vary by model and file size. Day Pass and welcome credits do not include AI Studio. Files are deleted after processing; auditable at mioffice.ai/account/tasks (retention details at mioffice.ai/privacy). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries full burden. It discloses that processing is dispatched to AI workers, credits vary by model and file size, files are deleted after processing, and retention details are available. This is comprehensive behavioral disclosure.
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 a single well-structured paragraph of 5 sentences. It front-loads the purpose, then provides necessary technical and credit details. 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?
For a tool with no parameters and no output schema, the description covers purpose, processing mechanism, credit cost, data retention, and workspace info. It is complete and adequate for an agent to understand and invoke the tool.
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, so schema coverage is 100%. The description adds meaning beyond the empty schema by explaining the tool's purpose and behavior. With 0 params, baseline is 4, and the description meets that.
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 removes vocals to create instrumentals or karaoke tracks. It uses a specific verb and resource, and distinguishes from numerous sibling tools like audio enhancer, music generator, 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?
Usage is implied by the purpose, but no explicit guidance on when to use this tool versus alternatives, or when not to use it. No exclusions or alternatives are mentioned.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_ai_voice_clonerAInspect
AI Voice Cloner — Clone any voice from a short audio sample — upload a 5-10 second recording and generate speech in that voice. AI Studio run — dispatches to our AI workers (Modal). Credits per run vary by model and file size. Day Pass and welcome credits do not include AI Studio. Files are deleted after processing; auditable at mioffice.ai/account/tasks (retention details at mioffice.ai/privacy). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden and discloses file deletion, auditability, and AI Studio dispatch, but does not describe error handling or return behavior.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is front-loaded with the main purpose but includes several sentences on credits and pricing that could be condensed or moved to annotations.
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 zero parameters, the description mentions uploading a recording but the schema has no file input property, creating an inconsistency that undermines 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?
The input schema has zero parameters, so schema coverage is trivially 100%; description adds value by explaining the expected audio input context.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool clones voices from short audio samples with a specific verb ('Clone') and resource ('any voice'), distinguishing it from siblings like voice_generator (generates synthetic voices) and vocal_remover.
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 context on credit usage and workspace restrictions but lacks explicit guidance on when to use this tool versus 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.
mio_ai_voice_generatorAInspect
AI Voice Generator — Convert text to natural-sounding speech using AI — 6 voices in English and Spanish, with engine tiers for cleaner studio-grade output.. AI Studio run — dispatches to our AI workers (Modal). Credits per run vary by model and file size. Day Pass and welcome credits do not include AI Studio. Files are deleted after processing; auditable at mioffice.ai/account/tasks (retention details at mioffice.ai/privacy). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so description fully covers behavioral traits: files deleted after processing, credit usage variation, Day Pass exclusion, and auditability. It also mentions dispatches to AI workers, adding 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?
Description is well-structured and front-loaded with purpose, then details. Slightly lengthy but each sentence adds value. Could be trimmed slightly without losing essential information.
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 no output schema, the description covers key aspects: voices, languages, engine tiers, credit usage, data retention, privacy link, and pricing reference. It is comprehensive for a text-to-speech tool.
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 has zero parameters, so schema coverage is 100% vacuously. Description adds no parameter semantics, but baseline is 4. The description does not explain how text input is provided, which is a minor gap.
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 converts text to natural-sounding speech using AI, specifying 6 voices in English and Spanish, and engine tiers. It distinguishes from siblings like voice cloner, audio enhancer, and transcriber.
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 implicitly indicates use for text-to-speech, but lacks explicit when to use vs alternatives or exclusions. It provides context about credits and privacy, but no direct comparison with sibling tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_audio_compressorCInspect
Audio Compressor — Control dynamic range with professional compression. Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Discloses that it runs in browser and uses more credits than Document/Image/Scanner workspaces. Notes credit limitations. However, missing key behaviors: how input is provided, whether it modifies original or creates new file, output format, potential side effects. Annotations are absent, so description carries burden but falls short.
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?
Description front-loads purpose but then adds several sentences about credit plans and pricing. While credit info is relevant, it makes the description longer than necessary. Could be more 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?
For a tool with no params and no output schema, description should explain input source, output format, and any constraints. It doesn't. Contextually incomplete: agent cannot determine how to invoke it or what to expect.
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 has 0 properties, so description should explain how input is specified. It doesn't, leaving ambiguity. Baseline for 0 params is 4, but lack of input mechanism reduces it to 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?
Description clearly states it's an audio compressor that controls dynamic range. The verb 'control' and resource 'dynamic range' are specific. However, it doesn't differentiate from sibling audio tools like equalizer or denoise, which also affect dynamics. But it is distinct from video compressors.
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 compressor versus other audio tools or video compressors. No prerequisites or context for optimal use. It only mentions credit consumption but not when to prefer it.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_audio_converterCInspect
Audio Converter — Convert between MP3, WAV, FLAC, OGG, and AAC. Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided. The description mentions credit consumption and pricing, which is marginally behavioral, but does not disclose processing behavior (e.g., where files come from, how output is delivered, error states).
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?
Description is overly long due to pricing/credits details that belong elsewhere. The essential functional info is brief, but extra sentences about credits, Day Pass, and pricing are irrelevant for tool selection.
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 no output schema, the description should explain the workflow (e.g., input file selection, output format specification). It fails to do so, leaving the agent without critical 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?
Input schema has zero parameters, so schema coverage is 100%. The description adds meaning by enumerating supported formats (MP3, WAV, FLAC, OGG, AAC), which compensates for the lack of parameters. However, it does not explain how input/output files are specified.
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 converts between MP3, WAV, FLAC, OGG, and AAC. However, it is mixed with pricing/credits info that dilutes the core purpose. A title would help, but the verb 'convert' and resource 'audio formats' are 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?
No guidance on when to use this vs siblings like mio_audio_compressor, mio_audio_denoise, or even format-specific converters like mio_video_to_mp3. No prerequisites or context provided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_audio_denoiseCInspect
Audio Denoise — Remove background noise from recordings. Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description must fully disclose behavior. It states the tool removes noise and uses more credits, but lacks details on mutation (e.g., what happens to the original file), permissions, or output format. The billing information is useful but does not cover behavioral traits.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is somewhat verbose, spending 50 words on credit and subscription details after the purpose statement. While it is structured, the length is not justified given the tool's simplicity, and the key functional description is brief.
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 no parameters and no output schema, the description should clarify how the tool receives input and what it returns. It fails to do so, leaving the agent unsure about the workflow or required 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?
The input schema has zero parameters, so the description does not need to add parameter info. It correctly omits parameter details, meeting the baseline of 4 for 0-param tools.
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 'Remove background noise from recordings,' which is a specific verb+resource. However, it does not differentiate from siblings like 'mio_ai_audio_enhancer' or 'mio_video_denoise,' so it misses the highest score.
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 only mentions credit consumption and workspace restrictions, which do not help an agent decide between similar tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_audio_equalizerAInspect
Audio Equalizer — Adjust bass, mid, and treble frequencies. Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the burden of behavioral disclosure. It mentions the tool runs in the browser and consumes credits, but does not explain what happens to the input audio (e.g., whether it's modified destructively, output format, or if it requires an audio file to be loaded). This leaves ambiguity about the tool's 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 is concise (4 sentences). The purpose is front-loaded. However, the last two sentences about pricing details (welcome credits, Day Pass, one-time credit pack) are somewhat tangential to tool selection and could be streamlined.
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 no parameters and no output schema, the description explains the tool's basic function and credit usage. However, it lacks information about the expected output (e.g., processed audio file) and how to provide input (e.g., via a file selector). This gap reduces completeness for a tool with no explicit input 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?
The input schema has 0 parameters and 100% schema description coverage, so the description does not need to explain parameters. According to guidelines, 0 parameters yields a baseline of 4. The description does not add parameter-related information, but the schema itself is sufficient.
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: 'Audio Equalizer — Adjust bass, mid, and treble frequencies.' The verb 'adjust' and resource 'frequencies' are specific. It distinguishes from sibling tools (e.g., mio_ai_audio_enhancer, mio_audio_compressor) by focusing on equalization.
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 context about when to use this tool by mentioning it runs in the browser and uses more credits than Document/Image/Scanner workspaces. It also clarifies credit limitations (welcome credits, Day Pass exclusion). However, it does not explicitly compare to other audio tools or state when to prefer this tool over alternatives like an enhancer or compressor.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_audio_fadeCInspect
Audio Fade — Add smooth fade-in and fade-out effects. Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description bears the full burden. It notes that processing occurs in the browser and consumes more credits, but omits critical behavioral traits like whether the effect is destructive, reversible, or the expected output format. This leaves the agent with significant unknowns.
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 verbose, with over half the content devoted to credit and pricing details unrelated to core functionality. A concise statement about fade effects would suffice; the extra text detracts from the primary 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 absence of output schema and annotations, the description should cover return values, side effects, or prerequisites. It only hints at credit usage, leaving out essential information such as audio file requirements, fade duration options, and expected output. The tool is critically incomplete for effective agent use.
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 zero parameters with 100% schema description coverage (vacuously). The description adds no parameter information since there are none, meeting the baseline of 3 as per guidelines.
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 opening sentence 'Add smooth fade-in and fade-out effects' clearly states the tool's action and resource. However, the subsequent lengthy discussion about credit usage and pricing dilutes the focus and does not directly distinguish it from sibling tools like mio_video_fade.
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 context about credit consumption and workspace accessibility, suggesting it's for users with appropriate credits. However, it does not explicitly state when to use this tool over alternatives (e.g., mio_video_fade) or specify prerequisites such as supported audio formats.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_audio_reverbAInspect
Audio Reverb — Add room reverb and echo effects. Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations exist, so the description must fully disclose behavior. It mentions browser processing and credit consumption but fails to detail input requirements (e.g., audio format, file size), output format, reversibility, or any side effects. The credit info is helpful but insufficient for comprehensive behavioral 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 front-loaded with the core purpose, but the following 4-5 sentences on credit and plan details are somewhat verbose. While relevant, they could be condensed. The structure is adequate but not optimal for quick agent scanning.
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 no parameters, no output schema, and no annotations, the description should be self-contained. It explains purpose and credit usage but omits input source (e.g., how to provide audio), file format/limits, processing duration, or what the tool returns. This leaves significant gaps for an agent to invoke 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 input schema has zero parameters with 100% coverage (no params to describe). The description adds no parameter detail, but the baseline is 4 since there are no parameters needing explanation. The context about credits is not parameter-related but acceptable.
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 begins with 'Audio Reverb — Add room reverb and echo effects.' This clearly states the tool's action (add) and resource (reverb and echo effects). It effectively distinguishes it from sibling audio tools like denoise or equalizer, making purpose unambiguous.
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 important usage context: it processes in the browser, uses more credits than Document/Image/Scanner workspaces, and notes that Day Pass does not include it. It also explains credit plans. However, it does not explicitly state when to use this tool over alternatives or mention exclusions, though the credit info guides appropriate use.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_audio_speedCInspect
Audio Speed — Change audio playback speed without pitch distortion. Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description mentions it 'processes in the browser' and uses credits, which are behavioral traits beyond the trivial 'speed change' feature. However, it does not disclose important behaviors such as file format support, output format, or whether it modifies the original file. Since no annotations are provided, the description should carry more weight but fails to do so adequately.
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 a single paragraph with multiple sentences. The first sentence is functional, but the remaining sentences about credits and pricing are tangential to the tool's core behavior. While the information may be useful, it adds verbosity and could be condensed or moved to annotations.
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 no input parameters and no output schema, the description should provide a complete picture of how to use it. It fails to explain what input is required (e.g., an audio file), how to specify speed, or what the output looks like. The credit information, while relevant, does not fill these gaps.
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 0 parameters, so the baseline is 4. However, the description does not explain how the tool receives its input (e.g., a file upload in the browser). This omission reduces the semantic value, as an agent might not understand how to invoke the tool without 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 primary action: 'Change audio playback speed without pitch distortion.' The verb is specific, and the resource is clear. However, it is not explicitly distinguished from the sibling tool 'mio_video_speed' which may also affect audio speed.
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 over alternatives like 'mio_audio_denoise' or 'mio_video_speed'. It does not mention prerequisites, limitations, or typical use cases, leaving the agent 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.
mioffice_list_toolsBInspect
List the full MiOffice applications with pricing tier per tool. Optionally filter by category.
| Name | Required | Description | Default |
|---|---|---|---|
| category | No | Category filter — use "all" for the complete catalog | all |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries full burden. It discloses that the tool lists applications with pricing tiers, but lacks details on output format, pagination, or authentication needs. The behavior is straightforward, but the description is minimal.
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. The core action and optional filter are front-loaded. Every sentence adds value, achieving maximum 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?
The tool is simple (1 optional param, no output schema). The description covers the main purpose but omits details about the output structure (e.g., format, fields). It is minimally adequate but not fully 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?
The input schema already describes the category parameter with enum and default 'all'. The description's 'Optionally filter by category' adds little beyond the schema. Since schema coverage is 100%, baseline is 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 verb 'List' and the resource 'the full MiOffice applications with pricing tier per tool'. It is specific and distinct from sibling tools like 'mioffice_open_tool' and 'mioffice_pricing_info', though it does not explicitly differentiate.
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 optional category filtering but provides no guidance on when to use this tool versus alternatives. There is no explicit when/when-not or contrast with sibling tools, leaving the agent to infer usage context.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mioffice_open_toolAInspect
Return the URL for a specific MiOffice application by name or search term. Includes pricing info so the user knows the cost before invoking.
| Name | Required | Description | Default |
|---|---|---|---|
| toolName | Yes | Tool name, MCP id (e.g. "mio_face_swap"), or search term (e.g. "voice clone") |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries full burden. It mentions pricing info and that it returns a URL, but lacks details on authorization, error handling, or rate limits. Adequate but could be more comprehensive for a no-annotation tool.
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 at two sentences, instantly communicating the core function and an important feature (pricing info). 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 tool's simplicity (one parameter, no output schema), the description covers the essential behavior. It is complete enough for an agent to understand how to use it, though it could mention return format or error cases for higher 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?
With 100% schema coverage, the schema already describes the parameter as 'Tool name, MCP id, or search term'. The description adds no additional meaning or constraints beyond this.
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 that the tool returns a URL for a MiOffice application by name or search term, including pricing info. It is specific and distinguishes from sibling tools which perform actions rather than just providing URLs.
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 obtaining a URL before invoking a tool, but it does not explicitly state when to use this tool versus alternatives (e.g., other MiOffice tools or search methods). No exclusions or conditional guidance provided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mioffice_pdf_editorBInspect
Open MiOffice PDF Editor — annotate, highlight, fill forms, sign, watermark. Light WASM, free on Day Pass.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are present, so the description carries the full burden. It mentions 'Light WASM, free on Day Pass,' which adds technical and pricing context, but it does not disclose whether authentication is required, what the default state (empty editor) is, or what the output/behavior is after opening.
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 sentences, efficient and front-loaded with the primary action. The second sentence adds technical detail, but the overall structure is clear and without waste.
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 0-parameter launcher, the description covers the core action and some technical context. However, it omits whether the editor opens with a blank document or requires user interaction, and it doesn't clarify the relationship to similar sibling tools like 'mioffice_open_tool' or 'mio_pdf_editor'.
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 0 parameters, and the schema coverage is 100% (no params). Per guidelines, baseline is 4. The description adds no parameter info, which is acceptable since none exist.
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 opens the MiOffice PDF Editor and lists its capabilities (annotate, highlight, fill forms, sign, watermark). It distinguishes from sibling PDF tools that perform specific actions (e.g., watermark, compress), but the similar sibling 'mio_pdf_editor' is not differentiated.
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 when-to-use or when-not-to-use guidance is provided. The description does not contrast this tool with alternatives like 'mio_pdf_editor' or 'mioffice_open_tool', leaving the agent to infer usage context.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mioffice_pricing_infoAInspect
Return MiOffice's current pricing model — welcome credits, Day Pass, and one-time credit packs. LLM should relay this to users before invoking any paid tool.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided; description correctly identifies a read-only operation returning pricing data. Could mention authentication or free access, but overall transparent.
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, no fluff. First sentence states purpose, second provides usage guidance. Efficient and front-loaded.
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?
No parameters or output schema; description fully covers purpose and usage context. Complete for a simple info-retrieval tool.
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 in schema (coverage 100%); description adds value by detailing what the tool returns, compensating for the empty schema.
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 it returns MiOffice's current pricing model, listing specific components (welcome credits, Day Pass, credit packs). Distinguishes from sibling tools which are processing 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?
Explicitly instructs LLM to relay pricing info before invoking any paid tool, providing clear context. Lacks explicit alternatives or when-not-to-use, but sufficient given no competing tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_image_avif_to_jpgCInspect
AVIF to JPG — Convert AVIF images to JPG format. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must carry the full burden. It states the tool 'Runs in the browser' and offers credit/workspace information, but fails to disclose behavioral traits such as what happens to the source file, any quality settings, or processing limits. The core conversion action is implied but lacks depth.
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 front-loaded with the conversion action, but the remainder discusses credits and pricing, which is not essential for tool invocation. It is somewhat verbose for a simple conversion tool, though still readable.
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 no output schema, the description should explain how input is supplied and what the output is. It only says 'Convert AVIF images to JPG format.' It omits context like file selection mechanism or output location. For a simple tool, this is a significant gap.
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 zero parameters, and schema coverage is 100%. Baseline for 0 params is 4, but the description does not explain how the agent provides the input file (e.g., 'select an AVIF file from the workspace'). This omission reduces the score to 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 converts AVIF images to JPG format using 'AVIF to JPG — Convert AVIF images to JPG format.' This is a specific verb+resource pair. However, it does not distinguish itself from sibling conversion tools (e.g., mio_image_heic_to_jpg, mio_image_webp_to_png) beyond the format names, so it loses one point.
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 mentions 'Runs in the browser' and pricing details, but no when/when-not criteria or alternative tool recommendations. The agent is left to infer usage from the format name alone.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_image_compressCInspect
Compress Image — Reduce image file size while maintaining quality. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Without annotations, the description must disclose behavioral traits. It mentions 'Runs in the browser' but does not explain if processing is client-side or server-side, nor does it describe potential side effects, success criteria, or error handling. Critical behavioral details like supported image formats or output quality are omitted.
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 front-loads the purpose but then diverges into detailed billing information that is not essential for tool usage. The pricing sentences are verbose and could be shortened or moved. Overall, it is not optimally 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?
Given no parameters, output schema, or annotations, the description should provide a complete understanding of how to use the tool. It fails to explain how an image is provided (e.g., file upload, workspace reference), what formats are supported, or what the expected outcome is. The description is incomplete for an agent to use effectively.
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 zero parameters, so there is nothing to describe. The description does not need to add parameter meaning. With 0 parameters, baseline is 4, and the description adds no confusion.
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 compresses images to reduce file size while maintaining quality. However, it does not differentiate from sibling 'mio_image_compress_webp', leaving ambiguity about the output format or compression algorithm.
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 focuses on billing and credit coverage but provides no guidance on when to use this tool versus alternatives like 'mio_image_compress_webp' or other image tools. There is no mention of prerequisites, limitations, or optimal scenarios.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_image_compress_webpCInspect
Compress WebP — Reduce WebP image file size. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It states 'Runs in the browser' (odd for MCP) but omits critical behavioral details: Does it replace the original file? Is it idempotent? What are the side effects? Billing info does not substitute for operational 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 first sentence is concise and front-loaded. However, the remaining three sentences focus on billing and pricing, which are secondary for an agent selecting a tool. This extra content reduces conciseness without adding operational 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 no parameters and no output schema, the description should explain how to invoke the tool (e.g., provide a file, use current context). It fails to do so, leaving the agent to guess. Billing details are irrelevant to completeness for 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?
The input schema has zero parameters, so baseline is 4. The description does not clarify how input is provided (e.g., via context or file upload), but the absence of parameters means no additional explanation is strictly needed. Billing details are irrelevant but not harmful.
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 first sentence clearly states the tool's purpose: 'Compress WebP — Reduce WebP image file size.' This provides a specific verb and resource. However, it does not distinguish this tool from sibling 'mio_image_compress', which may also handle WebP compression.
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 guidelines are provided on when to use this tool versus alternatives like 'mio_image_compress'. The description focuses on billing details (credits, day pass) rather than invocation context or prerequisites. An agent cannot determine when this tool is the appropriate choice.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_image_convertCInspect
Convert Image — Convert images between formats. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description must disclose behavioral traits. It only mentions that the tool 'runs in the browser,' but does not describe any operational behavior, such as file size limits, conversion process, or whether it alters the original file. This is insufficient for a zero-parameter tool.
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 front-loaded with the core purpose, but much of the text (about credits and day passes) is verbose and not directly relevant to tool invocation. It could be trimmed to a shorter form without losing essential information.
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 no parameters, no output schema, and no annotations, the description fails to explain how to use it (e.g., how to provide the image for conversion). It addresses only billing context, leaving a significant gap in 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?
The input schema has no properties, so schema description coverage is 100% trivially. The baseline is 3. However, the description does not explain how the tool receives the image to convert (e.g., via file upload or context), which would add meaningful context. It neither adds nor detracts significantly.
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 'Convert images between formats,' indicating the tool's purpose. This distinguishes it from sibling tools that target specific format pairs (e.g., mio_image_avif_to_jpg), but the lack of explicitly stated supported formats slightly reduces clarity.
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 general converter over sibling tools that handle specific format conversions. It focuses entirely on billing and credits, with no mention of context or alternatives.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_image_cropCInspect
Crop Image — Cut out a portion of your image. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description must disclose all behavioral traits. It mentions 'Runs in the browser' (client-side processing) but fails to describe destructive behavior, authentication needs, or output format. Billing info is provided but does not cover tool-specific behavioral aspects.
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 four sentences; the first is concise and front-loaded. However, the subsequent three sentences focus on billing, which is not essential for tool invocation. It could be more concise by moving pricing details elsewhere.
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 absence of input schema, output schema, and annotations, the description is incomplete. It does not state input source (e.g., file upload), output format, or any size limitations. The agent lacks essential context to use the tool 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 input schema has zero parameters, and the description does not explain how to specify the crop region (e.g., dimensions, coordinates). This omission leaves the agent without critical invocation details. While zero-parameter tools have a baseline of 4, the description fails to compensate for the lack of schema.
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 starts with 'Crop Image — Cut out a portion of your image,' which clearly indicates the action and resource. It distinguishes from sibling image tools (e.g., resize, rotate) but does not explicitly differentiate from them.
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 billing and execution context ('Runs in the browser') but offers no guidance on when to use cropping versus other image editing tools. It lacks alternative suggestions or usage scenarios.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_image_heic_to_jpgBInspect
HEIC to JPG — Convert iPhone HEIC photos to JPG format. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must carry the full burden of behavioral disclosure. It only states that the conversion runs in the browser, but fails to mention whether the original file is preserved, if there are any limits, or what happens to metadata. For a conversion tool, more transparency is expected.
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, starting with a clear statement of purpose. The additional sentences about pricing are somewhat extraneous but do not detract significantly. It is front-loaded with the core functionality.
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 no parameters, no output schema, and no annotations, the description covers the basic purpose and pricing context. However, it lacks details such as whether the conversion is reversible, whether the original file is altered, or any size/format constraints. These gaps reduce 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?
The input schema has zero parameters, and the description adds no parameter information because none exist. Schema description coverage is 100% (no undocumented parameters). As per guidelines, zero parameters result in a baseline of 4.
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 converts iPhone HEIC photos to JPG format, specifying both source and target. It also notes it runs in the browser. While the name already indicates the conversion, the description adds context that it is for iPhone photos. However, it does not differentiate from sibling tools like mio_image_heic_to_png, relying on the name for 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?
The description provides no guidance on when to use this tool versus alternatives. It only mentions pricing and that it runs in the browser, but does not specify conditions like file size limits or preferred scenarios. An agent would have no basis to choose this over similar conversion tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_image_heic_to_pngBInspect
HEIC to PNG — Convert iPhone HEIC photos to PNG format. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Without annotations, the description carries full burden for behavioral disclosure. It only states 'Runs in the browser' and mentions credit coverage. It does not disclose whether the conversion is destructive, authentication needs, rate limits, or what happens to inputs/outputs. This is minimal transparency for a conversion tool.
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 core purpose is front-loaded, but the description includes verbose pricing information that could be in a separate annotation or tool. While not excessively long, the pricing details are not essential for tool invocation, making it less concise than ideal.
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 no parameters and no output schema. The description does not explain how the user provides input (e.g., file upload) or what the output is. This leaves a significant gap for an agent to know how to invoke the tool correctly. Essential context missing.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has zero parameters, so schema coverage is trivially 100%. The description adds no parameter details because none exist. Baseline for zero parameters is 4, and since there is no need for compensation, score remains 4.
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 converts iPhone HEIC photos to PNG format, with a specific verb and resource. The name also includes 'heic_to_png', and the description explicitly mentions 'HEIC to PNG — Convert iPhone HEIC photos to PNG format.' This distinguishes it from siblings like mio_image_heic_to_jpg.
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 context on pricing and workspace usage, but does not explicitly state when to use this tool over alternatives (e.g., when to choose PNG vs JPG). It implies usage for HEIC to PNG conversion but lacks direct guidance on selection among siblings or prerequisites.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_image_jpeg_to_jpgAInspect
JPEG to JPG — Convert JPEG images to JPG format. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided. Description only mentions 'Runs in the browser' but does not disclose side effects, authentication needs, rate limits, or whether original image is altered.
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?
Description is relatively concise but includes billing details that, while useful, could be trimmed for brevity. Overall structure is clear.
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?
Covers purpose and billing but lacks detail on input mechanism, output format, and any constraints (e.g., file size limits). Adequate but with clear gaps.
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 in schema. Description does not explain how the input image is provided (e.g., file selection, URL), which is critical for a tool with no params.
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?
Clearly states converting JPEG images to JPG format. Specific verb and resource, easily distinguished from siblings like mio_image_heic_to_jpg.
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?
Provides context about billing (credits, day pass) and that it runs in browser, but does not explicitly state when to use versus alternatives or when not to use.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_image_jpg_to_webpAInspect
JPG to WebP — Convert JPG images to WebP for smaller file sizes. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must disclose behavioral traits. It mentions 'Runs in the browser' and credit coverage, but fails to explain important behaviors like input mechanism (how to provide the JPG), output format, file size reduction specifics, or error handling. This is insufficient for a conversion tool with zero annotation support.
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 four sentences, front-loaded with the action. The pricing and credit details are relevant but could be considered extra for a tool description. It is efficient without being overly 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 no parameters and no output schema, the description should cover input mechanism and output type. It explains purpose and credit usage but omits how the agent provides the JPG image (file, URL?) and what the output is (download, URL?). This is a gap for a conversion tool, making it 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?
The input schema has zero parameters, and schema coverage is 100% (empty). The description does not add parameter info because there are none. However, it implies an input image is needed, but does not explain how it is provided. With no parameters, a baseline score of 4 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 'Convert JPG images to WebP for smaller file sizes', which specifies the verb (Convert) and resource (JPG images to WebP). It distinguishes from sibling tools like mio_image_png_to_webp (different input) and mio_image_compress_webp (compression, not conversion).
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 clear context on where the tool runs (browser) and credit usage, but does not explicitly state when to use this tool versus alternatives like mio_image_compress_webp or other conversion tools. The purpose is clear enough for the agent to select it for JPG-to-WebP conversion.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_image_png_to_svgBInspect
PNG to SVG — Convert raster images to scalable vector graphics. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description mentions 'Runs in the browser' as a behavioral trait, but lacks other important details such as whether the tool preserves transparency, handles large files, or provides quality options. Without annotations, this is insufficient.
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 front-loaded with the core functionality, followed by pricing details. While the pricing section adds length, it is still concise for the information conveyed. Could be slightly tighter.
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 is simple, but the description omits expected output format, download/display behavior, file size limits, or any step-by-step instructions. With no output schema, more operational context is needed.
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 0 parameters, so schema coverage is 100%. Baseline is 3. The description does not add parameter-specific details beyond the tool's purpose, which is acceptable but not enhancing.
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 'PNG to SVG' and 'Convert raster images to scalable vector graphics', which is a specific verb+resource pair. It distinguishes from sibling tools that handle other formats or operations.
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 PNG to SVG conversion, but provides no explicit guidance on when to use this tool versus alternatives (e.g., other image conversion tools). No when-not-to-use or alternative suggestions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_image_png_to_webpAInspect
PNG to WebP — Convert PNG images to WebP for smaller file sizes. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description bears the full burden of behavioral disclosure. It mentions the tool runs in the browser and covers credit/pricing details, but does not disclose important behaviors such as whether it preserves transparency, handles large files, or any rate limits. This is insufficient for a tool with zero 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 relatively concise and front-loaded with the core conversion purpose. However, it includes unnecessary pricing and credit details that could be presented elsewhere, adding slight verbosity for a simple conversion tool.
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 no output schema and no parameters, but the description fails to explain how the input image is provided or how the output WebP is returned. Important context about the conversion workflow (e.g., file upload, download) is missing, making it incomplete for effective use.
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 zero parameters, so schema coverage is 100%. The description adds no parameter-specific information, but with no parameters to document, a baseline of 4 is appropriate as the description does not need to compensate.
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 purpose: converting PNG images to WebP format for smaller file sizes. It includes a concise verb-resource pair ('Convert PNG images to WebP') and distinguishes itself from sibling tools like general converters or other format-specific 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 does not provide explicit guidance on when to use this tool versus alternatives like 'mio_image_convert' or other PNG-to-* tools. It implies usage for compression but lacks comparative context or exclusion criteria.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_image_resizeCInspect
Resize Image — Change image dimensions to any size. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description notes that it runs in the browser, which is a useful behavioral detail. However, it does not disclose whether resizing preserves aspect ratio, supported formats, or if it is destructive. With no annotations, more disclosure would be expected.
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 starts with a clear statement but then devotes most of its length to credit and pricing details. It could be more concise and front-load functional information.
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 no output schema and many sibling tools, the description does not adequately explain output behavior or input requirements. It omits critical details like aspect ratio handling and supported formats.
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 zero parameters, which is unusual for a resize tool. The description does not clarify how to provide input dimensions or the image itself. It contradicts the expectation set by the tool name.
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 the tool resizes images to any size, which is clear. However, it does not differentiate from sibling tools like crop or compress that might also modify dimensions. The pricing information dilutes the core purpose.
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 vs other image tools or how to specify dimensions. The description focuses on credits and pricing rather than usage context.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_image_rotateBInspect
Rotate Image — Rotate and flip images. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Beyond 'runs in the browser', no behavioral traits are disclosed. With no annotations, the description should cover aspects like synchronicity, side effects, or input requirements. The credit/pricing info is about access, not operation behavior.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description includes several sentences about pricing and credits that are irrelevant to the tool's function. This distracts from the core purpose and makes it unnecessarily verbose for a simple rotation tool.
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 no parameters and no output schema, the description is incomplete. It does not explain how the image is provided (e.g., from workspace context) or what the result looks like. The pricing info adds no operational 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?
Input schema has zero parameters, so the baseline is 4. The description adds no parameter info, but none is needed since schema coverage is 100% and no parameters exist.
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 'Rotate Image — Rotate and flip images', which is a specific verb and resource. It immediately conveys the tool's purpose without 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?
No guidance on when to use this tool versus alternatives like mio_video_rotate or other image editing tools. The description only implies it's for images (due to 'image' in name) but does not explicitly state 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.
mio_image_upscaleAInspect
Upscale Image — Enlarge images using AI while preserving quality. AI Studio run — dispatches to our AI workers (Modal). Credits per run vary by model and file size. Day Pass and welcome credits do not include AI Studio. Files are deleted after processing; auditable at mioffice.ai/account/tasks (retention details at mioffice.ai/privacy). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden. It discloses key traits: dispatching to AI workers (Modal), variable credits, file deletion after processing, and auditability. However, it omits important behavioral details like whether the tool is read-only or mutates state, how results are returned, and if any user authentication is required beyond credit availability.
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 a single paragraph combining purpose, credit details, and privacy. It front-loads the purpose but then dives into verbose credit and workplace details. It could be restructured into clearer sections (e.g., Purpose, Credits, Privacy). Every sentence provides value, but the structure could be improved.
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 no output schema, the description does not explain how to provide the input image or what the output format is. It also does not specify the return behavior (e.g., download link, file path). This is a significant completeness gap for a tool that requires user input.
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 zero parameters (100% coverage by default), but the description fails to explain how the tool receives the image to upscale. It does not mention any implied input via context or previous tool output. This is a critical gap for an agent to correctly invoke the tool.
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 'Upscale Image — Enlarge images using AI while preserving quality.' This specific verb ('upscale') and resource ('image') distinguish it from siblings like 'mio_image_resize' or 'mio_ai_upscale_pro', and the AI-based quality preservation differentiates it from simple scaling 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 includes explicit notes on AI Studio run, credits varying by model/file size, and credit eligibility (Day Pass not included). It also explains workspace unlocking. However, it does not explicitly state when not to use this tool (e.g., for lossless upscale or when credits are unavailable) or compare with alternatives like 'mio_ai_upscale_pro'.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_image_webp_to_jpgAInspect
WebP to JPG — Convert WebP images to JPG format. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description adds that it 'runs in the browser' and mentions the credit model, which provides some behavioral context beyond the tool name. However, it lacks details like file size limits, synchronous behavior, or return format.
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 relatively concise and front-loaded with the purpose. The credit information adds some length but is relevant for usage context. Could be slightly tighter.
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 (no parameters, no output schema), the description covers the basic function and execution context. However, it omits details about the output format or any limitations, leaving some gaps.
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 zero parameters, so the baseline is 4. The description does not provide parameter semantics, but none are needed. It adds no extra parameter info, but this is acceptable.
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 explicitly states 'Convert WebP images to JPG format', matching the tool's name and clearly distinguishing it from sibling format converters like jpg_to_webp or webp_to_png.
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, or any prerequisites. The credit information implies cost considerations but does not help an agent decide which conversion tool to invoke.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_image_webp_to_pngAInspect
WebP to PNG — Convert WebP images to PNG format. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description mentions 'Runs in the browser,' indicating a client-side operation, which adds some behavioral context. However, with no annotations provided, the description bears full burden; it does not disclose details like file size limits, processing time, or output format specifics (e.g., whether the PNG is downloaded or returned).
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 brief and front-loaded with the core purpose. It uses four sentences, the first two explaining the function and environment, and the last two on billing. While billing context may be useful, it slightly dilutes the functional core; however, it remains 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?
For a simple conversion tool with no parameters and no output schema, the description covers the purpose, runtime environment, and billing. It omits details about output handling (e.g., download link), but the tool is straightforward and the description is largely complete given the simplicity.
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 zero parameters, and schema description coverage is 100% (trivially). Per guidelines, baseline for 0 parameters is 4. The description does not need to add parameter information, and it appropriately focuses on the operation and billing.
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 converts WebP images to PNG format ('Convert WebP images to PNG format'), which is a specific verb+resource. However, it does not differentiate from sibling tools like mio_image_webp_to_jpg, as it only mentions the format without contrasting with alternative output formats.
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 use for converting WebP to PNG but provides no guidance on when to use this tool versus alternatives (e.g., when to choose PNG over JPG). There are no exclusions or context for selection among the many conversion tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_jpg_to_pdfAInspect
JPG to PDF — Convert JPG images into a PDF document. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must carry the full burden. It states 'Runs in the browser' but does not disclose other important behaviors such as whether the conversion is client-side only, if any data is uploaded, authentication requirements, or rate limits. The pricing info is tangential behavior.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description consists of 5 sentences, but only the first sentence describes the tool's core functionality. The remaining sentences focus on pricing and credits, which are less immediately relevant for tool invocation.
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 no output schema, the description provides the essential purpose and a note about browser execution. However, it lacks details on whether multiple JPGs are accepted, output naming conventions, or process limitations. The inclusion of pricing adds context but not operational 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?
The input schema has zero parameters, so schema description coverage is 100%. According to the rubric, baseline 4 applies. The description adds no parameter meaning beyond the empty schema, but that is acceptable.
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 explicitly states 'JPG to PDF — Convert JPG images into a PDF document', which clearly identifies the verb (convert) and resource (JPG to PDF). It distinguishes from sibling tools like mio_png_to_pdf and mio_pdf_image_to_pdf by specifying the input 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?
The description does not provide explicit guidance on when to use this tool versus alternatives, such as other image-to-PDF converters. Usage is implied by the tool name, but no exclusions or comparisons are given.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_notes_notesCInspect
Notes — Private notes with real-time collaboration. No account, no cloud.. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations exist, so the description must fully disclose behaviors. It mentions it runs in browser and has no account/cloud, but does not describe what happens when invoked (e.g., opens a note editor?), whether it is read-only or mutable, or any side effects. This is insufficient for behavioral 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 overly verbose about pricing and licensing details that are not directly relevant to tool usage. It front-loads the tool name but then provides unnecessary information. Every sentence should add value for tool selection and invocation, but much of it is about credits and subscriptions.
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 no output schema, the description is minimally complete. It covers licensing but lacks operational context (e.g., what note is created? how collaboration works?). The agent lacks information to reliably invoke the tool beyond knowing it exists.
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 zero parameters, and schema description coverage is 100%. The description adds no parameter information, which is acceptable because there are none. The baseline for zero parameters is 4, and the description does not detract.
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 'Notes — Private notes with real-time collaboration', indicating the tool is for note-taking with collaboration. However, it doesn't specify the exact action (create, edit, view) or the resource type, 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?
No guidance is provided on when to use this tool versus alternatives. The sibling tools are mostly AI and media utilities, so the context suggests it's separate, but no explicit when-to-use or when-not-to-use instructions are given.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_p2p_file_transferBInspect
Transfer Files — Transfer files directly between devices. No cloud, no upload, fully encrypted.. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description should disclose behavioral traits. It mentions the transfer is direct, no cloud, encrypted, and runs in browser, but omits critical details like whether both devices must be online, file size limits, or how the transfer is initiated. The pricing info is access-related, not behavioral.
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 moderately concise but includes extraneous pricing and access details that could be moved to a separate tool or documentation. The core purpose is front-loaded, but the extra sentences dilute 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?
Given that the tool is for file transfer (moderately complex) with no parameters and no output schema, the description fails to explain the workflow, such as how to select files or recipients, or how the transfer is managed. This is incomplete for an AI agent to use effectively.
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 zero parameters, so baseline is 4. The description does not explain why there are no parameters or how the file and recipient are specified, but since the schema itself is empty, the description does not need to add parameter 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 states 'Transfer Files — Transfer files directly between devices. No cloud, no upload, fully encrypted.' This is a specific verb ('Transfer') and resource ('files'), clearly distinguishing it from sibling P2P tools like screen sharing or session handoff.
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 direct file transfers but does not explicitly state when to use it vs alternatives or when not to use it. No mention of prerequisites or when this tool is preferable over other P2P tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_p2p_session_handoffAInspect
Device Handoff — Continue your session on another device. Scan QR code to transfer your current page.. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must fully disclose behavior. It states 'Runs in the browser' and discusses pricing, but does not describe side effects, whether the original session ends, idempotency, or prerequisites. The agent lacks crucial behavioral context.
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 about five sentences, including extraneous pricing information ('covered by signup welcome credits...') that does not aid tool selection. It could be more concise by removing billing details, which are better suited for a pricing tool or annotations.
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 no input/output schema and no annotations, the description lacks completeness. It does not explain the outcome of calling the tool (e.g., does it generate a QR code? transfer the session automatically?), nor does it provide a step-by-step process. The agent cannot fully predict the tool's behavior.
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 in the input schema (100% schema coverage). Per guidelines, a baseline of 4 is appropriate since the description does not need to add parameter details.
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 'Device Handoff — Continue your session on another device. Scan QR code to transfer your current page.' It specifies the verb 'transfer' and the resource 'session/page', and it distinguishes itself from sibling tools like file transfer and screen share.
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 clear context: 'Continue your session on another device' and 'Scan QR code'. It implies when to use this tool but does not explicitly mention when not to use it or compare with alternatives like mio_p2p_file_transfer. It is clear but lacks exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_pdf_compressAInspect
Compress PDF — Reduce PDF file size by compressing images. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description adds that it 'Runs in the browser' and mentions credit coverage, providing behavioral context beyond the empty schema. However, it does not disclose whether the tool is destructive, creates a new file, or has limits (e.g., file size). With no annotations, more behavioral detail would be beneficial.
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 front-loads the purpose effectively. However, it includes several sentences about credit and pricing details that, while informative for billing context, are not strictly necessary for core functionality. Still, it remains relatively concise and well-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's simplicity (no parameters, no output schema, no annotations), the description is reasonably complete: it explains the action, method, runtime location, and credit coverage. It lacks details about output behavior or file size limits, but overall it covers essential aspects for a straightforward tool.
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 zero parameters, and schema description coverage is 100%. Per guidelines, baseline score is 4. The description adds no parameter-specific information, but since there are no parameters, no additional meaning is needed.
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 starts with 'Compress PDF — Reduce PDF file size by compressing images,' clearly stating the verb (compress), resource (PDF), and method (image compression). This sufficiently distinguishes it from sibling tools like merge, split, etc., by specifying the action and 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?
The description does not explicitly state when to use this tool versus alternatives. It implies typical compression use cases but lacks guidance on exclusions or comparisons to other compression-related tools (e.g., mio_image_compress). No 'when not to use' or alternative suggestions are provided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_pdf_editorCInspect
PDF Editor — Edit PDFs: add text, mask content, annotate, OCR. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description mentions it runs in the browser but omits behavioral traits like side effects, file handling, or processing limits. No annotations present to compensate.
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 includes excessive pricing information that is not core to tool usage. The core functionality is front-loaded but the additional details reduce 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?
No output schema defined; the description does not indicate what the tool returns. Pricing details are irrelevant to usage. The sibling mioffice_pdf_editor exists but is not differentiated.
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?
Though there are no parameters, the description should explain how the tool is invoked or what input is needed. It does not clarify that no input is required in the API sense.
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 it edits PDFs with specific actions (add text, mask content, annotate, OCR), distinguishing it from sibling PDF tools like merge or compress.
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 vs. other PDF tools or the sibling mioffice_pdf_editor. The description lacks selection criteria.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_pdf_epub_to_pdfAInspect
EPUB to PDF — Convert EPUB ebooks to PDF format. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations are absent, so the description must cover behavior. It mentions 'Runs in the browser' and credit usage, but does not disclose how input is provided (no parameters), file size limits, or output handling. The browser execution hint is useful but incomplete.
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 at ~60 words with clear front-loading of the core action. Each sentence adds value: conversion type, browser execution, credit coverage, and pricing reference. Minor redundancy in credit details could be trimmed.
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 zero-parameter tool with no output schema, the description explains the conversion action and credit model but lacks clarity on how the user provides the input EPUB file. This omission reduces completeness for an agent needing to invoke the tool 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 input schema is empty (0 parameters), so no parameter details are needed. Baseline is 4 per rubric. The description adds no parameter-specific information, which is acceptable given the absence of 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 explicitly states 'EPUB to PDF' and 'Convert EPUB ebooks to PDF format', providing a specific verb and resource. It distinguishes from sibling tools like mio_jpg_to_pdf and mio_pdf_from_word by clearly indicating the input 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?
The description implies usage for EPUB to PDF conversion but does not explicitly state when to use or avoid this tool relative to siblings. No alternative tools or exclusions are mentioned, relying on the tool name to differentiate.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_pdf_from_wordBInspect
Office to PDF — Convert Word, PowerPoint, and OpenOffice documents to PDF. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the burden of behavioral disclosure. It mentions 'runs in the browser' and billing, but does not explain how to provide input, what the output is, or any side effects. Moderate 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 a single paragraph, front-loaded with the core purpose. However, it includes unnecessary billing details (e.g., 'Covered by signup welcome credits...') that could be condensed. Still fairly 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?
Given no input schema parameters and no output schema, the description should explain the input mechanism and return value. It omits how to provide the source document, leaving the tool's complete context unclear.
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 zero parameters, but the description does not clarify how the document is supplied (e.g., via file upload or other context). The schema coverage is 100% trivial, but the description fails to compensate for the missing parameter semantics.
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 converts Word, PowerPoint, and OpenOffice documents to PDF, using specific verbs and resource names, effectively distinguishing it from sibling PDF conversion tools like mio_jpg_to_pdf or mio_pdf_to_doc.
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 lacks guidance on when to use this tool versus alternatives among the many PDF-related siblings. It only mentions billing, not contextual scenarios or prerequisites for use.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_pdf_image_to_pdfAInspect
Image to PDF — Convert any image to PDF document. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided; the description focuses on credit/pricing info but does not disclose behavioral traits such as whether the conversion is lossless, if input files are retained, or authentication requirements. The credit mention is useful but insufficient.
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 a clear first sentence. The additional credit/pricing details, while informative, are not essential for tool usage and add some fluff.
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 zero-parameter tool, the description covers purpose, runtime environment, and billing. However, it lacks accepted image formats and size limits, which would be helpful.
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 zero parameters, so baseline is 4. The description adds no parameter info, which is acceptable since no parameters exist.
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 'Convert any image to PDF document' with a specific verb and resource. It distinguishes itself from sibling tools like mio_pdf_png_to_pdf and mio_jpg_to_pdf by covering all image 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 explicit guidance on when to use this tool versus the format-specific converters. The context of 'any image' implies broader use, but alternatives are not mentioned.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_pdf_mergeBInspect
Merge PDF — Combine multiple PDF files into one document. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Key behavioral traits are missing: no mention of file size limits, number of files, data handling (e.g., upload vs local processing), or the output format. The description states it 'runs in the browser' and provides billing details, but these do not sufficiently inform the agent of operational constraints 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?
The description is front-loaded with the core purpose in the first sentence. The following sentences about billing and credit coverage, while not essential for an agent, are not overly verbose. Could be more concise if billing info were moved to a separate annotation, but still reasonably 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's simplicity (no parameters, no output schema), the description covers basic purpose and non-functional context (billing, browser execution). However, it omits important operational details like file format constraints, processing limits, or output characteristics, leaving completeness gaps for a production 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 has zero parameters, so schema_description_coverage is trivially 100%. The description adds value by stating the tool merges PDFs, but it does not clarify how files are specified (e.g., via workspace selection). Baseline score of 3 is appropriate as the schema fully covers parameters, and the description adds marginal context.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description begins with 'Merge PDF — Combine multiple PDF files into one document,' which is a clear, specific verb+resource statement. The title and summary directly indicate the tool's function, and it is easily distinguishable from sibling tools like split, compress, or rotate.
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 explicit guidance on when to use this tool over alternatives or when not to use it. It lacks comparisons to other PDF tools or edge cases. The billing info is tangential and does not help an agent decide the correct context for invocation.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_pdf_png_to_pdfAInspect
PNG to PDF — Convert PNG images to PDF documents. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description lacks behavioral details beyond stating 'Runs in the browser' and credit usage. No annotations are present, so the description carries full burden. It does not disclose how input is provided (e.g., file upload, URL), whether multiple PNGs are supported, or what the output format is (e.g., downloadable file, URL).
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 three sentences. The first sentence immediately states the purpose (PNG to PDF conversion). Subsequent sentences add relevant but separate context (credit usage). 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?
While the description explains purpose and credit model, it is incomplete regarding the actual use of the tool (how to provide input, how output is returned). There is no output schema, so the description should clarify the result format, but it does not.
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 in the input schema, and schema description coverage is 100% (trivially). According to the rubric, zero parameters result in a baseline of 4. The description adds no additional parameter information, which is acceptable since none exist.
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 converts PNG images to PDF documents, starting with 'PNG to PDF' and elaborating 'Convert PNG images to PDF documents.' This is specific to PNG input, distinguishing it from sibling tools like mio_jpg_to_pdf (JPG to PDF) or mio_image_png_to_svg.
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. The description focuses on credit and pricing details but does not mention sibling tools or scenarios where other converters (e.g., mio_jpg_to_pdf) might be more appropriate.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_pdf_remove_pagesCInspect
Remove PDF Pages — Remove specific pages from a PDF document. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries full burden. It notes the tool 'runs in the browser' but fails to disclose whether it modifies the original file, returns a new PDF, or any success/failure behaviors. The credit and pricing info is irrelevant to behavioral 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 fairly concise with only three sentences. The first sentence effectively states the purpose. However, the two sentences on credits could be considered tangential, slightly reducing focus.
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 no output schema and no annotations, the description is incomplete. It does not explain what happens after page removal (e.g., download link, replacement), nor how the user selects pages. The pricing info does not fill these gaps.
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 schema has 0 parameters, so description should clarify how inputs (e.g., which PDF and pages) are provided implicitly via context. It does not, instead focusing on pricing. Baseline 4 is not met because the description adds no semantics for the tool's operation.
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 ('Remove') and resource ('PDF Pages') and specifies the action of removing specific pages from a PDF document. However, it does not explicitly differentiate from sibling tools like mio_pdf_editor, which may also allow page removal.
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 mio_pdf_split or mio_pdf_editor. It mentions credit coverage but lacks context on prerequisites or workflow (e.g., the PDF must be previously uploaded).
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_pdf_rotateBInspect
Rotate PDF — Rotate PDF pages to any angle. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The only behavioral information is 'Runs in the browser,' but it fails to explain critical aspects like how to provide the PDF file or what angles are supported. With no annotations, this leaves significant gaps.
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 purpose line is concise, but the extensive pricing details are not directly relevant to tool invocation and could be trimmed to improve focus.
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 omits essential context such as how the user provides a PDF, supported rotation angles, and output behavior. This is a significant gap for a tool with no parameters and no 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?
The input schema has no properties, and the description does not add any parameter-related meaning. Since schema coverage is 100% (empty), the baseline score of 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 verb 'rotate' and the resource 'PDF pages' at the beginning, distinguishing it from similar sibling tools like 'mio_image_rotate' and 'mio_video_rotate'.
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, nor does it mention prerequisites or expected input context. It focuses heavily on pricing instead of usage.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_pdf_splitBInspect
Split PDF — Extract specific pages from a PDF into a new file. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided. Description lacks disclosures about whether original file is preserved, file size limits, privacy, or processing behavior. Only states 'runs in browser' but no user-facing 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?
Description is a bit lengthy with pricing details that are not essential for tool selection. Could be more concise while retaining core functionality.
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?
Missing critical context: no mention of required input (e.g., a PDF file), how to specify page range, output format, or success criteria. For a tool with no params, description should clarify the interaction model.
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 has zero parameters, so schema coverage is 100%. Baseline 3 is appropriate; description does not add parameter info because there are none, but fails to explain how pages are specified (e.g., via UI).
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?
Clearly states the action (split/extract) and resource (specific pages from PDF into a new file). Distinguishes from siblings like merge, remove pages, 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?
Mentions credit and pricing context but does not specify when to use this tool vs alternatives, nor prerequisites like having a PDF file or how to specify pages.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_pdf_tiff_to_pdfAInspect
TIFF to PDF — Convert TIFF images to PDF documents. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Discloses browser execution and credit usage, which are important behavioral traits. Without annotations, the description provides moderate transparency but omits details like file size limits or privacy implications.
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 brief and front-loaded with the core purpose, followed by relevant execution and pricing details. 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?
Given zero parameters and no output schema, the description adequately covers purpose, execution context, and pricing. It lacks details on input format variants or output properties but is sufficient for a simple conversion tool.
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 has no parameters, so no additional explanation is needed. The description does not mislead and the schema coverage is 100%.
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 'Convert TIFF images to PDF documents' uses a specific verb and resource, clearly stating the tool's function. It distinguishes from sibling conversion tools like mio_jpg_to_pdf by explicitly mentioning TIFF.
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?
Provides context on execution (browser) and pricing model (credits, Day Pass), which helps in deciding when to use. However, it does not explicitly contrast with alternative tools or specify conditions to avoid.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_pdf_to_docBInspect
PDF to DOC — Convert PDF files to editable Word documents. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description should disclose behavioral traits; it only mentions 'Runs in the browser' and pricing, but omits how input is provided, output format details, file size limits, 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?
The description is short and front-loaded, but the pricing details could be considered extraneous for core functionality. Still, it remains efficient with 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 tool has no parameters and no output schema, the description fails to explain how the PDF is provided or what the output looks like, leaving an agent uncertain about 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?
The input schema has zero parameters, so the description has no need to explain them. Baseline 4 is appropriate as there is no missing parameter info.
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 explicitly states 'Convert PDF files to editable Word documents', clearly identifying the function and distinguishing it from other PDF-to-X tools among siblings.
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 guidance on when to use this tool versus alternatives like pdf_to_text or pdf_to_xlsx. It only mentions credit coverage, not usage context.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_pdf_to_jpgAInspect
PDF to JPG — Convert PDF pages to high-quality JPG images. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must disclose behavioral traits. It mentions running in browser and billing, but does not disclose whether the conversion is destructive, file handling details, or output specifics beyond 'JPG images'. This is adequate for a simple conversion but lacks depth.
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, each serving a purpose: first defines the tool, second provides billing context. No redundancy or unnecessary 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 has no parameters and no output schema, the description covers the essential aspects: purpose, environment, and pricing. It could be more complete about potential limitations (max pages, file size), but current content is sufficient for a simple tool.
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 zero parameters, so schema coverage is 100%. The description adds value by explaining the conversion context, but no parameter-specific info is needed. Baseline score of 4 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 action 'Convert PDF pages to high-quality JPG images', specifying the source and result. It distinguishes from sibling tools like mio_jpg_to_pdf which does the opposite.
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 billing and runtime context (browser, credits, day pass) which helps agents decide on invocation. However, it does not explicitly state when to use vs alternatives or when not to use.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_pdf_to_textAInspect
PDF to Text — Extract text content from PDF files. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must carry the full burden. It mentions the tool 'runs in the browser' and billing, but fails to disclose critical behavioral traits like OCR support for scanned PDFs, file size limits, or output format. This is insufficient for a tool with zero annotation coverage.
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 three sentences long, starting with a clear purpose statement. The billing information, while relevant, is somewhat verbose and could be condensed. Overall, it is efficient but not extremely tight.
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 no parameters or output schema, the description adequately conveys purpose and billing context. However, it omits practical details such as output format, handling of encrypted PDFs, or limitations like page count, leaving gaps for a complete understanding.
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 zero parameters, so schema description coverage is trivially 100%. Per guidelines, 0 parameters yield a baseline of 4. The description does not add parameter information because none exist, and it is not required.
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 'Extract text content from PDF files,' using a specific verb and resource. This distinguishes it from sibling tools like mio_pdf_to_doc or mio_pdf_to_jpg, which convert to different formats.
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 this tool is for text extraction but provides no explicit guidance on when to use it versus alternatives. It focuses on billing details rather than usage context, leaving the agent to infer applicability.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_pdf_to_xlsxBInspect
PDF to Excel — Convert PDF tables to editable Excel spreadsheets. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description bears full responsibility for behavioral disclosure. It adds that the tool runs in the browser and discusses billing, but does not mention key traits like input method, output format, limitations (e.g., table detection accuracy, page limits), or error handling. The billing context is helpful but insufficient for behavioral 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 front-loads the purpose with 'PDF to Excel — Convert PDF tables to editable Excel spreadsheets.' However, it then spends considerable text on credit and pricing details, which could be more succinct. While not overly long, the billing information could be separated or summarized.
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 empty input schema and no output schema, the description must provide sufficient context for tool invocation. It covers the conversion purpose and billing, but omits critical details such as how to provide the PDF file (likely via parameter, but schema shows none), expected output format, and any constraints. Thus, it leaves significant gaps for an agent to use the tool 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 input schema is empty (0 parameters), so schema description coverage is 100%. The description does not add parameter semantics because there are none to add. Following the guidelines, baseline 4 is appropriate as the description is not needed to compensate for missing parameter info.
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 converts PDF tables to editable Excel spreadsheets, using a specific verb ('Convert') and resource ('PDF tables to Excel'). It distinguishes itself from other PDF conversion tools like mio_pdf_to_doc or mio_pdf_to_text by focusing on table extraction, making the purpose unambiguous.
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 it runs in the browser and discusses credit coverage, which implies online usage. However, it does not explicitly state when to use this tool vs alternatives such as mio_xlsx_to_pdf (reverse operation) or when not to use it. No comparative guidance is provided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_pdf_txt_to_pdfAInspect
TXT to PDF — Convert text files to PDF format. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden. It only mentions 'Runs in the browser', but fails to disclose how input is provided (e.g., file upload), whether there are size limits, or any synchronous behavior. The 0-parameter schema suggests input must be provided via some external mechanism, which is not explained.
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 three sentences, with the first stating purpose. However, the remaining two sentences contain billing information that may be better placed in a separate pricing tool, reducing conciseness for the tool's core function.
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 0 parameters and no output schema, the description is expected to explain input mechanism and output format. It only mentions conversion and browser execution, leaving out how the agent supplies the text file, which is critical for 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?
There are no parameters, so the schema coverage is 100%. The description adds no parameter info, but baseline for 0 parameters is 4. No compensation needed.
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 'Convert text files to PDF format', which is a specific verb+resource combination. It distinguishes from sibling PDF conversion tools like mio_pdf_image_to_pdf or mio_pdf_from_word.
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 clearly states the use case (convert text files to PDF). While it does not explicitly exclude other formats or mention alternatives, the name and purpose are sufficiently unambiguous for an agent to infer when to use this tool.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_pdf_unlockCInspect
Unlock PDF — Remove password protection from PDF files. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Without annotations, the description must fully disclose behavioral traits. It states the tool removes password protection but does not indicate whether it modifies the original file, creates a new file, or has any side effects. The pricing information is not behavioral context.
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 three sentences, which is reasonably concise, but includes unnecessary pricing details that could be omitted or moved. It could be more focused on the tool's core function.
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 incomplete for a zero-parameter tool. It does not explain the output or return value, nor does it differentiate from sibling tools beyond the basic purpose. An agent would lack information on how to integrate this tool into a workflow.
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 zero parameters, so the description should explain how the tool receives input (e.g., via file picker or session). It fails to do so, leaving the agent without guidance on how to invoke the tool correctly. The description adds no value beyond the schema.
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 'Unlock PDF — Remove password protection from PDF files,' providing a specific verb and resource. This distinguishes it from sibling tools like mio_pdf_compress or mio_pdf_edit, which have different purposes.
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 it runs in the browser but does not explain how to invoke the tool, such as how to provide the PDF file. It lacks guidance on when to use it versus other PDF tools and does not mention any prerequisites or required user actions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_pdf_unzipCInspect
Extract Archive — Extract files from ZIP, RAR, 7z, TAR, GZ archives. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Without annotations, the description must disclose behaviors. It mentions running in browser and credit usage, but lacks details on input expectations, output format, size limits, or whether files are stored. The actual extraction behavior is inferred, not explicitly stated.
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 core function is in the first sentence, but the rest consists of pricing information that could be condensed. While not excessively long, it includes extraneous details for tool selection.
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 0 parameters and no output schema, the description fails to cover basic context: how the tool receives input, whether it returns extracted files or a download link, or typical use cases. The agent lacks key information 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?
With 0 parameters, the schema provides no constraints. The description does not explain how the agent should provide an archive file (e.g., via file upload). A baseline of 4 is not met because the description adds no meaningful semantic context beyond the empty schema.
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 explicitly states 'Extract files from ZIP, RAR, 7z, TAR, GZ archives' with a clear verb+resource structure. Though the name includes 'pdf', the description distinguishes it as an archive extractor, separate from other PDF 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 is provided on when to use this tool versus alternatives, such as similar archive extractors or other mio_pdf tools. The description focuses on credit plans rather than usage context.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_pdf_watermarkAInspect
Watermark PDF — Add text watermark to PDF pages. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided; description adds some behavioral context (runs in browser, billing info) but omits important details like whether it modifies original or creates new file.
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?
Description is concise, front-loaded with purpose, then execution location and pricing. No fluff, 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?
Given 0 parameters and no output schema, description covers basic functionality and pricing but fails to explain how to specify the watermark text or customization options.
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 has 0 parameters; baseline 4 applies. Description adds no parameter info, but none needed.
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 verb 'Add text watermark' and resource 'PDF pages', distinguishing it from other PDF tools like merge, split, 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?
Description lacks explicit guidance on when to use vs alternatives; only implies usage through purpose. No exclusions or when-not-to-use mentioned.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_pdf_zipAInspect
Create ZIP — Compress files into a ZIP archive. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations exist, so the description carries the full burden. It mentions 'Runs in the browser' and discusses credit coverage, but does not detail behavioral traits such as whether original files are modified, what the output is, or any side effects. This is adequate but not rich.
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 front-loaded with the core purpose in a single line, then adds relevant business context (credits, day pass, workspace unlock). Every sentence provides some value, though the pricing details could be considered secondary. It is appropriately sized for a simple tool.
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 no output schema, the description covers the basic operation and credit system. However, it does not explain how files are selected for compression (e.g., implicit from context or UI) or provide any details about the output ZIP. It is somewhat incomplete for an MCP tool that may need to know about input sources.
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 zero parameters, and schema description coverage is trivially 100%. Per the baseline rule for 0 parameters, the description need not add parameter-level meaning, and it does not. A score of 4 reflects that no additional param info is needed.
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 opens with 'Create ZIP — Compress files into a ZIP archive,' which clearly states the verb and resource. The name 'mio_pdf_zip' and sibling 'mio_pdf_unzip' provide differentiation: one compresses, the other decompresses.
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 explicitly state when to use this tool versus alternatives. It notes that the tool runs in the browser and is covered by credits, but it does not provide context where other tools might be preferred. No disclaimers 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.
mio_scanner_barcodeBInspect
Barcode Scanner — Scan and decode barcodes (EAN, UPC, Code 128, etc.) from camera or images. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description should disclose behavioral traits. It mentions 'Runs in the browser' but omits crucial details like whether it requires user interaction, real-time processing, file upload support, or data storage policies. The pricing info does not compensate for missing behavioral 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 concise at three sentences, front-loaded with purpose. The second and third sentences cover pricing, which is relevant but could be considered extraneous. Overall, 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 no output schema and no annotations, the description is incomplete. It does not explain expected output (e.g., decoded text), input details (image file vs camera stream), or any constraints. The pricing info, while useful, does not fill the completeness gap.
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 0 parameters, so the manual baseline is 4. The description does not add parameter info, but with zero parameters there is nothing additional to convey. Schema coverage is 100% by default.
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 'Scan and decode barcodes (EAN, UPC, Code 128, etc.) from camera or images.' It uses a specific verb (scan/decode) and resource (barcodes), and distinguishes itself from sibling tools like QR scanner or document scanner.
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 pricing and credit details but does not offer guidance on when to use this tool versus alternatives like mio_scanner_qr or mio_scanner_document. It lacks usage context, prerequisites, or exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_scanner_batchAInspect
Batch Scanner — Rapid multi-page scanning with continuous camera mode for high-volume documents. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries full burden. It states 'Runs in the browser' but fails to disclose output format, page limits, or what happens to scans. Pricing info is given but not behavioral traits.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Four sentences, covering purpose and pricing. Slightly verbose with pricing details but not excessive. Could be trimmed without losing meaning.
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 no parameters or output schema, the description should provide more context about the tool's behavior and result. Lacks details on output format (PDF? images?), limits, or post-scan actions. Adequate but not 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?
Input schema has zero parameters, so baseline is 4. The description correctly omits parameter details since none exist.
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 'Rapid multi-page scanning with continuous camera mode for high-volume documents,' providing a specific verb+resource and distinguishing it from single-page scanner siblings.
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?
Mentions browser execution and pricing coverage (signup credits, Day Pass), but does not explicitly guide when to use batch vs single-page scanners. Implies high-volume use case but lacks clear directives or exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_scanner_bookAInspect
Book Scanner — Scan book pages with dual-page detection and automatic page splitting. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations exist, so the description must carry full burden. It mentions browser-based execution and credit coverage but lacks details on output format, saving behavior, or result handling. Behavioral traits like what happens after scanning are not 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?
Description is concise with three sentences, each adding value: purpose, browser and billing, and credit unlock details. No fluff, front-loaded with key information.
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 no parameters and no output schema, the description should provide complete context for invocation and results. It covers billing and browser but misses output format, how to retrieve scans, and what the agent should expect after calling the tool.
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 with 100% schema coverage. The description does not need to elaborate on parameters. It adds context about dual-page detection, which is a feature, not a parameter. Baseline 4 for zero parameters 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?
Description clearly states the tool scans book pages with dual-page detection and automatic page splitting, specifying the resource (book pages) and distinguishing it from other scanner tools like document or barcode scanners.
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 scanning books but does not explicitly guide when to use this tool versus other scanner variants like mio_scanner_document or mio_scanner_batch. No when-not or alternative guidance is provided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_scanner_documentBInspect
Document Scanner — Scan documents with auto edge detection, perspective correction & enhancement. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description must fully disclose behavior. It notes the tool runs in the browser, which is helpful, but fails to describe what happens after scanning (output format, download behavior, or any side effects). This leaves significant gaps for an AI agent.
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 front-loaded with the tool's core function, but the credit explanation is verbose and could be more concise. It still communicates essential information without being overly long.
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 lack of output schema and annotations, the description should clarify output format, download behavior, and how the agent should invoke it (e.g., guide user to scan). It only covers function and credits, leaving the operational context incomplete.
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 zero parameters, so baseline is 4. The description adds value by stating 'Runs in the browser,' implying no file parameter is needed. However, it does not explain how the document is captured beyond that.
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 'Document Scanner — Scan documents with auto edge detection, perspective correction & enhancement.' It clearly identifies the tool as a document scanner with specific capabilities, distinguishing it from sibling scanners like barcode, receipt, or ID card scanners.
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 coverage by signup credits and Day Pass, providing context on when the tool is accessible. However, it does not explicitly state when not to use it or compare it to other scanning tools, leaving usage guidance somewhat vague beyond pricing.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_scanner_handwritingAInspect
Handwriting to Text — Scan handwritten notes and convert to editable text using OCR. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Despite no annotations, the description adds context by noting it runs in the browser and explaining credit/pricing details. It does not disclose any destructive behavior, auth needs, or rate limits, but the operation is inherently non-destructive and the pricing info is helpful.
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 at about 60 words, starting with a clear purpose. Some credit/pricing details may be slightly verbose for a tool description, but they provide necessary 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 description lacks explicit details about output format, supported languages, or quality limitations. Since there is no output schema, the description should compensate, but it only says 'convert to editable text' without specifics.
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 zero parameters, so baseline is 4. The description adds no parameter info, but there are none to describe. Schema coverage is 100% naturally.
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 scans handwritten notes and converts to editable text using OCR. It includes a title-like header 'Handwriting to Text' and distinguishes from sibling tools like document or barcode scanners by specifying the resource and purpose.
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 this tool is for handwriting-to-text conversion, making usage clear. However, it does not explicitly mention when not to use it or provide alternative tools, though sibling names make alternatives obvious.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_scanner_id_cardBInspect
ID Card Scanner — Scan ID cards, passports & licenses with fixed aspect ratio and front+back layout. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, and the description only mentions that the tool runs in the browser and its credit coverage. It omits details about side effects, data handling, or auth requirements, which are critical for a scanning tool.
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 four sentences; the first defines the core purpose, but the remaining three focus heavily on billing, which is partially redundant (pricing link). It could be more concise without losing critical billing 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?
Given the tool's simplicity (no parameters, no output schema), the description covers the scanning type and layout. However, it lacks information about output format (image/PDF) and any limitations on document size or quality, leaving some gaps.
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 no parameters, so the description naturally adds value by specifying what documents are scanned and the layout. The baseline for zero-parameter tools is 4, and the description provides relevant context beyond the empty schema.
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 explicitly states that the tool scans ID cards, passports, and licenses with fixed aspect ratio and front+back layout, clearly distinguishing it from sibling scanner tools like document, barcode, or receipt scanners.
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 explicit guidance on when to use this tool versus alternatives among the many scanner siblings. It covers billing information but does not clarify criteria for selection.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_scanner_photo_to_pdfCInspect
Photo to PDF — Convert photos to PDF with multi-image batch support and minimal processing. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description bears full responsibility for behavioral disclosure. It mentions the tool runs in the browser and minimal processing, but does not address safety (e.g., destructiveness), permissions, 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?
The description is front-loaded with the core function but then includes verbose billing info that may be unnecessary for tool selection. It could be more concise by trimming credit/pricing details.
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 no parameters and no output schema, the description should explain usage context (e.g., input file types, how to provide photos) but omits these. It assumes user knowledge about browser-based processing.
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 no parameters, and schema description coverage is 100%, so baseline 3 is appropriate. The description adds no parameter-specific meaning, but the lack of parameters is clear.
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 converts photos to PDF with multi-image batch support, specifying the resource and action. However, it does not explicitly differentiate from similar siblings like 'mio_jpg_to_pdf' or 'mio_pdf_image_to_pdf', relying on the scanner category 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. It focuses on billing and policy details (credits, passes) rather than usage context or selection criteria.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_scanner_qrAInspect
QR Code Scanner — Scan and decode QR codes from camera or images instantly. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description reveals that the tool runs in the browser and has credit-based access. It does not disclose data handling or privacy implications, but these are not critical for a simple scanner tool.
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, front-loads the main function, and each sentence adds value without unnecessary fluff.
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 no parameters and no output schema, the description adequately covers purpose, runtime environment, and pricing context. It is complete for its simplicity.
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 zero parameters, so the description does not need to explain them. Baseline 4 applies as per guidelines.
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 function: 'Scan and decode QR codes from camera or images instantly.' The title 'QR Code Scanner' distinguishes it from sibling scanner tools like mio_scanner_barcode and mio_scanner_document.
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?
Mentions that it runs in the browser and is covered by credits or a Day Pass, providing context for when to use. However, it does not explicitly state when not to use it or compare with alternatives.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_scanner_receiptAInspect
Receipt Scanner — Scan receipts with tight auto-crop optimized for small documents. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description bears full burden. It discloses that the tool runs in the browser and provides credit/payment details, but lacks information on side effects, file types, or expected input format.
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 moderately concise, front-loading the core scanning function and then adding relevant credit details. Each sentence adds value, though the credit info could be more succinct.
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 covers purpose and browser execution, but fails to mention output format (e.g., PDF or image) or accepted file types. Given no output schema, this omission leaves the tool's behavior incomplete.
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 no parameters (100% coverage trivially). The description does not explain how to provide the receipt (e.g., file upload, image paste), which is a significant gap for a scanner tool.
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 scans receipts with tight auto-crop optimized for small documents. It distinguishes from siblings like scanner_document and scanner_barcode by specifying 'receipts' and the specialized auto-crop feature.
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 receipts but does not explicitly compare with alternatives or state when not to use. No guidance on choosing this over other scanner tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_scanner_whiteboardAInspect
Whiteboard Scanner — Scan whiteboards with high contrast, color boost & white balance correction. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Discloses it runs in browser and applies image enhancements, but does not describe output format or behavior beyond that. No annotations to supplement, so carries more burden.
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?
Front-loaded with core function in first sentence, then additional credit info. Every sentence adds value, no waste.
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?
Covers purpose, basic behavior, and pricing. Lacks output description, but for a zero-param tool with low complexity, it is reasonably 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?
No parameters exist, so baseline is 4. Description adds credit/pricing context, which is extra but not needed 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?
Description clearly states it scans whiteboards with specific enhancements (high contrast, color boost, white balance correction). The name and description distinguish it from sibling scanner tools like document, barcode, 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 explicit when-to-use or when-not-to compared to other scanners. The name implies whiteboards, but siblings are numerous and similar, so more guidance would help.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_video_aac_to_mp3BInspect
AAC to MP3 — Convert AAC audio to MP3 format. Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations exist, so the description must bear full transparency. It mentions browser-based processing and higher credit usage, but fails to disclose key behaviors like file input mechanism, size limits, output format details, or whether it is synchronous.
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 a single paragraph with the core purpose upfront. However, it includes lengthy credit/pricing details that could be condensed or moved to a separate note, reducing clarity for the primary conversion task.
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 no output schema, the description should explain return values (e.g., 'returns an MP3 file'). It omits input specification, output format, and constraints (file size, supported AAC variants). The focus on pricing does not compensate for operational gaps.
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 zero parameters, but the description does not clarify how input is provided (e.g., file upload). It only states the conversion direction without explaining how to invoke the tool. Despite schema coverage being 100%, the description adds no parameter meaning.
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 starts with 'AAC to MP3 — Convert AAC audio to MP3 format,' clearly stating the verb (convert) and resource (AAC audio to MP3). It distinguishes from many sibling tools with similar names by specifying the input 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?
The description implies usage when AAC to MP3 conversion is needed, and mentions credit constraints (welcome credits cover limited runs, Day Pass excludes this workspace) which guides cost-conscious use. However, it does not explicitly suggest alternatives among siblings or state prerequisites.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_video_add_audioCInspect
Add Audio to Video — Replace or add audio track to a video file. Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of disclosing behavior. It mentions it processes in the browser and uses credits, but does not explain side effects (e.g., whether original file is modified), required inputs, or output format. The pricing details are not behavioral traits.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is front-loaded with the purpose, but the latter half is dominated by pricing minutiae that could be summarized or linked. It is longer than necessary for a tool with no parameters, reducing 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?
Given the empty input schema and no output schema, the description should explain how to invoke the tool and what to expect. It fails to do so, focusing solely on credits. The agent cannot determine how to provide the video and audio files.
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 zero parameters, which is unusual for a tool that requires a video and audio file. The description does not clarify how inputs are provided (e.g., via selection or upload). The baseline of 4 for zero parameters is not met because the description adds no meaningful input guidance.
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 adds or replaces an audio track in a video file. However, it does not differentiate from sibling tools like mute or normalize audio, which have similar purposes.
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 extensive pricing and credit information but offers no guidance on when to use this tool versus alternatives like mio_video_mute or audio editing tools. It does not explain use cases or prerequisites.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_video_auto_captionsCInspect
Auto Captions — Automatically add subtitles to video using AI speech recognition. AI Studio run — dispatches to our AI workers (Modal). Credits per run vary by model and file size. Day Pass and welcome credits do not include AI Studio. Files are deleted after processing; auditable at mioffice.ai/account/tasks (retention details at mioffice.ai/privacy). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden. It discloses that the tool is an AI Studio run, notes credit variation, mentions file deletion after processing, and points to auditability and privacy details. However, it omits details about processing limits, supported input formats, or any destructive behavior beyond file deletion.
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 a single paragraph with multiple sentences, front-loading the main action. It contains some extraneous details about credits and privacy that are important but could be presented more compactly. It is adequately sized but not exceptionally 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?
Given the complexity (AI video processing) and absence of output schema, the description lacks critical context: how the video is supplied, what subtitle formats are produced, and any constraints on video length or file size. The credit and retention info is useful but does not compensate for these gaps.
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 0 properties, so schema coverage is 100% vacuously, but the description fails to explain how the video input is provided. It mentions 'AI Studio run' but does not clarify that the video might be passed via context or file attachment. This gap undermines the parameter semantics 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 clearly states the tool's function: 'Automatically add subtitles to video using AI speech recognition.' It uses specific verb-resource pair ('add subtitles') and mentions AI speech recognition. However, it does not explicitly differentiate from the sibling tool 'mio_ai_video_subtitler', which may have similar functionality.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides credit and data retention context but lacks explicit guidance on when to use this tool versus alternatives like mio_ai_video_subtitler. It does not specify prerequisites or the process for providing the input video, which is critical for usage.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_video_avi_to_mp4AInspect
AVI to MP4 — Convert AVI videos to MP4 format. Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Without annotations, the description partially discloses behavior by stating it processes in the browser and uses credits, but it lacks details on conversion specifics such as file size limits, supported codecs, or output handling. It does not contradict annotations since none exist.
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 front-loaded with the core purpose and each sentence adds value regarding credits and pricing. It is slightly verbose but not excessively so, and the structure is logical.
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 incomplete in that it does not explain how the input AVI file is provided (no parameters) or where the output MP4 is saved. Given no output schema, the agent lacks critical information to use the tool 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 input schema has zero parameters, so the baseline is 4. The description does not add parameter meaning, but it is not required as there are no parameters to document.
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 converts AVI videos to MP4 format with a specific verb and resource, and it distinguishes from sibling tools like mio_video_mkv_to_mp4 and mio_video_mov_to_mp4 by specifying the input 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?
The description provides context about credit usage, workspace restrictions, and pricing, helping the agent understand when to use the tool. It mentions that Day Pass does not include this workspace and that credits are limited, but does not explicitly exclude other formats or provide alternative tool recommendations.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_video_colorBInspect
Color Grade Video — Adjust brightness, contrast, saturation, gamma, and hue. Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description reveals that the tool runs in the browser and consumes credits, but it omits critical behavioral details such as whether the input video is modified in-place or a new file is created, and how the input video is provided (since the schema has no parameters). This lack of clarity reduces 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 front-loaded with the core purpose, but includes lengthy pricing and credit details that could be condensed or referenced elsewhere. While not overly verbose, the additional information detracts from conciseness for an agent focused on functional behavior.
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 no parameters and no output schema, the description should fully explain how to invoke the tool and what to expect. It fails to clarify how the video is selected, whether it is pre-loaded from context, and what the output format or result is. This leaves significant gaps for an agent.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Despite having no parameters in the schema, the description enriches understanding by listing the adjustable attributes (brightness, contrast, etc.), which effectively describes the internal controls. This adds meaning beyond the empty schema, making the tool's capabilities clear.
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 starts with 'Color Grade Video' and immediately lists specific adjustments: brightness, contrast, saturation, gamma, and hue. This clearly identifies the tool's purpose as a color grading tool for videos, distinguishing it from the many other video processing tools in the sibling list.
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 video_enhancer or video_denoise. It does not mention any prerequisites or exclusions. The pricing information is present but does not help in deciding usage context.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_video_compressBInspect
Compress Video — Reduce video file size. Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries full burden for behavioral disclosure. It notes credit usage and workspace restrictions but omits critical details like supported input formats, output quality, lossy vs lossless behavior, or any side effects. The agent lacks key behavioral understanding.
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 front-loaded with the purpose in the first sentence. However, it includes several sentences about pricing and credits which, while potentially useful, add length. The overall structure is clear but could be more 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?
Given no output schema and no parameters, the description should comprehensively explain the tool's operation. It fails to cover input formats, output characteristics, quality settings, or any limitations. The pricing info is not enough to make the agent fully informed.
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 zero parameters, so schema coverage is 100%. Per guidelines, baseline is 3. The description adds no parameter-related information, as there are none, but also does not explain how the tool receives the video input, which could be a gap.
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: 'Compress Video — Reduce video file size.' The verb 'compress' and resource 'video' are specific, and among siblings, there are no other video compress tools, so it is well-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?
The description provides no explicit guidance on when to use this tool over alternatives or when not to use it. It mentions credit usage and pricing but does not help an agent decide between this and other compression tools like 'mio_image_compress' or 'mio_pdf_compress'. Usage is implied by the name.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_video_converterAInspect
Video Converter — Convert between MP4 and WebM with quality control. Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Discloses that processing happens in the browser and credit usage relative to other workspaces, but lacks details on conversion behavior, limitations, or what 'quality control' entails. With no annotations, description should provide more technical clarity.
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?
Description is front-loaded with purpose, then provides necessary credit context. It is somewhat lengthy but each sentence adds value. Structure is logical, no redundancy.
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?
Covers credit and workspace context well, but is incomplete for tool differentiation. Lacks explanation of how quality is controlled, file size limits, or comparison to sibling converters. With many siblings, more specific guidance is needed.
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 has 0 parameters (100% coverage by default). Baseline for 0 parameters is 4. Description adds no parameter details, but none are needed. The claim of 'quality control' is vague but does not contradict the schema.
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 converts between MP4 and WebM with quality control. This differentiates it from specific one-way converters like mio_video_webm_to_mp4, showing a distinct bidirectional purpose.
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?
Provides context about credits and workspace inclusion (e.g., not in Day Pass), but does not guide when to use this vs. the many sibling format-specific converters. Usage context is implied but not explicit.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_video_cropCInspect
Crop Video — Crop video to custom dimensions. Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries full burden for behavioral disclosure. It only mentions browser processing and credit usage, but fails to disclose critical traits like output format, side effects on input, or whether it's synchronous. The description is almost entirely about pricing.
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 verbose with extraneous pricing and workspace details that do not aid in tool usage. The first sentence is concise but the remaining content is irrelevant for invocation, making it poorly structured for an AI agent.
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 no output schema, the description is critically incomplete. It does not explain how to specify crop dimensions, what the output is, or any prerequisites. The pricing information does not compensate for the lack of functional 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?
The input schema has zero parameters, yet the description claims cropping to custom dimensions. No mechanism for specifying dimensions is provided. The description adds no meaning beyond the empty schema, leaving the agent without necessary param guidance.
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 'Crop Video — Crop video to custom dimensions' which clearly indicates the action (crop) and resource (video). It is specific enough to distinguish from siblings like resize or trim, though it could be more precise about the nature of cropping.
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 lacks guidance on when to use this tool versus alternatives. It does not mention any criteria for choosing crop over resize, trim, or other video editing tools. The focus is on pricing and credits, not usage context.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_video_denoiseBInspect
Video Denoise — Remove grain and noise from video footage. Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so the description must fully disclose behavior. It mentions browser processing and credit cost but fails to describe denoising strength, output format, or any side effects. The pricing details are not behavioral traits of the tool itself.
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 starts well with the core function but then includes extensive pricing and workspace information that is not essential for understanding how to use the tool. It could be more concise by moving pricing details elsewhere.
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 covers pricing and workspace access, which is useful context, but it does not explain how input is provided (e.g., current video file) or what output to expect. Without an output schema, the return format is unclear.
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 0 parameters and schema coverage is 100% (vacuously). The description adds no parameter information, but the baseline for 0 parameters is 4. The schema already fully describes the parameter set.
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 'Remove grain and noise from video footage' which clearly identifies the tool's core function. However, it does not distinguish it from similar video enhancement tools like mio_ai_video_enhancer or the sibling audio denoise.
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 (e.g., audio denoise or other video filters). It focuses on pricing and credit usage rather than usage context.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_video_extract_subtitlesAInspect
Extract Subtitles — Extract embedded subtitles from MKV/MP4 video. Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden. It discloses that processing occurs in the browser, consumes credits, and explains workspace pricing details. However, it does not describe the output format or any side effects, which leaves some ambiguity.
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 and front-loaded with the core purpose. The additional pricing details are relevant but slightly expand the length. Every sentence serves a purpose, though some could be consolidated.
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 lacks information about the tool's return value (e.g., subtitle file format). Given no output schema, this is a gap. It also does not explain how the user provides the video file. Credit and workspace details are well covered.
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 zero parameters, and schema coverage is 100%. Per guidelines, a baseline of 4 applies for zero parameters. The description naturally adds no parameter semantics, which is acceptable.
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 'Extract embedded subtitles from MKV/MP4 video,' specifying the verb, resource, and file formats. It differentiates from sibling tools like mio_ai_video_subtitler (which adds subtitles) and mio_ai_transcriber (speech-to-text).
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 context about credit usage and pricing but lacks explicit guidance on when to use this tool versus alternatives. It does not mention typical use cases or prerequisites like having a video file with embedded subtitles.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_video_fadeCInspect
Video Fade — Add fade-in and fade-out transitions to video. Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided. Description only mentions it runs in the browser and consumes credits, but lacks details on behavioral traits like whether it modifies the original video, output format, or required input.
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?
Description is verbose, mixing purpose with extensive credit/pricing details that are not essential for understanding how to use the tool. Could be more 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?
Tool has no parameters or output schema, so description should explain what the tool expects and produces. It only states the effect (fade) and credit restrictions, leaving important context (e.g., input video source, output location) unclear.
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 has zero parameters, so description need not add parameter meaning. Baseline for 0 params is 4; no additional info is needed.
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 'add' and resource 'fade-in and fade-out transitions to video,' but lacks differentiation from sibling tools. However, among many video tools, 'fade' is unique, so clarity is good.
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. Description focuses on credit/workspace details rather than usage context or prerequisites.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_video_flac_to_mp3BInspect
FLAC to MP3 — Convert FLAC audio to MP3 format. Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description must fully disclose behavior. It only mentions in-browser processing and credit usage, but omits critical details like file size limits, supported sample rates, or output quality. The credit discussion does not constitute behavioral 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 purpose is front-loaded, but about half the description covers credit and pricing information, which is tangential to tool selection. It could be more 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?
For a parameterless conversion tool, the description covers the basic purpose and mentions the workspace. However, it lacks technical details such as output quality, input requirements, or any limitations, which would help an agent invoke 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 input schema has zero parameters, so the description is not required to add parameter details. The baseline is 4, and the description does not need further 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 converts FLAC to MP3 and mentions the workspace. However, it does not differentiate from sibling tools like mio_video_aac_to_mp3 or mio_audio_converter, which also convert audio formats.
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 description focuses on credit costs rather than providing usage context or prerequisites.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_video_flipCInspect
Flip Video — Mirror video horizontally or vertically. Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are present, so the description carries full burden. It mentions browser processing and credit consumption, but fails to disclose whether the operation is destructive, reversible, or requires specific permissions. Key behavioral aspects are omitted.
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 a single paragraph with extraneous pricing details. The first sentence is concise, but subsequent sentences on credits and plans add length without aiding tool usage. It could be more focused.
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 no parameters, output schema, or annotations, the description should fully explain tool behavior. It covers the basic action but omits how to specify flip direction, expected input format, and output details, leaving gaps 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 tool has zero parameters, and schema coverage is 100% trivially. Baseline for 0 parameters is 4. The description adds no parameter info, which is acceptable given the schema covers everything.
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 flips video horizontally or vertically. It uses a specific verb and resource, distinguishing it from siblings like rotate or crop. However, it does not explain how to specify the flip direction, which may leave 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 focuses on credit pricing and workspace tiers but lacks guidance on when to use this tool versus alternatives (e.g., rotate, crop). No explicit when-not-to-use or alternative tool references are provided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_video_gif_to_mp4AInspect
GIF to MP4 — Convert animated GIF to MP4 video. Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description discloses browser processing and credit consumption, but lacks details on safety or side effects beyond credits.
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?
Reasonably concise, front-loads main purpose, though the credit/pricing details could be slightly trimmed.
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?
Covers main functionality, run environment, and pricing, but does not describe output format or return behavior.
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 in schema; description correctly abstains from adding param info. Baseline 4 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 verb 'Convert' and resource 'animated GIF to MP4 video', distinguishing it from siblings like 'mio_video_to_gif' which does the reverse.
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?
Provides context about credit usage and workspace restrictions but does not explicitly compare with alternatives or state when not to use.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_video_hdr_to_sdrAInspect
HDR to SDR — Convert HDR video to SDR for universal playback. Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided. The description discloses that it processes in-browser and uses more credits than other workspaces, but it does not clarify whether the conversion is destructive, what happens to the original, or any quality implications. Essential behavioral traits are partially covered.
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 verbose, with five sentences. The first sentence is crisp, but the remaining four focus on pricing and credits, which could be condensed. The structure front-loads the core purpose but then digresses into secondary details.
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 no parameters, the description fails to explain how the agent should specify the input video (e.g., no file parameter). It also lacks details about output format, supported codecs, or limitations. The description is incomplete for an agent to invoke the tool correctly without assuming external 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?
The input schema has zero parameters, so description cannot add meaning beyond the schema. Schema coverage is 100% (nonexistent params). A baseline of 4 is appropriate since no additional parameter information is needed.
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: 'Convert HDR video to SDR for universal playback.' The verb 'convert' and resource 'HDR video to SDR' specify exactly what the tool does. Among siblings like mio_video_converter or mio_video_color, this tool is uniquely identified by the HDR-specific transformation.
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 context about credit costs and workspace restrictions, which helps an agent decide if the user can afford to use it. However, it does not explicitly compare to alternative tools (e.g., when to use this versus mio_video_converter) or state prerequisites. The usage guidance is implicit but not direct.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_video_loopBInspect
Loop Video — Repeat video multiple times to create a looping clip. Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description adds some behavioral context: runs in browser, uses credits, and is part of credit-based system. However, it does not disclose what happens to the original video or the output format, leaving gaps.
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 front-loaded with the core purpose, but then includes lengthy pricing details that could be relocated to a pricing tool or global context, reducing clarity for the tool's primary function.
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 no output schema, the description lacks details on the number of loops, input requirements, or output format. It is incomplete for an agent to know what to expect or how to invoke the tool without additional 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?
The input schema has zero parameters, and schema description coverage is 100% (trivially). The description mentions 'multiple times' but does not specify how to control this, so no additional semantic value beyond the schema.
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: 'Loop Video — Repeat video multiple times to create a looping clip.' This verb+resource combination is specific and distinguishes it from other video tools like trim or merge.
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?
Provides context about credit usage and workspace restrictions, but does not specify when to use this tool over alternatives or provide when-not scenarios. It implies usage through credit availability but lacks explicit guidance.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_video_m4a_to_mp3AInspect
M4A to MP3 — Convert M4A audio files to MP3 format. Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must cover behavioral traits. It mentions browser processing and credit consumption, which are useful. However, it does not disclose whether the conversion is non-destructive (likely safe), what happens to the source file, or the output format details. More could be said about 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 is concise: two sentences defining purpose, then a few sentences about credits and access. Every sentence adds value. It is front-loaded with the core 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 no parameters, no output schema, and no annotations, the description is fairly complete. It explains the conversion, credit implications, and directs to pricing. It could elaborate on output handling (e.g., download link) but is adequate for a straightforward tool.
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 no parameters (empty properties), and schema description coverage is 100%. The description adds no parameter info because none exist. For a parameterless tool, baseline is 4 given the description clearly states the conversion operation.
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 opens with 'M4A to MP3 — Convert M4A audio files to MP3 format.' This provides a clear, specific verb and resource. It distinguishes from sibling converters by explicitly naming the source and target formats.
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 explains credit usage, that Day Pass excludes this workspace, and points to pricing for details. It implicitly tells the agent when to use (when M4A to MP3 conversion is needed) and provides cost/access context. It does not explicitly list alternative tools for similar conversions but is adequate for a simple converter.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_video_mergeBInspect
Merge Videos — Combine multiple videos into one file. Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided. Description mentions in-browser processing and credit usage but does not disclose how videos are selected or what happens to input files. For a merge tool, this is insufficient 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?
Core purpose is front-loaded, but the description includes a lengthy pricing section that could be condensed. Every sentence adds some value, but it's longer than needed.
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 no output schema and no parameters, the description should explain how to supply videos and what to expect. It lacks details on input method, supported formats, and output behavior, focusing excessively on pricing.
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 has zero parameters, so baseline is 4. Description adds no param details but that's unnecessary as schema is fully covered.
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 'Merge Videos — Combine multiple videos into one file.' This is a specific verb and resource, differentiating it from other merge tools like pdf_merge and other video 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?
Provides credit and workspace context (Video And Audio Studio, credits per run, Day Pass exclusion) but does not explicitly state when to use this tool over sibling video tools like mio_video_compress or mio_video_trim.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_video_mkv_to_mp4BInspect
MKV to MP4 — Convert MKV videos to MP4 format. Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries full burden. It mentions browser processing and credit cost but does not disclose behavioral traits like permissions, rate limits, or whether the original file is modified. Important safety information is missing.
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 efficient at 5 sentences. The first sentence delivers the core purpose. Additional sentences about credits and pricing provide useful context without being overly 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?
For a simple conversion tool with zero parameters and no output schema, the description covers purpose, processing mode, and credit implications. It is sufficient for an agent to decide to use it, though it omits details about subtitle handling or codec defaults.
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 no properties, so schema description coverage is effectively 100%. The description cannot add parameter information beyond the schema. A 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 tool converts MKV to MP4 ('Convert MKV videos to MP4 format'). This is a specific verb+resource. While it does not explicitly differentiate from sibling video conversion tools like mio_video_avi_to_mp4, the name and first line imply the format scope, making it clear enough.
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 context about credit usage and pricing but does not give guidance on when to use this tool versus alternatives (e.g., mio_video_converter). It lacks explicit when-to-use/when-not-to-use instructions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_video_mov_to_mp4BInspect
MOV to MP4 — Convert MOV videos to MP4 format. Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must fully disclose behavioral traits. It mentions that the conversion 'processes in the browser' and discusses credits, but it does not describe potential side effects, limitations on input file size or codecs, whether the original file is retained or deleted, or any other behavioral nuances. This is insufficient for a tool with no 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 three sentences long. It front-loads the purpose but then includes detailed credit and pricing information that could be considered extraneous for a tool's core description. This extra content, while informative, reduces conciseness. A more streamlined description would improve this score.
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, no output schema, and no annotations, the description covers the basic conversion function and credit context. However, it lacks details on how to provide the input file (e.g., upload via a prior tool), any output file handling, or prerequisites. This leaves some gaps for an agent to understand the complete workflow.
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 zero parameters, and schema description coverage is 100% (trivially). The description adds no parameter information, which is acceptable because there are none. Per the guidelines, 0 params yields a baseline of 4. The description does not detract from this baseline.
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 function: 'MOV to MP4 — Convert MOV videos to MP4 format.' It specifies the verb and resources (MOV to MP4). However, it does not distinguish this from sibling tools like mio_video_converter or other format-specific converters, so it lacks explicit differentiation.
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 context about credit usage, stating it uses more credits than Document/Image/Scanner workspaces and that Day Pass does not include this workspace. It also mentions credit packs. However, it does not give explicit when-to-use or when-not-to-use guidance relative to alternative video conversion tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_video_mp3_cutterCInspect
MP3 Cutter — Trim and cut MP3 audio files. Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries full burden. It states 'processes in the browser' and credit cost, but fails to disclose essential behaviors: how input is provided (no parameters in schema), output format, file size limits, or whether the operation is destructive. This is insufficient for an agent to understand 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 first sentence concisely states the purpose, but over half of the description is devoted to credit and pricing information, which is extraneous and better suited to a separate pricing tool. This dilutes the message and makes the description unnecessarily long.
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, no output schema), the description should fully explain how to invoke it and what to expect. It fails to do so: no mention of required input file, output, or usage steps. Pricing info is irrelevant for 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?
The input schema has zero parameters (schema coverage 100% of an empty object). The description adds no explanation of how the tool receives input or what parameters are needed. For a trimming tool, this is a critical omission. The description should clarify expected input, but it does not.
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 starts with 'MP3 Cutter — Trim and cut MP3 audio files', which clearly states the tool's purpose (trimming MP3 files). This distinguishes it from many sibling tools like mio_video_trim or mio_video_to_mp3. However, the subsequent pricing details dilute the clarity.
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 vs. alternatives (e.g., other audio editors or trimming tools). It only mentions credit usage and pricing, which is not usage guidance. The description does not help an agent decide between this and similar tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_video_muteBInspect
Remove Audio from Video — Remove the audio track from a video, keeping video only. Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description bears full responsibility for behavioral disclosure. It mentions processing in-browser and credit costs, but does not describe side effects (e.g., whether the original file is modified, output format, or if the operation is reversible). Critical behavioral traits are missing.
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 includes relevant but somewhat extraneous information about credits and pricing, making it longer than necessary for a no-parameter tool. It could be more concise by front-loading the core function.
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 no parameters and no output schema, the description should still explain how the tool is invoked (e.g., provide a video file) and what the output is. It lacks these details, making it incomplete for an agent to use 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 input schema has no parameters (100% coverage, empty), so the description is not required to explain parameters. The baseline for 0 parameters is 4. The description adds no parameter information, but that is acceptable since there are none.
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 'Remove Audio from Video' which directly explains what the tool does. The verb 'Remove' and resource 'Audio from Video' are specific, and the tool name 'mio_video_mute' aligns. It distinguishes from siblings like 'mio_video_add_audio' which adds audio 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?
The description implies usage for removing audio, but does not explicitly state when to use this tool over alternatives (e.g., other video audio tools). It mentions credit usage and pricing, but not contextual guidance like 'Use this when you need a silent video without any audio track.'
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_video_normalize_audioCInspect
Normalize Audio — Normalize audio volume to standard levels. Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description bears full responsibility. It mentions browser processing and credit usage but does not disclose whether the operation is destructive, what happens to the original file, or any side effects.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is adequate but includes extraneous details about credits and pricing that distract from the core function. It could be more concise by front-loading the 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?
For a zero-param, no-output-schema tool, the description should explain implicit inputs and outputs. It fails to mention what video/audio is normalized, the output format, or how to use the result. Context is incomplete.
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 zero parameters, the description could clarify what input the tool acts on (e.g., current file in workspace). It does not, leaving ambiguity about how the tool is invoked.
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 'Normalize audio volume to standard levels', which is a specific verb+resource. However, it does not explicitly distinguish this tool from siblings like mio_audio_denoise or mio_audio_equalizer, though the normalization action is fairly unique.
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 lacks guidance on when to use this tool versus alternatives. It provides credit and pricing context but does not explain prerequisite conditions or typical use cases.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_video_ogg_to_mp3BInspect
OGG to MP3 — Convert OGG Vorbis audio to MP3 format. Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must bear full burden. It mentions browser processing and credit costs but fails to disclose key behavioral traits such as output handling, file size limits, synchrony, or whether the conversion is lossless. The billing info is useful but not behavioral.
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 four sentences long, with the first sentence capturing purpose clearly. However, the subsequent sentences heavily focus on billing details (credits, Day Pass, pricing) that may not be essential for tool selection, making it less concise than ideal.
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 no parameters and no output schema, the description covers the conversion action and credit implications. However, it omits important operational details like output format specifics (bitrate, quality), file size limits, or how to retrieve the output, leaving 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?
The input schema has no properties (0 parameters), and schema description coverage is 100%. The description adds no parameter information, but none is needed. However, it could have clarified how input is provided (e.g., file selection).
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 begins with 'OGG to MP3 — Convert OGG Vorbis audio to MP3 format,' which is a specific verb (convert) and resource (OGG Vorbis audio to MP3). The tool name itself differentiates it from siblings like mio_video_aac_to_mp3, ensuring clear purpose.
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 explicitly state when to use this tool versus alternatives like other conversion tools. It only implies usage via the format name, but lacks guidance on when to prefer this tool or exclusions (e.g., not for other audio formats).
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_video_resizeCInspect
Resize Video — Change video resolution with quality presets (480p to 1440p). Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries full burden. It states the tool processes in the browser and uses credits, but fails to disclose key behaviors: how the target video is identified (no input parameters), how output is delivered, whether the original file is modified, or any constraints like supported input formats. The focus on pricing overshadows operational 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 relatively concise but includes extraneous pricing details that could be omitted or placed elsewhere. The first line effectively states the purpose, but subsequent sentences about credit packs and subscriptions add length without aiding tool selection or invocation. The structure is acceptable but not optimal.
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 zero-parameter schema and no output schema, the description should explain how the tool determines the input video and what the output format is. It only mentions resolution presets, leaving a significant gap. Compared to sibling resize tools (e.g., mio_video_resize_square) which might have similar ambiguity, but still incomplete.
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 zero parameters (100% coverage baseline 4). The description adds value by mentioning resolution presets (480p to 1440p), implying the tool uses implicit context to determine the video to resize. However, it does not explain how to specify the preset or what the default behavior is, so it partly compensates for the lack of 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 'Resize Video — Change video resolution with quality presets (480p to 1440p)', specifying the verb (resize), resource (video), and scope (resolution with presets). It is clear enough to understand the core function, though it does not explain how the resolution preset is selected given no input parameters.
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 usage and pricing model but provides no guidance on when to use this tool over sibling resize tools (e.g., mio_video_resize_square, mio_video_resize_reels). It does not differentiate use cases or state prerequisites, leaving the agent without clear selection criteria.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_video_resize_reelsAInspect
Resize Video for Reels — Resize any video to Instagram Reels 9:16 vertical format (1080×1920). Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so description carries burden. It mentions browser processing and credit usage, but does not disclose details about audio handling, output format, or potential side effects beyond dimensions. Some transparency but gaps remain.
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?
Description is front-loaded with main purpose, but includes pricing/credit details that could be streamlined. Generally efficient, though slightly verbose for 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?
Provides dimensions and credit context, but lacks details on input video requirements, output characteristics (e.g., codec, quality), and return value. With no output schema, more completeness 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 has 0 parameters; schema coverage is 100% by default. Per guidelines, baseline is 4. Description does not need to add parameter info, but provides output dimensions which is relevant context.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it resizes video to Instagram Reels vertical 9:16 format (1080×1920). The verb 'Resize' and specific format distinguish it from other resize siblings like shorts, tiktok, square.
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 context on credit usage and pricing, but does not explicitly state when to use this tool vs alternatives. It implies usage for Reels format, but lacks direct comparison or when-not-to-use guidance.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_video_resize_shortsAInspect
Resize Video for Shorts — Resize any video to YouTube Shorts 9:16 vertical format (1080×1920). Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries full burden. It mentions browser processing and credit usage, but lacks details on destructive behavior, auth needs, or output handling.
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?
Description front-loads the core purpose, then provides credit/pricing details which are useful but slightly verbose. Could be trimmed without losing essentials.
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?
Covers purpose and credit context, but lacks return type info and input constraints (e.g., file size limits, supported formats). For a simple tool with no params, it's moderately 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?
Input schema has 0 parameters, so schema coverage is 100%. No parameter info needed beyond schema; baseline 4 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 resizes videos to YouTube Shorts 9:16 vertical format (1080×1920), distinguishing it from sibling resize tools for reels, square, TikTok, and generic resize.
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 YouTube Shorts but does not explicitly guide when to use this vs alternative resize tools, nor does it mention 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.
mio_video_resize_squareAInspect
Resize Video to Square — Resize any video to 1:1 square format (1080×1080) for Instagram and social media. Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description clearly explains that the tool processes in the browser, uses credits, and notes credit differences between workspaces. It also mentions limitations (Day Pass exclusion, credit pack nature). However, it does not disclose whether the original file is preserved or the output format (e.g., MP4, AVI).
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 front-loaded with the main purpose but includes extensive credit details that could be condensed. Each sentence adds value, though the pricing reference is not essential for tool invocation.
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 no parameters and no output schema, the description adequately covers the tool's outcome (square 1080x1080) and credit constraints. However, it does not specify how to provide the input video (e.g., file selection) or the output file format, leaving minor gaps.
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 zero parameters, so schema coverage is trivially 100%. The description adds no parameter details, which is acceptable. Baseline for zero parameters is 4. No additional parameter semantics needed.
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 starts with 'Resize Video to Square — Resize any video to 1:1 square format (1080×1080) for Instagram and social media.' It clearly specifies the verb (resize), resource (video), and target format (square), differentiating from similar tools like mio_video_resize and platform-specific resize 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 implies usage for square videos on social media but does not explicitly state when to prefer this tool over alternatives (e.g., mio_video_resize for custom sizes). No when-not-to-use or comparison with siblings is provided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_video_resize_tiktokAInspect
Resize Video for TikTok — Resize any video to TikTok 9:16 vertical format (1080×1920). Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Discloses it uses more credits per run and that it's a browser process, but does not explain output behavior, file limits, or if the operation is destructive, which is needed since no annotations exist.
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 overall, with purpose stated first. Includes important credit context, but some pricing details (Day Pass, credit pack) may be extraneous for tool invocation.
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?
Covers purpose and cost but lacks input file requirements (e.g., supported formats, size limits) and output details, leaving gaps for a complete invocation 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?
Input schema has zero parameters, so schema coverage is trivially 100%. The description adds credit usage context but no parameter meaning is needed. Baseline 4 applies as per instructions.
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?
Explicitly states it resizes video to TikTok 9:16 vertical format (1080×1920), matching the tool name and differentiating it from other resize tools like resize_reels and resize_shorts.
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?
Clearly specifies the tool is for TikTok format, guiding use cases. However, it does not explicitly exclude other scenarios or provide direct comparisons to siblings, missing some usage guidance.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_video_reverseAInspect
Reverse Video — Play video backwards with reversed audio. Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It discloses that processing occurs in the browser and that it uses more credits than other workspaces. However, it does not mention whether the operation is destructive, any required permissions, or the output format. The pricing/credit info adds some behavioral context but leaves gaps.
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 overly verbose, dedicating most of its length to pricing and workspace details that are tangential to the tool's operation. It could be shortened to one sentence about reversing video and audio, making it less efficient for an AI agent to parse quickly.
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 no parameters and no output schema, the description should explain input mechanism and output. It fails to mention how the video is provided (e.g., file selection from context) or what the result is (e.g., a reversed video file). The description is incomplete for an agent to understand the full workflow.
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 0 parameters, so schema coverage is effectively 100%. Per guidelines, baseline is 4. The description does not need to add parameter semantics, and it correctly avoids misleading parameter information.
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 reverses video with reversed audio, using specific verbs (Reverse, Play backwards) and resource (video). It distinguishes itself from siblings like mio_video_speed or mio_video_flip by explicitly mentioning reversal.
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 explicitly state when to use this tool vs alternatives. It focuses on credit and workspace information rather than use cases or exclusions. While it implies it's used for reverse playback, no guidance is given on scenarios or complementary tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_video_rotateBInspect
Rotate Video — Rotate videos 90, 180, or 270 degrees. Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description should fully disclose behavioral traits. It states 'processes in the browser' and mentions higher credit usage, but fails to mention whether the tool is destructive, how input is provided, or any side effects. The pricing details do not compensate for missing behavioral context.
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 first sentence is concise and front-loaded ('Rotate Video — Rotate videos 90, 180, or 270 degrees.'). However, the remaining sentences about credits, Day Pass, and pricing are tangential to the tool's purpose and could be shortened or moved to a separate note. They add length without aiding selection.
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 no parameters and no output schema, the description should explain how the tool receives input and what the output is. It fails to mention whether a video file must be pre-selected or if the tool works on the current document. Sibling tools like mio_video_rotate are not differentiated in terms of invocation 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?
The input schema has zero parameters, so the description does not need to explain parameter meaning. It adds value by specifying the rotation degrees (90, 180, 270) which are not in the schema. Baseline for 0 params is 4.
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 ('Rotate Video') and specifies the allowed degrees (90, 180, or 270). It uniquely identifies the tool's purpose among siblings like flip or crop, and the verb-resource pair is unambiguous.
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 like mio_video_flip or mio_video_crop. The description focuses on credit usage and pricing rather than usage context, leaving the agent without decision criteria.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_video_speedBInspect
Change Video Speed — Speed up or slow down videos with audio pitch preservation. Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description must bear the full behavioral disclosure burden. It mentions pitch preservation and in-browser processing, but lacks critical details such as input/output format, side effects, or permission requirements. The agent is left guessing about runtime behavior.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is moderately concise. It front-loads the main action but includes pricing and workspace details that could be trimmed or moved to a separate field. Still, no sentence is entirely superfluous.
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 lack of input and output schema, the description should provide more context on how to invoke the tool (e.g., does it require a selected file?) and what the output is. The current description covers credits but leaves operational details ambiguous.
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 zero parameters, making schema coverage 100% trivially. The description does not need to add parameter details, but it also does not explain that no parameters are required. Baseline of 4 is appropriate for zero-parameter tools.
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 'Change Video Speed' with specific verb and resource, and includes the important detail of audio pitch preservation. It distinguishes from the sibling 'mio_audio_speed' by focusing on video, though not explicitly contrasting.
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 credit and workspace usage context (e.g., uses more credits, not in Day Pass), but does not offer explicit guidance on when to use this tool versus other video tools like 'mio_video_trim' or 'mio_audio_speed'. No alternatives are mentioned.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_video_thumbnailBInspect
Extract Video Thumbnail — Extract a frame from video as a JPEG thumbnail image. Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided. The description discloses that the tool runs in the browser and uses credits, but fails to explain how input is provided (e.g., file selection via context) or how the output (JPEG thumbnail) is returned.
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 purpose is front-loaded, but the description includes extensive billing details that could be shortened or moved. The structure is adequate but not optimally 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?
With no output schema and no parameters, the description must explain the full workflow. It omits how users provide the video and what the output looks like beyond 'JPEG thumbnail', leaving significant gaps.
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 zero parameters, so no parameter documentation is needed. Baseline score of 4 applies as the description adds no confusion.
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 extracts a video frame as a JPEG thumbnail, with a specific verb ('Extract') and resource ('video thumbnail'). It distinguishes from sibling tools by focusing on thumbnail extraction.
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 explicit guidance on when to use this tool versus alternatives. It includes billing and credit information but does not explain scenarios or prerequisites for invoking the tool.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_video_to_gifBInspect
Video to GIF — Convert video clips to animated GIF. Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description mentions browser processing and credit usage, adding some behavioral context beyond the empty annotations. However, it does not disclose potential side effects, input requirements, or error scenarios, missing important transparency for a tool with no 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 relatively concise with four sentences, front-loading the purpose. Some pricing and workspace details could be considered extraneous but are not overly 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 no output schema, no annotations, and no parameters, the description should explain inputs, outputs, and constraints. It only covers the output format and pricing, missing input specification and limitations.
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 zero parameters, but the tool clearly requires a video input. The description fails to explain how the input is provided or any implicit parameters, thus not adding meaning beyond the schema.
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 'Convert video clips to animated GIF', providing a specific verb (convert) and resource (video to GIF). It distinguishes from siblings like mio_video_gif_to_mp4 which does the reverse.
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 vs alternatives. The name implies its purpose, but the description does not provide direct comparisons or usage context beyond credit consumption.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_video_to_mp3AInspect
Video to MP3 — Extract audio from video files. Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden. It discloses browser processing, higher credit cost, and workspace restrictions—valuable behavioral context beyond the core function. It does not detail side effects (e.g., deletion of original) but covers key cost and availability traits.
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 efficient, starting with a clear purpose and then adding relevant credit context. It does not waste words, though the credit info could be placed later. It remains concise and front-loaded.
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 no parameters and no output schema, the description explains output format (MP3) and credit usage. However, it omits supported input video formats, file size limits, and processing time expectations, leaving some gaps for a complete understanding.
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 zero parameters, so the description cannot add parameter details. However, it fails to explain how the video file is provided (e.g., upload, reference), which is a critical gap. Baseline for 0 params is 4, but the missing input method reduces clarity.
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 'Video to MP3 — Extract audio from video files,' specifying exact verb and resource. It distinguishes from similar conversion tools by focusing on audio extraction, and the name itself is descriptive.
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 explicitly states when to use (extract audio) and provides helpful credit/workspace context. However, it doesn't explicitly contrast with sibling tools like 'mio_video_mute' or 'mio_video_add_audio,' leaving some ambiguity about alternatives.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_video_trimBInspect
Trim Video — Cut video to specific start and end times. Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description notes that the tool 'processes in the browser' and mentions credit costs, but lacks details on behavioral traits like file handling, format support, or how start/end times are specified. Without annotations, the description partially covers transparency but leaves gaps.
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 includes a long pricing section that is tangentially related. The core function is front-loaded, but the extra content makes it less concise than ideal. Every sentence should earn 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 0 parameters, no output schema, and the tool's trimming nature, the description lacks essential context: input format, time specification format, output details, and limitations. The pricing info does not compensate for these gaps.
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 is empty (0 parameters). While the baseline is 4, the description does not explain how users provide start and end times. This omission is critical for a trimming tool, reducing the score to 2.
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 function: 'Trim Video — Cut video to specific start and end times.' It uses a specific verb ('Cut') and resource ('Video'), and the action is distinct from siblings like crop or compress.
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 focuses heavily on pricing and credit usage but does not provide guidelines on when to use this tool versus alternatives (e.g., mio_video_crop). No explicit 'when-to-use' or 'when-not-to-use' advice.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_video_wav_to_mp3AInspect
WAV to MP3 — Convert WAV audio to MP3 format. Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so the description carries the full burden. It discloses that processing happens in the browser, credits are consumed, and explains pricing structure, which is helpful for an agent to understand implications of usage.
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?
Description is verbose, including extraneous pricing marketing that could be moved to a separate help tool. The crucial functionality is only mentioned in the first sentence; the rest is tangential.
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?
While credit and pricing context is provided, the description lacks operational details such as how to provide the WAV file (e.g., via upload, URL). Without this, the agent may not know how to invoke the tool correctly. No output schema exists, so return behavior is also unclear.
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 has no parameters (schema description coverage 100% trivially). The description adds no parameter-specific meaning, but with no parameters, it does not need to. Baseline score 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?
Description clearly states the tool converts WAV audio to MP3 format. However, it does not distinguish from other audio converters like mio_video_aac_to_mp3, which perform similar tasks.
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?
Describes credit consumption and pricing, but does not provide guidance on when to use this tool versus alternatives like mio_video_mp3_cutter or other audio converters.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_video_webm_to_mp4AInspect
WebM to MP4 — Convert WebM videos to MP4 format. Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Since no annotations are provided, the description carries full behavioral disclosure. It mentions the tool runs in the browser, uses credits, and explains credit policies. However, it does not explicitly state that the operation is non-destructive or what happens to the original file, though conversion implies non-destructiveness.
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 slightly lengthy but each sentence serves a purpose: specifying the conversion, explaining credit usage, and clarifying pricing. It is well-structured and front-loaded with the core function.
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 no parameters and no output schema, the description provides a good overview of purpose, behavior, and pricing. It could include technical limitations (e.g., max file size, codec support), but overall it is fairly complete for a parameterless conversion tool.
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 zero parameters and is fully covered (100%). With no parameters, the description naturally adds no parameter information, which is appropriate. Baseline score of 4 for no parameters is justified.
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 explicitly states 'WebM to MP4 — Convert WebM videos to MP4 format', providing a specific verb and resource. The tool's name also mirrors this, and the description distinguishes it from siblings by naming the exact input and output formats.
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 gives context about credit usage and browser processing but does not explicitly state when to use this tool versus other video converters. It implies usage for WebM-to-MP4 conversion but lacks guidance on prerequisites or alternatives.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_video_wma_to_mp3CInspect
WMA to MP3 — Convert WMA audio to MP3 format. Video And Audio Studio run — processes in the browser but uses more credits per run than the Document / Image / Scanner workspaces. Welcome credits cover a limited number of runs. Day Pass does not include this workspace. All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, and the description only mentions 'processes in the browser' and credit usage. It does not disclose whether the operation is destructive, what happens to the original file, or any limitations beyond credits.
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 purpose is front-loaded in the first sentence, but the rest is mostly pricing details that are better placed elsewhere. The description could be more concise without losing essential information.
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 no parameters and no output schema, the description omits crucial invocation context, such as how to provide the WMA file. The heavy focus on credits does not compensate for missing operational 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?
The input schema has zero parameters, and schema coverage is 100%. The description adds no parameter information, which is acceptable given no parameters, but it fails to explain how the tool identifies the WMA source, leaving ambiguity.
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 'Convert WMA audio to MP3 format', which is a specific verb+resource. However, it does not differentiate from many sibling audio converter tools (e.g., mio_video_aac_to_mp3) beyond the format name.
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 includes extensive pricing and credit information but does not explain when to use this tool versus other converters, nor any prerequisites or alternatives. No guidance on how to provide the WMA file.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mio_xlsx_to_pdfBInspect
Excel to PDF — Convert Excel spreadsheets to PDF format. Runs in the browser. Covered by signup welcome credits and by the Day Pass (24-hour unlimited on this workspace group). All three credit-based workspaces unlock with the same one-time credit pack — there is no per-workspace subscription. See mioffice.ai/pricing for current plans.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description should disclose behavioral traits. It mentions 'Runs in the browser' but fails to describe file size limits, whether the conversion is destructive, how output is handled, or any rate limits. Pricing info is not a behavioral trait.
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 three sentences, front-loaded with the core function. The pricing details are somewhat extraneous but not overly 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?
For a simple conversion tool with no parameters, the description covers the basic function and pricing context but omits details like what happens after conversion (e.g., download link), input file handling, or error conditions.
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 zero parameters, so baseline is 4 per guidelines. The description adds basic purpose ('Convert Excel spreadsheets to PDF format') but nothing about parameters since none exist.
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 'Excel to PDF — Convert Excel spreadsheets to PDF format', which is a specific verb and resource. It distinguishes from sibling converters by naming the exact format transformation.
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 explicit guidance on when to use this tool versus alternative conversion tools (e.g., other format converters). It only discusses credits and pricing, not selection criteria or prerequisites.
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!