opencode-mcp MCP Server

An MCP (Model Context Protocol) server that lets any MCP host — Claude Code, Codex, Cursor, etc. — drive an OpenCode instance and delegate work to its subagents — so orchestrator models like Opus or…

Local serverstdioMIT

What is the opencode-mcp Server?

opencode-mcp is an MCP project maintained in the alejandro-technology/opencode-mcp repository. The maintainer describes its purpose as “An MCP (Model Context Protocol) server that lets any MCP host — Claude Code, Codex, Cursor, etc. — drive an OpenCode instance and delegate work…”. Read the project documentation for the complete scope.

Installation

The documented npm package is mcp-server-opencode. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
opencode_start_serverStart (or attach to) an OpenCode server instance
opencode_stop_serverStop a running OpenCode server instance
opencode_list_agentsList agents/models available on a server instance
opencode_start_taskDelegate a task to an agent by starting a new session and prompt (optional agent / model override)
opencode_continue_taskSend a follow-up prompt to an existing task's session for iterative back-and-forth with the subagent
opencode_cancel_taskAbort a running delegated task by cancelling its session
opencode_get_task_statusPoll the status of a delegated task (pending / running / completed / failed); optional include_progress adds a partial output snippet and the currently running
opencode_get_task_resultFetch the final result of a completed task
opencode_wait_for_taskLong-poll one or more delegated tasks until they finish (mode: "all" or "any") or the timeout elapses; optional include_progress enriches any…
PromptDescription
delegate_taskGuides the host through delegating one or more tasks to OpenCode agents (start/wait/result workflow), including a model selection guide that maps each OpenCode

How to install the opencode-mcp Server

{
  "mcpServers": {
    "opencode": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-opencode"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.