Agent Godmode

Name: Agent Godmode
Author: mdvohra

by mdvohracommunityv0.1.9

MCP server providing workspace-scoped file and command tools for building agents, including read_file, write_file, edit_file, list_files, and run_command. It runs against a local workspace root and supports both MCP clients and in-process Python use; the LLM/API key stays in the host app.

From the registry: Sandboxed workspace MCP: file ops, argv-only run_command, list_files; BYO LLM prompts.

GitHub Repository

Install & configure

Prerequisites

required
Install Python package
Install the MCP server package from PyPI.
```
$ pip install agent-godmode
```

Install in your client

Paste into the AI you're chatting with — it will figure out the rest

Please install the `agent-godmode` MCP server into my current AI client (that's you).

Required prerequisites (do these first if not already done):
- **Install Python package** — Install the MCP server package from PyPI. Run: `pip install agent-godmode`

Canonical MCP server config (stdio transport):
- command: `agent-godmode`
- args: []
- required environment variables:
  - `AGENT_GODMODE_ROOT`: Absolute workspace root. Required unless you pass --root as a CLI argument. (example: `<your-workspace-path>`)
- optional environment variables:
  - `AGENT_GODMODE_MAX_READ_BYTES`: Maximum bytes returned per read_file call. (example: `<max-read-bytes>`)
  - `AGENT_GODMODE_COMMAND_TIMEOUT`: Subprocess timeout in seconds for run_command. (example: `<timeout-seconds>`)
  - `AGENT_GODMODE_MAX_COMMAND_OUTPUT_BYTES`: Maximum combined stdout/stderr bytes retained from run_command. (example: `<max-output-bytes>`)
  - `AGENT_GODMODE_LIST_MAX_ENTRIES`: Maximum number of entries returned by list_files. (example: `<max-list-entries>`)
  - `AGENT_GODMODE_ALLOWED_COMMANDS`: Comma-separated basenames allowed as argv[0] for run_command. If unset, all commands are allowed under the sandbox. (example: `<command1,command2>`)

Note: The server runs over stdio. You can provide the workspace root either via AGENT_GODMODE_ROOT or by using CLI args ["--root", "<your-workspace-path>"] instead of the env var.

Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.

Note: The server runs over stdio. You can provide the workspace root either via AGENT_GODMODE_ROOT or by using CLI args ["--root", "<your-workspace-path>"] instead of the env var.

Tools (5)

read_file

Read a UTF-8 text file with optional line range and byte cap.

write_file

Create, overwrite, or append UTF-8 text files and create parent directories.

edit_file

Perform search-and-replace edits in an existing UTF-8 file, with exact-match behavior when replace_all is false.

list_files

List directory entries with optional recursion, globbing, depth cap, and dotfile control.

run_command

Run a subprocess from an argv list without a shell, optionally under a workspace-relative cwd.

Environment variables

AGENT_GODMODE_ROOTrequiredAbsolute workspace root, required unless --root is passed.

Packages

agent-godmode

pypiv0.1.9transport: stdio

Details

Language: Python
Released: Apr 27, 2026
Last commit: May 20, 2026
Registry name: io.github.mdvohra/agent-godmode

Related Servers

Mcp Server Commands

An MCP server to run arbitrary commands

38.6k

Mcp Server Filesystem

MCP server for filesystem access

29.4k

Desktop Commander

MCP server for terminal commands, file operations, and process management

9.3k