An MCP server for collecting and documenting code from directories
Four tools with mixed quality. All have descriptions and input schemas, but descriptions are generic and lack LLM-optimized guidance. Parameters mostly lack descriptions (critical gap). No output schemas documented. Error handling is minimal, no recovery guidance or actionable error messages. Tool names are verb-based but descriptions don't explain WHEN to use each tool or what distinguishes them. No tool annotations (readOnlyHint, destructiveHint). Schemas present but incomplete, many parameters undescribed.
Analyze code using OpenAI API (requires your API key). The analysis may take a few minutes. So, wait please.
Collect all code from a directory into a single markdown file
Create GitHub issues from analysis results. Requires GitHub token.
Install base MCP servers to the configuration
Parameter descriptions missing or minimal. 'owner', 'repo', 'issueNumbers' in create_github_issues lack descriptions. 'configPath' in install_base_servers has no description. LLMs cannot infer parameter meaning from names alone.
No output schemas documented. Tools return ToolResult with generic 'text' content, but LLMs need to know what fields/structure to expect for downstream chaining. E.g., does collect_code return file path, line count, token estimate?
No tool annotations (readOnlyHint, destructiveHint, idempotentHint). collect_code and install_base_servers are WRITE operations but lack destructiveHint. analyze_code is READ-only but lacks readOnlyHint. Agents cannot distinguish safe from risky tools.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 46 | 2026-07-28+ | v2 |
Descriptions lack WHEN/WHY guidance. 'Collect all code from a directory into a single markdown file' doesn't explain when to use this vs analyze_code, or what the output is used for. No dependency hints (e.g., 'Call this before analyze_code').
Error handling is silent. No recovery guidance in descriptions. If analyze_code fails (API key missing, rate limit), the error message is generic. No actionable next steps for the LLM.