Two tools with reasonable descriptions and partial schemas. run_pipeline has a complex, well-documented input schema covering multiple invocation modes (fresh run, resume, polling). list_pipelines is minimal but appropriate for a discovery tool. However, output schemas are entirely undocumented, LLMs cannot plan downstream actions without knowing what fields to expect. Parameter descriptions are present but lack actionable constraints (e.g., no guidance on valid pipeline names, session ID format, or expected response structure). Error handling is implicit in the description ('running', 'need_input', 'done', 'error' states) but not formalized as structured error responses. No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite run_pipeline being a WRITE operation.

• Document the output schema for run_pipeline: specify the structure of job state responses (e.g., {status: 'running'|'need_input'|'done'|'error', session_id: string, questions?: array, deliverables?: array, error_message?: string}).
• Add destructiveHint: true to run_pipeline and document idempotency: 'Resuming a paused session with the same response is safe to retry; fresh runs with identical inputs may produce different results.'
• Convert pipeline_name to an enum or add a dependency hint: 'Call list_pipelines() first to discover available pipeline names.' Provide format constraints for session_id (e.g., UUID format).
• Formalize error responses with actionable recovery guidance. E.g., 'If status is "error", error_message will explain the failure. Retryable errors (timeout, transient service failure) can be retried; fatal errors (invalid pipeline, permission denied) require user intervention.'
• Expand list_pipelines description to 100 - 150 chars: explain that it returns pipeline names, descriptions, and input/output schemas; recommend calling it before run_pipeline to validate pipeline names and understand expected inputs.

Inferred effective spec: 2026-07-28+.

• Relies on Stateful initialize / Mcp-Session-Id (removed; protocol is stateless) - make each request self-contained