Converts books (EPUB, PDF, TXT) to audiobooks with optional translation and voice customization
Single tool 'epub-audiobook' has a complete input schema with 7 parameters, all typed and described. However, the tool name violates verb-noun convention (should be 'convert_epub_to_audiobook' or similar), and the description, while present (89 chars), lacks critical context about prerequisites, when to use it, and what the output structure is. No output schema is documented. The tool accepts base64-encoded file content as a parameter, which is unusual and not self-documenting. Parameter descriptions are minimal (e.g., 'Narration language name (default: English)' lacks format/constraint guidance). No error handling guidance is provided.
Convert an EPUB, PDF, or TXT book file to an audiobook with optional translation and voice customization
Tool name does not follow verb_noun convention. 'epub-audiobook' is a noun phrase; should be 'convert_epub_to_audiobook' or 'generate_audiobook_from_epub' to signal the action clearly to LLMs.
No output schema documented. LLMs cannot plan downstream steps or extract results. The examples show polling a URL and receiving a resultUrl, but this structure is not declared in the tool definition.
Parameter descriptions lack format constraints and validation rules. E.g., 'language' and 'voice' accept free-form strings with no enum or pattern; 'speed' has no min/max bounds; 'selectedChapterIndices' format is vague ('comma-separated' in description but array in schema).
Tool description (89 chars) is too brief and lacks context. Does not explain WHEN to use it, what prerequisites exist (e.g., file size limits, supported formats), or what the user should expect (async job with polling). Baseline for A+ tools is 194 chars.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 38 | 2026-07-28+ | v2 |
No error handling guidance. Examples show L402 payment flow and polling states (COMPLETED, FAILED), but the tool definition does not document these states, retry logic, or how to recover from failures.