opencode-executor-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
opencode-executor-mcp
MCP server exposing an ask_opencode tool that delegates a prompt to an
OpenCode agent session. Lets a Claude Code
orchestrator hand off executor-role / bulk work to a cheaper backend
instead of spawning another Claude subagent.
Not tied to any specific provider: by default it uses OpenCode's own
bundled Zen free models (only needs opencode auth login, no company
gateway required). If you have a company/paid gateway configured in
OpenCode, pass it explicitly per-call.
Claude Code (orchestrator)
-> MCP tool call: ask_opencode(prompt, provider?, model?, sessionId?)
-> this server
-> opencode serve (localhost:4096) REST API
-> whichever provider is selected (default: OpenCode Zen free tier)Prerequisites
Node.js 18+ (global
fetchrequired)OpenCode CLI installed
opencode auth loginrun once (sets up the bundled Zen free-tier credentials used as the default)Optional: any additional provider configured in OpenCode (company gateway, other API key, etc.) if you want to target something other than the default free models
Related MCP server: opencode-delegate
Setup
Install dependencies:
npm installAuthenticate OpenCode's default (Zen) provider, if you haven't:
opencode auth loginStart the OpenCode server (must stay running while you use the tool):
opencode serve --port 4096Verify at least one provider is live:
curl -s http://127.0.0.1:4096/config/providers | jqYou should see a provider with id
opencode(the bundled Zen models). Any additional provider you've configured will show up alongside it.Register this server with Claude Code. Add to
~/.claude.jsonundermcpServers(seedocs/claude-code-integration.mdfor the exact block):"opencode-executor": { "type": "stdio", "command": "node", "args": ["/absolute/path/to/opencode-mcp/index.js"] }Restart Claude Code. The
ask_opencodeandlist_opencode_modelstools are now available.
Usage
list_opencode_models()
# -> [{ providerID: "opencode", modelID: "big-pickle", name: "Big Pickle", bundled: true }, ...]
ask_opencode({ prompt: "summarize this log file" })
# uses the default bundled Zen model
ask_opencode({ prompt: "...", provider: "my-provider", model: "some-model-id" })
# targets a specific configured provider insteadOmit sessionId for a fresh one-off session (no memory of prior calls).
Pass the sessionId returned by a previous ask_opencode call to continue
that same conversation — OpenCode retains the history, so the model sees
prior turns. This is still call-and-response driven by Claude Code calling
the tool each turn; OpenCode never initiates on its own.
Calls can be issued concurrently (fan-out / swarm) since each session is
independent unless you deliberately reuse a sessionId; see
docs/architecture.md.
Configuration
Env var | Default | Purpose |
|
| Base URL of the running |
| unset | Pin a default provider/model for every call that doesn't specify one, instead of auto-picking the bundled Zen provider |
Troubleshooting
See docs/troubleshooting.md.
Docs
docs/architecture.md— how the pieces fit together, why this shapedocs/claude-code-integration.md— wiring into Claude Code'smcpServersconfigdocs/troubleshooting.md— common failures and fixes
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Capture coding-agent sessions and resume them in any other agent: Claude Code, Codex, Cursor, more.
Shared long-term memory & Stop-hook task handoff across Claude Code, Codex, Cursor, and mobile.
1People and AI agents build software together in persistent cloud sessions for Claude Code.
Persistent cross-session memory shared by Codex, Claude Code, ChatGPT, and other AI agents.
Related MCP Servers
- FlicenseCqualityCmaintenanceEnables Claude Desktop to act as a planning agent while delegating coding tasks to OpenCode CLI, returning execution status, file diffs, and output, with support for continuing sessions and opening workspaces in IDEs.151-
- AlicenseNot gradedqualityCmaintenanceEnables Claude Code and Claude Desktop to delegate coding tasks to any model available in OpenCode while Claude remains the orchestrator, planning work, reviewing diffs, and running tests. Supports synchronous and async delegation, model selection, session continuation, and permission-aware execution.6MIT
- AlicenseAqualityBmaintenanceEnables Claude Code to delegate software-engineering tasks to OpenCode agents working in the same workspace.737 npm1MIT
- AlicenseAqualityBmaintenanceEnables delegating Claude Code subagent tasks to cheaper opencode models, while keeping the main Claude Code session connected directly to Anthropic.52,659 npm2MIT