Command-line interface for Citadel platform with MCP (Model Context Protocol) support for tools, resources, and prompts
citadel-cli exposes 4 MCP tools with minimal definition quality. Tool names lack action verbs (mcp/tools, mcp/call, mcp/resources, mcp/prompts are namespace-prefixed but not verb-first). Descriptions are present but generic (10-50 chars, below the 50-200 char LLM-optimized baseline). Only mcp/call has a visible input schema with two parameters (tool_name, arguments), but both lack detailed descriptions. mcp/tools, mcp/resources, and mcp/prompts have no visible input schemas in the provided code. No output schemas documented. Error handling is marked present but not visible in the code sample. No tool annotations (readOnlyHint/destructiveHint) despite clear risk classifications (READ_ONLY vs WRITE). Parameter descriptions are minimal or absent.
Call an MCP tool with specified arguments
List available MCP prompts from a connected MCP server
List available MCP resources from a connected MCP server
List available MCP tools from a connected MCP server
No input schemas visible for 3 of 4 tools (mcp/tools, mcp/resources, mcp/prompts).
Tool names do not start with action verbs. 'mcp/call' is acceptable but 'mcp/tools', 'mcp/resources', 'mcp/prompts' are nouns, not verbs. Should be 'list_mcp_tools', 'list_mcp_resources', 'list_mcp_prompts'.
Descriptions are 10-50 characters, well below the 50-200 char LLM-optimized baseline. E.g. 'List available MCP tools from a connected MCP server' (52 chars) lacks context on WHEN to call it or what it returns.
mcp/call parameters 'tool_name' and 'arguments' lack detailed descriptions. 'arguments' is typed as object but no guidance on structure, required fields, or format.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 29 | <=2025-11-25 | v2 |
No tool annotations (readOnlyHint, destructiveHint) despite explicit risk classifications. mcp/call is WRITE but not marked destructiveHint; mcp/tools, mcp/resources, mcp/prompts are READ_ONLY but not marked readOnlyHint.