A workflow framework MCP server to guide agents through structured workflows
Server has 5 tools with basic schemas and descriptions, but significant gaps limit production readiness. All tools have descriptions (10-50 chars, below the 50-200 char baseline for LLM optimization), and input schemas are present but minimal. Parameters lack detailed descriptions explaining constraints, formats, or dependencies. No output schemas documented. Error handling is absent, tools return generic success messages without recovery guidance. Tool names follow verb_noun convention (list_, start_, complete_, get_) but descriptions are too terse to guide LLM selection. No parameter validation rules, enums, or type constraints visible beyond basic JSON Schema types.
Mark current step as complete and get the next step
Get the current state of a workflow session
Get details of a specific workflow
Lists available workflow frameworks
Begin a new workflow session
Descriptions are too short (10-50 chars vs. 50-200 char baseline). 'Lists available workflow frameworks' and 'Begin a new workflow session' lack context for LLM selection. No explanation of WHEN to use each tool or what distinguishes them.
Parameter descriptions missing or minimal. 'workflow_id' and 'session_id' lack format/constraint details. 'result' in complete_step has no guidance on expected structure or when it's required vs. optional.
No output schemas documented. LLMs cannot infer what fields list_workflows, get_workflow, or get_session return. Breaks tool chaining, if start_workflow returns a session_id, that must be documented so LLMs know to pass it to complete_step.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 46 | <=2025-11-25 | v2 |
No error handling or recovery guidance. Tools return placeholder strings ('Tool executed with...') without indicating success/failure, what went wrong, or what the LLM should do next. Violates recovery-guide pattern.
No parameter validation or constraints. 'workflow_id' and 'session_id' accept any string; no enum, pattern, or length limits. LLMs will pass invalid IDs without guidance on valid formats.