Official MCP SDK transport and helper server for just-progress-bar-skill catalog, generation, recipes, tokens, and accessibility audit.
10 tools with consistent verb-noun naming (list_, get_, generate_, validate_, audit_, create_, suggest_). All have descriptions (avg 95 chars, within 10-1024 range). Input schemas present with type definitions and parameter descriptions. However, output schemas are not documented in the visible code, critical for LLM planning. No error handling guidance visible. Parameters lack constraints (enums, ranges, format specs) that would prevent hallucinated values. Tool descriptions are functional but generic; they lack WHEN-to-use context and dependency hints. No evidence of pagination support despite tools returning lists (list_progress_bars, create_gallery_demo). Risk annotations present but incomplete, no confirmation patterns for generation tools that produce code artifacts.
Check source for progress semantics, label, determinate value rules, reduced motion, and color-only status risk.
Create a compact preview payload with metadata, React source, and HTML/CSS source.
Generate React or HTML/CSS source by catalog ID or natural-language prompt.
Generate progress bar source from a recipe JSON object.
Return default just-progress-bar CSS design token names.
Return a single progress bar catalog item by ID.
Return React or standalone HTML/CSS source for a catalog item.
Output schemas not documented. LLMs cannot plan downstream calls or extract required fields (e.g., does generate_progress_bar return source code, metadata, or both?). Critical for tool chaining.
Parameter constraints missing. 'target' enum is declared but 'value' (0-100), 'max', 'status' enum, and 'theme' lack format specs, ranges, or allowed values. LLMs will hallucinate invalid inputs.
No error handling guidance. Tools return READ_ONLY risk but no recovery hints. If validation fails or generation errors, LLM has no guidance on retry strategy or alternative approaches.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 58 | 2026-07-28+ | v2 |
List catalog entries, optionally filtered by category, tag, or query.
Map a user request to the best catalog ID.
Validate a recipe JSON object before generation.
Descriptions lack WHEN-to-use context. 'Generate React or HTML/CSS source by catalog ID or natural-language prompt' does not explain when to use generate_progress_bar vs suggest_progress_bar_by_prompt vs get_progress_bar_source. LLMs will guess wrong.
list_progress_bars lacks pagination. No limit, offset, page_size, or next_cursor parameters visible. Returning unbounded lists risks context window exhaustion.