Operational MCP server for Hatchet — read-only by default, with opt-in run control over the Hatchet REST API.
Single tool (get_server_info) with clear naming and good description (156 chars). Input schema is empty object (valid for no-param tool). Description explains purpose, when to use, and explicitly states token is never included. However, output schema is not documented in visible code, only inferred from _build_server_info() implementation. Tool is read-only and self-describing, but lacks formal output schema documentation that LLMs need to plan downstream actions. No error handling guidance visible.
Return a snapshot of this hatchet-mcp instance — read_only mode, registered read/mutating tool counts, server_url_source (token vs override), hatchet-sdk version, Python version. Use when a tool error suggests the mode or config may be wrong. Never includes the token.
Output schema not documented. get_server_info returns a dict with fields like read_only, read_tool_count, mutating_tool_count, server_url_source, hatchet_sdk_version, python_version, but no formal schema is visible in tool registration or docstring. LLMs cannot plan downstream actions without knowing return structure.
No error handling guidance. Tool description does not explain failure modes (e.g., what if Hatchet SDK is not initialized?) or recovery steps. Agents cannot self-correct on errors.
STDIO transport only. Server is not remotely accessible and cannot be used by hosted MCP clients (e.g., Claude.ai, Cursor Cloud). Limits deployment scenarios significantly.
Tool composition incomplete. Server exposes 35 read tools + 21 mutating tools (56 total), but only get_server_info is visible in source. Remaining 55 tools are aggregated from modules (workflows, runs, tasks, etc.) but their definitions, schemas, and descriptions are not shown. Cannot fully evaluate definition quality across the tool catalog.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 52 | <=2025-11-25 | v2 |
Tool annotations present but incomplete. get_server_info carries readOnlyHint=True and destructiveHint=False (correct), but idempotentHint is not visible. Mutating tools are annotated with idempotentHint, but the annotation structure is not shown in source.