Server has three well-named tools with explicit input schemas and descriptions. Naming follows verb_noun convention (quiver_list_models, quiver_generate_svg, quiver_vectorize_image). Descriptions are present and moderately detailed. However, parameter descriptions are minimal, and output schemas are not explicitly documented. Error handling is functional but lacks recovery guidance for specific error conditions. The server implements proper secret injection (QUIVERAI_API_KEY via environment variable) and includes HTTP status code handling (401, 402, 429). Overall structure is sound but several parameters lack detailed guidance on constraints, ranges, and format expectations.

• Add explicit output schemas to tool definitions. Document the structure of returned summary object, including field types, whether usage is optional, and what fields it contains (inputTokens, outputTokens, totalTokens).
• Add maxItems: 4 constraint to 'references' array parameter in quiver_generate_svg schema. Enforce API-level validation and return a clear error if > 4 references are provided.
• Expand error messages with recovery guidance: for 429 rate limit, include a suggested retry delay (e.g., 'Rate limited. Wait 60 seconds before retrying.'); for 402 insufficient credits, include a command to check balance (if available via API) before user must manually top up.
• Document the exact format and constraints for 'instructions' parameter. E.g., 'Style guidance as a plain-text description (max 500 chars). Examples: "minimalist line art", "detailed watercolor", "geometric shapes". Avoid requesting conflicting styles.'
• For 'auto_crop' parameter, add guidance on when to use it: 'Set to true if the image has a busy background; crops to the dominant subject. Set to false for full-image preservation.' Include an example of the visual difference.
• Document what '<auto>' file naming expands to in the default output_path. E.g., 'Defaults to public/assets/svg_<timestamp>_<random>.svg for uniqueness.' This clarifies idempotency behavior.
• Add a tool annotation (destructiveHint: true) to quiver_generate_svg and quiver_vectorize_image since they write files to disk. This signals to the agent that repeated calls with the same prompt may overwrite previous outputs.