A multi-tool MCP server providing filesystem, Git, shell, and Arxiv paper fetching capabilities
Server provides 25 tools across filesystem, git, shell, and arxiv domains. Tool naming follows verb_noun convention (read_file, git_commit, shell_execute) which is good. However, descriptions vary significantly in quality and completeness. Many tools lack parameter descriptions entirely (e.g., shell_execute has no description for 'env' parameter). Output schemas are not documented anywhere in the codebase. Error handling is minimal, no recovery guidance, no categorization of error types. The arxiv tools are underdocumented. Overall, definitions are functional but fall short of production-grade quality expected for agent integration.
Fetch papers from Arxiv and generate RSS feed
Get cached Arxiv papers from the last fetch
Create a new directory at the specified path
Get a recursive tree view of a directory structure
Edit a file by specifying old text to find and new text to replace it with. Multiple edits can be applied in sequence.
Get detailed information about a file or directory
Stages files for commit
Output schemas not documented. No tool returns a documented schema showing what fields agents should expect. This forces LLMs to guess at response structure and breaks downstream tool chaining.
Parameter descriptions missing or incomplete. shell_execute lacks descriptions for 'env' and 'timeout' parameters. Many git tools have minimal parameter docs. Agents cannot infer parameter meaning from names alone.
No error handling guidance. Tools provide no recovery hints or error categorization. A failed git_commit returns raw error; agent has no guidance on retry vs user-fixable vs fatal.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 48 | 2026-07-28+ | v2 |
Switches to a different branch
Records changes to the repository
Creates a new branch
Shows differences between branches or commits
Shows changes that are staged for commit
Shows changes in the working directory that are not yet staged
Initializes a new Git repository
Shows commit history
Resets staged changes
Shows commit details and changes
Shows the working tree status
List the contents of a directory
Move or rename a file or directory
Read the complete contents of a file from the file system. Handles various text encodings and provides detailed error messages.
Read multiple files at once
Search for files matching a pattern in a directory
Execute a shell command
Create a new file or overwrite an existing file with the provided content
shell_execute is dangerously permissive. No input validation, no command allowlist, no timeout enforcement in code. Agents can execute arbitrary commands including destructive ones (rm -rf /). Requires permission gates and sanitization.
arxiv_get_cached has minimal documentation (40 chars). No description of what 'cached' means, when cache expires, or what structure is returned. Agents cannot determine when to call this vs arxiv_fetch_papers.