OS Agent MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MCP_ALLOWED_ROOTS | No | The root directories allowed for the server. Set to the current project directory to limit access. |
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": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_filesA | Find files below a directory using a glob such as '.py' or 'README'. |
| list_directoryA | List immediate children with their type and size. |
| read_text_fileB | Read a UTF-8 text file, capped to keep tool responses manageable. |
| write_text_fileB | Create a UTF-8 text file, refusing to overwrite unless asked explicitly. |
| move_pathB | Move a file or directory within the configured local roots. |
| delete_pathA | Delete a file, or an empty directory unless recursive=true is provided. |
| list_open_terminalsA | List likely terminal processes currently running on this machine. |
| launch_terminalB | Open a new terminal in a directory and optionally run one command. |
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 8 tools
Each tool targets a distinct operation: file search, directory listing, read/write, move/delete, and terminal listing/launch. There is no meaningful overlap, and the search/list distinction is clear.
All tool names follow a consistent verb_noun snake_case pattern, such as search_files, read_text_file, and launch_terminal. The style is uniform and predictable.
Eight tools is well-scoped for an OS agent covering filesystem operations and terminal launching. Each tool earns its place without redundancy or bloat.
The filesystem surface covers search, list, read, write, move, and delete well, and terminal launch is covered. Minor gaps exist such as no explicit directory creation, copy operation, or terminal process termination, but core workflows are supported.