A Model Context Protocol server for managing style templates across multiple categories (text, card, structure)
StylePilot has 6 tools with complete input schemas and descriptions. All tools follow verb_noun naming (get_, search_, create_, update_, delete_, list_). Descriptions are present but brief (10-50 chars), below the 50-200 char LLM-optimized baseline. Parameter descriptions are minimal, most lack guidance on format, constraints, or dependencies. Output schemas are not documented. Error handling is absent, no recovery guidance, no categorization of retryable vs fatal errors. The server lacks idempotency guarantees for write operations and does not validate inputs before processing.
Create a new style template
Delete a style template
Get a specific style template by category and ID
List available styles in a category or all categories
Search for styles by keywords or description
Update an existing style template
Output schemas not documented. LLMs cannot infer what fields to expect from tool responses, forcing them to guess at downstream field names and risk broken tool chains.
Descriptions are too brief (10-50 chars vs 50-200 char baseline). 'Get a specific style template by category and ID' lacks context on when to use this vs search_style, what the template object contains, or what happens on error.
Parameter descriptions are minimal or missing guidance. 'Category of the style (text, card, structure)' repeats the enum but does not explain when to use each. 'The style template definition' for the template object lacks schema guidance.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 48 | 2026-07-28+ | v2 |
No error handling or recovery guidance. If a style is not found, the code throws a generic error with no suggestion of alternatives or next steps. LLMs cannot self-correct.
Write operations (create_style, update_style, delete_style) lack idempotency guarantees and confirmation steps. Agents retrying on ambiguous failures risk duplicate records or unintended deletions.