claude-code-mcp

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden for behavioral disclosure. It does reveal some behavioral traits: it mentions timeout handling strategies, the ability to run 'any CLI cmd', and that it's 'faster than your native edit features'. However, it lacks critical information about permissions required, rate limits, whether operations are reversible/destructive, authentication needs, or error handling patterns. The description mentions file deletion capabilities but doesn't explicitly warn about destructive operations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is excessively long (over 500 words) with redundant information and promotional language. While it starts with a clear purpose statement, it then includes extensive bullet lists, examples, and tips that could be more efficiently organized. Sentences like 'Claude can do much more, just ask it!' and 'it might surprise you!' don't add functional value. The structure with multiple bullet levels and emojis is visually cluttered rather than information-dense.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool with 2 parameters, no annotations, and no output schema, the description provides substantial context about capabilities and usage patterns. However, it's incomplete regarding parameter documentation, error handling, and operational constraints. The extensive examples and tips compensate somewhat, but critical information about what the tool returns, how errors manifest, and security/permission requirements is missing. The description feels more like marketing material than complete technical documentation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 0% schema description coverage and 2 parameters (prompt and workFolder), the description provides minimal parameter guidance. It mentions 'Use `workFolder` for contextual execution' and provides one example about relative paths when workFolder is set, but doesn't explain the prompt parameter's expected format, constraints, or structure. Given the low schema coverage, the description should compensate more by explaining both parameters' purposes and usage patterns beyond the single workFolder mention.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states this is a 'versatile multi-modal assistant for code, file, Git, and terminal operations via Claude CLI' with specific examples across multiple domains. It provides a comprehensive overview of capabilities including file operations, code generation/analysis, Git workflows, terminal commands, web search, and GitHub integration. However, since there are no sibling tools mentioned, it doesn't need to differentiate from alternatives.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides clear usage context through the 'Prompt tips' section with 8 specific guidelines, including when to use relative paths, how to handle multi-line text, timeout strategies, and when to seek analysis vs. execution. It explicitly states 'No need for niceties, this is a tool to get things done' and offers guidance for complex multi-step workflows. However, it doesn't explicitly state when NOT to use this tool or compare it to alternatives (though none are mentioned).

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.