Opencode MCP
MCP server for OpenCode AI — 70 tools, 10 resources, 5 prompts. Use npx opencode-mcp with Claude Desktop, Claude Code, Cursor, Windsurf, or any MCP client.
Opencode MCP is an open-source mcp server by AlaeddineMessadi, written mainly in TypeScript, with 159 GitHub stars and the MIT license. Its code was last updated Oct 29, 2026. The latest npm release is opencode-mcp 3.1.0, published Oct 29, 2026, with 23,789 downloads last week.
Scan summary: scanned Nov 5, 2026 at commit 609560d. Seen able to run shell commands. Scan policy
How to install Opencode MCP
Built from the start command in the project's README: npx -y opencode-mcp. Check the README for required keys or settings.
claude mcp add opencode-mcp -- npx -y opencode-mcp{
"mcpServers": {
"opencode-mcp": {
"command": "npx",
"args": [
"-y",
"opencode-mcp"
]
}
}
}{
"mcpServers": {
"opencode-mcp": {
"command": "npx",
"args": [
"-y",
"opencode-mcp"
]
}
}
}code --add-mcp '{"name":"opencode-mcp","command":"npx","args":["-y","opencode-mcp"]}'What Opencode MCP can touch
- The server lists a tool that does this.Run shell commandsListed as a tool: opencode_command_execute
- Our checks did not find this. The tool may still do it.Run dynamic codeNot seen in this scan
- Our checks did not find this. The tool may still do it.Read or write filesNot seen in this scan
- Our checks did not find this. The tool may still do it.Read environment and secretsNot seen in this scan
- Our checks did not find this. The tool may still do it.Control a web browserNot seen in this scan
- Our checks did not find this. The tool may still do it.Connect to databasesNot seen in this scan
- Our checks did not find this. The tool may still do it.Read or send messagesNot seen in this scan
- Our checks did not find this. The tool may still do it.Touch money or tradingNot seen in this scan
- Our checks did not find this. The tool may still do it.Connect to the internetNo connections seen while running
"Not seen" means our checks did not find it, and the tool may still do it. Covers commit 609560d, Nov 5, 2026. See the scan policy.
Before you install Opencode MCP
AgenticMart scanned Opencode MCP on Nov 5, 2026 with automated checks for hidden code, known-malicious packages, leaked secrets and vulnerable dependencies. The result covers one commit under our scan policy, so review what access you give it and check any advisories shown here.
What it can access
- An MCP server is a program your AI app starts and talks to. A local one runs with your user's permissions: it can see the files, environment variables and network your account can.
Before you install
- Pin the version you reviewed instead of always installing the latest release.
- Read the tool list or scripts before the first run, and keep approval prompts on for actions that write, send or delete.
- Maintained by AlaeddineMessadi on GitHub, 159 stars and 29 forks. Popularity is not proof of safety.
- Last code change: Oct 29, 2026.
- Open-source license: MIT.
Tools Opencode MCP exposes (87)
Listed by the server itself during our scan of commit 609560d.
opencode_healthCheck server health and version
opencode_config_getGet the current opencode configuration
opencode_config_updateUpdate the opencode configuration. Pass a partial config object with fields to update.
opencode_config_providersList all configured providers and their default models
opencode_project_listList all projects known to the opencode server
opencode_project_initInitialize or open a project directory to host an independent OpenCode session. Use this to create new empty folders, or to explicitly open preexisting projects on the MCP host machine for parallel code generation workloads. This tool operates on the local filesystem; create remote server directorie
opencode_project_currentGet the current active project
opencode_session_listList all sessions
opencode_session_createCreate a new session. Optionally provide a parentID to create a child session, and a title.
opencode_session_getGet details of a specific session by ID
opencode_session_deleteDelete a session and all its data
opencode_session_updateUpdate session properties (e.g. title)
opencode_session_childrenGet child sessions of a session
opencode_session_statusGet status for all sessions (running, idle, etc.)
opencode_session_todoGet the todo list for a session
opencode_session_initAnalyze the app and create AGENTS.md for a session. NOTE: This is a long-running operation that may take 30-60+ seconds depending on project size.
opencode_session_abortAbort a running session
opencode_session_forkFork an existing session, optionally at a specific message
opencode_session_shareShare a session publicly
opencode_session_unshareUnshare a previously shared session
opencode_session_diffGet the diff for a session, optionally for a specific message
opencode_session_summarizeSummarize a session using a specified model. NOTE: This is a long-running operation that may take 30-60+ seconds.
opencode_session_revertRevert a message in a session
opencode_session_unrevertRestore all reverted messages in a session
opencode_permission_listList all pending permission requests across all sessions. When a session is blocked waiting for approval (e.g. to run a shell command or access a file outside the project), it appears here. Respond with `opencode_session_permission`.
opencode_session_permissionRespond to a permission request in a session. Use `opencode_permission_list` to see pending requests. Reply values: 'once' (approve this request only), 'always' (approve this + future matching requests for this session), 'reject' (deny the request).
opencode_session_searchSearch sessions by keyword in title. Useful for finding a specific session among many.
opencode_message_listList all messages in a session with formatted output showing roles and content
opencode_message_getGet details of a specific message in a session
opencode_message_sendSend a prompt message to a session and wait for the AI response. Use parts to send text, and optionally specify a model.
opencode_message_send_asyncSend a prompt asynchronously and return its messageId. Pass sessionId and messageId to opencode_wait to observe this exact turn.
opencode_command_executeExecute a slash command in a session (e.g. /init, /undo, /redo)
opencode_shell_executeRun a shell command through the opencode session
opencode_find_textSearch for text patterns in project files (regex supported). Returns file paths, line numbers, and matching lines.
opencode_find_fileFind files and directories by name (fuzzy match)
opencode_find_symbolFind workspace symbols by name (functions, classes, variables, etc.)
opencode_file_listList files and directories at a path
opencode_file_readRead the content of a file
opencode_file_statusGet status for tracked files (VCS changes: modified, added, deleted, etc.)
opencode_provider_listList all configured providers with their connection status. Returns a compact summary — use opencode_provider_models to see models for a specific provider.
Opencode MCP is an open-source mcp server by AlaeddineMessadi, written mainly in TypeScript. MCP server for OpenCode AI — 70 tools, 10 resources, 5 prompts. Use npx opencode-mcp with Claude Desktop, Claude Code, Cursor, Windsurf, or any MCP client.
At a glance
- Stars
- 159
- Forks
- 29
- Language
- TypeScript
- License
- MIT
- Created
- Feb 2026
- Last update
- Oct 29, 2026
- Type
- MCP Server
- Price
- Free
Topics
Questions about Opencode MCP
What is Opencode MCP?
MCP server for OpenCode AI — 70 tools, 10 resources, 5 prompts. Use npx opencode-mcp with Claude Desktop, Claude Code, Cursor, Windsurf, or any MCP client.
Who maintains Opencode MCP?
Opencode MCP is maintained by AlaeddineMessadi on GitHub (AlaeddineMessadi/opencode-mcp). AgenticMart lists it from public repository data.
Is Opencode MCP safe to use?
AgenticMart scanned Opencode MCP on Nov 5, 2026 with automated checks for hidden code, known-malicious packages, leaked secrets and vulnerable dependencies. The result covers one commit under our scan policy, so review what access you give it and check any advisories shown here.
What license does Opencode MCP use?
It is published under the MIT license.
Opencode MCP alternatives
View more →Similar mcp servers in Learning Resources, ranked by GitHub stars. Compare licence, recent activity and scan status before you choose.
| Name | Stars | Licence | Last updated | Scan |
|---|---|---|---|---|
| Opencode MCP (this page) AlaeddineMessadi | 159 | MIT | Oct 29, 2026 | Scanned, no flagged issues |
| Dashboard Icons homarr-labs | 9k | Apache-2.0 | Oct 26, 2026 | Scanned, no flagged issues |
| Ha MCP homeassistant-ai | 5.4k | MIT | Nov 1, 2026 | Scanned, no flagged issues |
| MCP Server Guide figma | 2.1k | None found | Oct 28, 2026 | Not scanned yet |
| Mcpso chatmcp | 2.1k | Apache-2.0 | Oct 25, 2026 | Scanned, no flagged issues |
| MCP MicrosoftDocs | 2k | CC-BY-4.0 | Oct 30, 2026 | Scanned, no flagged issues |