MCP server for searching and fetching animation bits from the hyperbits catalog for HyperFrames video compositions
Two tools with clear, action-verb names (find_hyperbits, fetch_hyperbit) and reasonable descriptions (95 - 120 chars). Input schemas are present with proper JSON Schema structure, types, and descriptions for all parameters. However, output schemas are not documented in the source code, critical for LLM planning. Parameters lack constraints (e.g., limit has no maximum; tags array has no item count bounds). Error handling and recovery guidance are absent. No tool annotations visible. Descriptions are adequate but could be more prescriptive about when to use each tool and what to do with results.
Fetch one live hyperbit by id or exact display name, including metadata, HTML source, helpers, and the data-composition-src embed snippet.
Search the live hyperbits catalog by visual goal, tags, and result limit.
Output schemas not documented. LLMs cannot plan downstream operations or extract required fields without knowing what find_hyperbits and fetch_hyperbit return.
Parameter constraints missing. 'limit' has no maximum; 'tags' array has no length bounds. Unbounded parameters invite LLMs to pass absurd values (limit=999999) that break APIs or cause timeouts.
No error handling or recovery guidance. If a query returns no results or an ID is invalid, the tool provides no actionable next steps for the LLM.
Descriptions lack dependency hints. 'fetch_hyperbit' accepts 'id or exact display name' but does not guide LLMs to call find_hyperbits first if they only have a partial name.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 61 | 2025-06-18+ | v2 |
No tool annotations (readOnlyHint, destructiveHint, idempotentHint) visible in source. Both tools are read-only and idempotent, these should be declared for agent safety.