opencode-mcp

Overview

opencode-mcp is a comprehensive MCP server that bridges MCP clients to OpenCode's headless API, enabling AI assistants to delegate real coding work to OpenCode sessions. The server provides 79 tools across multiple categories including workflow tools, session management, file operations, and system monitoring. It supports multi-project handling, auto-start functionality, and works with various MCP clients like Claude Desktop, Cursor, Windsurf, VS Code Copilot, and more. The implementation is well-structured with TypeScript and includes comprehensive documentation and testing.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• opencode_setup

  Check server health, providers, and project status. Use first.

  Try:Check my project statusTry:Verify OpenCode server health
• opencode_ask

  Create session + send prompt + get answer. One call.

  Try:Explain the auth flow in this projectTry:What does this function do?
• opencode_run

  Send a task and wait for completion (session + async send + polling)

  Try:Add input validation to POST /api/usersTry:Refactor the auth module
• opencode_fire

  Fire-and-forget: dispatch a task, return immediately

  Try:Run tests in backgroundTry:Fix the CSS styling issue asynchronously
• opencode_check

  Compact progress report for a running session

  Try:Check progress of my taskTry:What's the status of session xyz?
• opencode_sessions_overview

  Quick overview of all sessions

  Try:List all my sessionsTry:Show me active coding sessions
• opencode_context

  Project + VCS + config + agents in one call

  Try:Get current project contextTry:Show me project configuration
• opencode_review_changes

  Formatted diff summary for a session

  Try:Show changes from my last sessionTry:Review the code modifications
• opencode_wait

  Poll an async session until it finishes

  Try:Wait for my background task to completeTry:Keep polling until session xyz finishes
• opencode_provider_test

  Quick-test whether a provider is working

  Try:Test if Anthropic provider worksTry:Verify OpenAI API connection
• opencode_status

  Health + providers + sessions + VCS dashboard

  Try:Show system statusTry:List all active providers
• opencode_conversation

  Get formatted conversation history

  Try:Show my conversation historyTry:Export chat log from session xyz

Comparable tools

Installation

claude mcp add opencode -- npx -y opencode-mcp

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

FAQ

What MCP clients are supported?

The server works with Claude Desktop, Claude Code, Cursor, Windsurf, VS Code Copilot, Cline, Continue, Zed, Amazon Q, and any other MCP-compatible client.

Does this require OpenCode to be installed locally?

Yes, OpenCode must be installed on your machine. The MCP server will automatically start the OpenCode server if it's not already running.

Compare opencode-mcp with