agent-godmode MCP server

agent-godmode

<!-- mcp-name: io.github.mdvohra/agent-godmode -->

Workspace-scoped MCP tools for building Cursor-style agents: readfile, writefile, editfile, runcommand, listfiles. Includes strict, versioned system prompts (SYSTEMPROMPTV1) and OpenAI-style tool definitions** so your app can wire any LLM with one import.

The LLM and API keys stay in your app. This package provides tool execution, sandboxing, and prompts—not a hosted model.

OpenAI + in-process tools: the Tier B section below is self-contained—copy the Python into a script, module, or REPL; no separate artifact is required.

Install

pip install agent-godmode

Editable / dev:

pip install -e ".[dev]"

Migrating from mcp-agent-tools: uninstall the old package, install agent-godmode, change Python imports from mcpagenttools to agentgodmode, the CLI from mcp-agent-tools to agent-godmode, and environment variables from MCPAGENTTOOLS to AGENTGODMODE (for example AGENTGODMODEROOT).

Tools

All tools are scoped to a single workspace root. Paths are relative to that root (or absolute only if they resolve under it). The same operations are available over MCP (the agent-godmode server) and in-process via AgentWorkspace / WorkspaceTools.

For LLM integrations, tool shapes and descriptions are centralized in OPENAITOOLDEFINITIONS and TOOLDESCRIPTIONS; agent behavior is guided by SYSTEMPROMPTV1**.

Tier A — Cursor (or any MCP client)

1. Pick a workspace directory (only paths under this root are allowed).

2. Add a server entry (stdio). Example for a global MCP config (paths use forward slashes on Windows):

{
  "mcpServers": {
    "agent-godmode": {
      "command": "agent-godmode",
      "args": [],
      "env": {
        "AGENT_GODMODE_ROOT": "D:/your/project"
      }
    }
  }
}

Or with an explicit CLI root (overrides env for that process):

{
  "mcpServers": {
    "agent-godmode": {
      "command": "agent-godmode",
      "args": ["--root", "D:/your/project"]
    }
  }
}

3. Paste SYSTEMPROMPTV1 (from agent_godmode.prompts or below) into your host’s system prompt if the client does not load server instructions automatically.

Environment variables

Shortened. The full README is on GitHub.