Agent Workspace MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| LOG_LEVEL | No | Python logging level (DEBUG, INFO, etc.). | INFO |
| COMMAND_TIMEOUT | No | Default seconds before run_bash kills a process. | 60 |
| MAX_SEARCH_RESULTS | No | Maximum results returned by search_workspace. | 50 |
| MAX_READ_SIZE_BYTES | No | Maximum file size for read_file (1MB). | 1048576 |
| MAX_WRITE_SIZE_BYTES | No | Maximum file size for write_file (5MB). | 5242880 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| extensions | {
"io.modelcontextprotocol/ui": {}
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| read_fileA | Read a text file. Text only, max 1MB, returns first 100 lines. Use offset/limit for segments or run_bash('grep/head/tail') for large files. |
| write_fileA | Create or overwrite a file. Creates parent dirs. For partial edits use search_and_replace. Validates .py/.json/.toml/.yaml syntax before writing. |
| list_directoryA | List directory contents. Returns [F]/[D] prefixed entries. Excludes .git, .venv, pycache. |
| search_workspaceA | Find files by glob pattern. Returns up to 50 paths. For content search use run_bash with grep. |
| run_bashA | Run a shell command in /workspace. Returns [Exit code: N] + merged stdout/stderr, truncated at 50KB. Tools: curl, git, jq, patch, tree, fd, rg, zip, tar and standard coreutils. Supports pipes, redirects, &&, ||. Python/packages (uv only — no python/pip): uv run script.py Run scripts (auto-installs deps from imports) uv add/remove Manage project dependencies uv init Scaffold new project with pyproject.toml uvx Run CLI tools without install (e.g. uvx ruff check .) |
| search_and_replaceA | Primary file editing tool — prefer over patch. Replaces substrings with fuzzy whitespace fallback. Returns unified diff. Validates .py/.json/.toml/.yaml syntax. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 6 tools
Each tool has a clearly distinct purpose: read_file for reading, write_file for overwriting, list_directory for listing, search_workspace for locating files by pattern, run_bash for arbitrary shell commands, and search_and_replace for partial edits. No ambiguity.
All tool names follow a consistent snake_case verb_noun pattern (e.g., read_file, write_file, list_directory). The only exception is search_and_replace, which combines two verbs, but it still aligns with the overall style.
With 6 tools, the set is well-scoped for an agent workspace. It covers essential operations (file read/write, directory listing, file search, shell execution, and text editing) without unnecessary clutter.
The tool set covers most common operations, but lacks dedicated tools for file deletion, renaming, or appending. However, these gaps can be addressed via run_bash, so only minor incompleteness is present.