Log inSubmit server
Qodercli MCP logo

Qodercli MCP

Delegates MCP requests to local Qoder CLI agents with session resumption, model discovery, and configurable permissions.

InstallRepository
Full README Compare alternatives Embed widget Claim this listing

Install Qodercli MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "qodercli-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "qodercli-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 3 tools correctly (5d ago).

Overview

The qodercli-mcp MCP server exposes local Qoder CLI agents as MCP tools for clients such as Claude Code, Claude Desktop, and Cursor. It starts qodercli as a subprocess, passes prompts and options, and streams results over MCP stdio. Use it when an MCP client needs to delegate coding, review, or explanation tasks to a signed-in local Qoder installation. The server also provides runtime model discovery, resumable sessions, structured results, and sandbox controls.

Use cases

  • Delegate coding tasks to a local Qoder agent
  • Review project files for security issues
  • Resume multi-turn coding sessions
  • Discover models supported by the local CLI
  • Run read-only code explanations from an MCP client

Key features

  • Qoder CLI delegation through MCP
  • Resumable local sessions
  • Runtime model discovery
  • Structured execution output
  • Sandbox and permission controls
  • Timeout and proxy configuration

Tools3

What Qodercli MCP lets your agent do. Expand a tool for its parameters.

Verified live~811 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

4/4 checks healthy over the last 36d

What it can do

From the 3 tools this server returned when we ran it.

Read-only tools · 3
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceNot published
Package age60 days
Maintainers1

Observed 2026-10-18 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 10h ago via OSV.dev · qodercli-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads206Package downloads in the last 30 days.
Last commit2mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed3Callable tools this server registers over MCP.
Directory activity7 viewsConfig copies, upvotes, and views on AllMCPs.

How Qodercli MCP works

What qodercli-mcp MCP server does

The qodercli-mcp MCP server connects MCP clients to the locally installed Qoder CLI. Rather than implementing an agent itself, it acts as a wrapper around qodercli and exposes Qoder's local execution through MCP tools. This lets a connected client send coding tasks, questions, and review requests to a Qoder agent running on the same machine.

The main entry point is ask-qoder. It accepts a prompt and optional execution settings such as the working directory, model, reasoning effort, system prompt, output format, and timeout. A returned session ID can be used to continue a previous delegation. Results include human-readable content and structured execution details when JSON output is used.

How it works

The qodercli-mcp MCP server launches qodercli -p <prompt> as a child process and communicates with the MCP client over standard input and output. The wrapper parses qodercli JSON output and exposes fields including the session ID, error state, exit code, duration, credit usage, turn count, timeout state, and truncation state.

Its permission controls map MCP arguments to Qoder CLI behavior. The default dont_ask mode is read-only and silently denies permission-requiring actions. workspace-write allows file changes in the selected working directory, while danger-full-access permits full access including shell operations. Explicit permission_mode or approval_policy settings take precedence over sandbox.

Two read-only discovery tools complement task delegation. list-sessions returns local sessions that can be resumed, and list-models queries qodercli at runtime for currently supported model names.

Setup and configuration

Node.js 18 or newer and an installed, signed-in qodercli are required. The published package can be started with npx -y qodercli-mcp, so an MCP client can download it on first use. A source checkout can instead run the package's src/index.js with Node after npm install.

Add the server to the MCP client's configuration with a command and args entry. Set QODERCLI_PATH when the executable is not visible to the child process, which is especially relevant for installations managed by nvm. A local checkout may also need an absolute Node path. HTTP_PROXY and HTTPS_PROXY can be supplied when qodercli should use a proxy quota.

Tools and capabilities

  • ask-qoder: delegates a prompt and supports working directories, models, reasoning effort, prompts, session resume, permission settings, raw safe CLI arguments, output format, and timeouts.
  • list-sessions: lists local resumable qodercli sessions without arguments.
  • list-models: discovers available models at runtime and returns both text and structured model data.
  • Structured output: reports execution metadata through MCP structuredContent when JSON output is used.
  • Timeout handling: stops long-running processes and has a SIGKILL fallback.

Limitations and notes

The qodercli-mcp MCP server depends on the local Qoder CLI, its sign-in state, and the models available to that installation. It does not provide an independent model catalog. Non-JSON output formats reduce the structured metadata available from ask-qoder.

The default permission mode expects interactive confirmation and is not suitable for headless MCP calls. Read-only behavior is the default, but selecting write or full-access modes changes what the delegated agent can do in the configured working directory or system. Raw extra_args are restricted: reserved flags for permissions, prompts, models, output, resume, and working directory are rejected.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Qodercli MCP

qodercli-mcp is an MCP server that connects MCP clients to a locally installed, signed-in Qoder CLI. Its main tools are ask-qoder for delegated prompts, list-sessions for resumable sessions, and list-models for runtime model discovery. It runs qodercli as a subprocess and returns results over MCP stdio.

Install it by configuring an MCP client to run `npx -y qodercli-mcp`. You need Node.js 18 or newer and a signed-in `qodercli` installation. For development, clone the repository, run `npm install`, and start its `src/index.js` with Node.

Yes, qodercli-mcp can be configured for Cursor because it communicates over MCP stdio. Add an MCP server entry that runs `npx -y qodercli-mcp`, and set `QODERCLI_PATH` if Cursor cannot find the local qodercli executable.

Use the default `dont_ask` permission mode or set `sandbox` to `read-only`. The default mode silently denies permission-requiring tool calls, while `read-only` also passes disallowed-tool flags for file writes and shell commands.

Call `list-sessions` to find local session IDs, or read `session_id` from `ask-qoder` structured output, then pass that value as `resume_session_id` in a later `ask-qoder` call.

Related MCP servers

All in Coding Agents All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewQodercli MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/qodercli-mcp?style=directory)](https://allmcps.com/mcp/qodercli-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/qodercli-mcp"><img src="https://allmcps.com/api/badge/qodercli-mcp?style=directory" alt="Qodercli MCP on AllMCPs" /></a>