MCP server for Beadhive CLI - provides tools for managing hives, toolchains, and workspace operations
Three tools with basic schemas and descriptions, but significant gaps in parameter documentation and output schema clarity. toolchain_list and toolchain_show have minimal descriptions (under 100 chars). toolchain_exec lacks parameter descriptions for 'argv' and 'capture'. No output schemas documented for any tool. Parameter types are present but descriptions are sparse or missing. No error handling guidance, no recovery paths, no actionable error messages defined. Naming is reasonable (verb_noun pattern) but descriptions do not explain WHEN to use each tool or what distinguishes them.
Invoke a toolchain entrypoint in the hive's main clone through the run() seam. Returns the CompletedProcess (caller passes the exit code through).
Declared toolchains + the effective template registry. Read-only.
Run the toolchain's entrypoints_cmd in the hive's main clone: the raw entrypoint listing + the template's suggestions (propose-only — never applied).
Output schemas not documented. No tool specifies what fields are returned or their types. LLMs cannot plan downstream calls or extract data reliably.
Parameter descriptions missing or incomplete. 'argv' in toolchain_exec has no description. 'capture' parameter lacks explanation of what it controls or when to use it.
Tool descriptions too brief and lack context. toolchain_list (79 chars) and toolchain_show (145 chars) do not explain WHEN to call each tool or how they differ. No guidance on prerequisites or dependencies.
No error handling or recovery guidance. Tools do not document what errors are possible, whether they are retryable, or what the LLM should do next.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 46 | 2025-06-18+ | v2 |
toolchain_exec is destructive (WRITE risk) but has no confirmation step, dry-run option, or warning in description. Agents could execute arbitrary commands without safeguards.