MCP server for generating quotations from context using the QUILL API
Single tool 'generation' has a basic description but critically lacks input parameter documentation. The input schema shows only a 'context' parameter with a generic string type and minimal description ('The context from which to generate a quotation'). No output schema is documented. The tool description (67 chars) is below the 194-char baseline for production tools. Error handling is absent, the code catches RequestException but returns raw response_data without guidance on failure modes. No parameter constraints, validation, or recovery hints. The implementation calls an external API (47.98.193.198:80) without timeout, retry logic, or structured error responses.
This tool is used to get the generation of a quotation from a context.
No output schema documented. Tool returns raw API response (response_data) without specifying structure, fields, or types. LLM cannot plan downstream operations or extract specific fields.
Parameter 'context' lacks actionable description. Current text ('The context from which to generate a quotation') is generic and does not specify format, length limits, or expected content structure. LLM cannot validate input quality.
Error handling is non-existent. Code catches RequestException but returns raw response_data without error classification, recovery guidance, or actionable messages. LLM receives no signal on failure modes (timeout, invalid context, API down).
External API call lacks timeout, retry logic, and circuit breaker. Hardcoded IP (47.98.193.198:80) with no fallback. Agent can hang indefinitely if service is slow or unreachable.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 36 | 2026-07-28+ | v2 |
Tool description (67 chars) is below production baseline (194 chars). Does not explain WHEN to use this tool, what 'quotation generation' means, or how output differs from input. LLM cannot distinguish this from similar text-processing tools.