Classify text into categories with confidence scores, readability analysis, and content type detection.
Single tool with clear naming (text_classify_content) and comprehensive description (194 chars). Input schema present with proper types and descriptions. However, output schema is completely undocumented, LLMs cannot plan downstream calls or extract structured data. No error handling guidance, no parameter constraints (categories array lacks item type), and no documentation of response fields (confidence scores, language, readability level, content type). Tool description is strong but schema completeness is weak.
Use this when you need to categorize text into topic categories (tech, finance, health, sports, politics, entertainment, science, business). Returns top 3 categories with confidence scores, detected language, Flesch-Kincaid readability level, and content type (article/review/tutorial/news). Ideal for content organization, tagging, and routing. Do NOT use for sentiment — use text_analyze_sentiment. Do NOT use for summarization — use ai_summarize_text.
Output schema completely undocumented. Tool description mentions returning 'top 3 categories with confidence scores, detected language, Flesch-Kincaid readability level, and content type' but no structured schema is provided. LLMs cannot plan downstream calls or validate response structure.
Input parameter 'categories' lacks type definition for array items. Schema shows 'type: array' but no 'items' property specifying string type or constraints. LLMs cannot validate what values are acceptable.
No error handling guidance. Tool description does not explain what happens on invalid input (text < 50 chars), unsupported categories, or API failures. LLMs have no recovery path.
No pagination or result limits documented. If classification returns multiple results, no guidance on how many are returned or how to paginate. Risks context window exhaustion.
Inferred effective spec: 2025-06-18+.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 63 | 2025-06-18+ | v2 |
Tool description includes negative guidance ('Do NOT use for sentiment', 'Do NOT use for summarization') but no positive guidance on when to use it. Descriptions should state WHEN to call the tool, not just when not to.