MCP server for exploring GitHub repositories, providing tools to search code, list files, and read file contents with support for prompts and resources
Two tools with minimal descriptions and incomplete schemas. search-code has a 54-char description (below baseline 194 chars); list-files has 44 chars. Both schemas lack required field documentation and parameter constraints. No error handling guidance, no output schema documentation, no pagination support despite list-files returning potentially large results. Tool names follow verb_noun pattern (positive), but parameter descriptions are sparse. No tool annotations (readOnlyHint present in metadata but not in schema). Schemas are visible and properly typed, but descriptions fall well below production baseline.
List files in a repository directory
Search for code patterns in the repository
Descriptions critically short (44-54 chars vs baseline 194 chars). search-code lacks context on when to use it vs other discovery tools; list-files omits what structure is returned and pagination behavior.
No output schema documented. LLMs cannot plan downstream calls or extract required fields (e.g., file paths, line numbers, match context). Violates pattern:response-shaper.
list-files lacks pagination support (no limit, offset, or cursor params). Returning entire directory trees will blow context windows. Violates pattern:paginated-result.
Parameter 'query' in search-code has no constraints (length, format, regex). Parameter 'directory' in list-files has default but no validation rules. Violates pattern:constrained-input.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 47 | 2026-07-28+ | v2 |
No error handling guidance. If search-code finds no matches or list-files hits a permission error, LLM receives no recovery hints. Violates pattern:recovery-guide.