# qodercli MCP server

> Delegates coding tasks to local Qoder agents from any MCP client like Claude Code or Cursor.

- Repository: https://github.com/cantbeblank96/qodercli-mcp
- Page: https://hostedmcp.org/servers/cantbeblank96/qodercli-mcp
- Transport: stdio
- Stars: 0
- License: MIT
- Latest version: 0.4.3

## Install

### Claude Code

```sh
claude mcp add qodercli-mcp -- npx -y qodercli-mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "qodercli-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "qodercli-mcp"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "qodercli-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "qodercli-mcp"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"qodercli-mcp","type":"stdio","command":"npx","args":["-y","qodercli-mcp"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "qodercli-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "qodercli-mcp"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add qodercli-mcp -- npx -y qodercli-mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.qodercli-mcp]
command = "npx"
args = ["-y", "qodercli-mcp"]
```

### Gemini CLI

```sh
gemini mcp add -s user qodercli-mcp npx -- -y qodercli-mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "qodercli-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "qodercli-mcp"
      ]
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `HTTPS_PROXY` | no | no | HTTPS proxy injected into qodercli subprocesses (optional) |
| `HTTP_PROXY` | no | no | HTTP proxy injected into qodercli subprocesses (optional) |
| `QODERCLI_DEFAULT_PERMISSION_MODE` | no | no | Default permission mode when callers omit permission params: dont_ask (default, read-only) \| accept_edits \| bypass_permissions \| auto \| default |
| `QODERCLI_PATH` | no | no | Absolute path to the qodercli binary (defaults to `qodercli` on PATH) |

## Tools (21)

- `prompt`
- `cwd`
- `model`
- `reasoning_effort`
- `permission_mode`
- `approval_policy`
- `sandbox`
- `system_prompt`
- `append_system_prompt`
- `resume_session_id`
- `output_format`
- `extra_args`
- `timeout_ms`
- `read-only`
- `workspace-write`
- `danger-full-access`
- `dont_ask`
- `accept_edits`
- `bypass_permissions`
- `auto`
- `default`

## FAQ

### What tools does this MCP server expose?

It exposes three tools: ask-qoder for delegating tasks, list-sessions for discovering resumable sessions, and list-models for runtime model discovery.

### How can I use a proxy with qodercli-mcp?

You can use your Qoder CLI proxy quota by adding HTTP_PROXY and/or HTTPS_PROXY to the server's environment variables.

### Can I resume a previous coding session?

Yes, you can use the session_id returned from a previous task as the resume_session_id in a new call to allow multi-turn delegation.

### Is there a way to run this without a build step?

Yes, it is a plain ESM JavaScript package that can be run via npx with zero build steps.
