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.
Scan summary: scanned Nov 5, 2026 at commit 609560d. Seen able to run shell commands. Scan policy
609560d · Nov 5, 2026Findings (2)
- lowLow. Minor, or common in normal tools. Shown for information.Possible example credential in docs/tests: generic-api-key3 matches in this file
tests/helpers.test.ts:516 - lowLow. Minor, or common in normal tools. Shown for information.No manifest declaring network access and environment variables (agent.json)
Network activity
Tools exposed (87)
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_provider_modelsList available models for a specific provider. Call opencode_provider_list first to see provider IDs.
opencode_provider_auth_methodsGet available authentication methods for all providers
opencode_provider_oauth_authorizeStart OAuth authorization for a provider
opencode_provider_oauth_callbackHandle OAuth callback for a provider
opencode_auth_setSet authentication credentials for a provider (e.g. API key). Credentials are stored globally and shared across all projects.
opencode_path_getGet the current working path of the opencode server
opencode_vcs_infoGet VCS (version control) info for the current project (branch, remote, status)
opencode_instance_disposeDispose the current opencode instance (shuts it down). WARNING: This is destructive and will terminate the server.
opencode_agent_listList all available agents with their names, descriptions, and modes (primary/subagent)
opencode_command_listList all available commands (built-in and custom slash commands)
opencode_lsp_statusGet the status of LSP (Language Server Protocol) servers
opencode_formatter_statusGet the status of configured formatters
opencode_mcp_statusGet the status of all MCP servers configured in opencode
opencode_mcp_addAdd an MCP server dynamically to opencode
opencode_tool_idsList all available tool IDs that the LLM can use (experimental)
opencode_tool_listList tools with JSON schemas for a given provider and model (experimental)
opencode_logWrite a log entry to the opencode server
opencode_setupCheck OpenCode status, provider configuration, and optionally initialize a project directory. Use this as the first step when starting work — it tells you what is ready and what still needs configuration.
opencode_askAsk OpenCode a question in one step. Creates a new session, sends your prompt, and returns the AI response. This is the easiest way to interact with OpenCode.
opencode_replySend a follow-up message to an existing session. Use this to continue a conversation started with opencode_ask or opencode_session_create.
opencode_conversationGet the full conversation history of a session, formatted for easy reading. Shows all messages with their roles and content.
opencode_sessions_overviewGet a quick overview of all sessions with their titles and status. Useful to find which session to continue working in.
opencode_contextGet full project context in one call: current project, path, VCS info, config, and available agents. Useful to understand the current state before starting work.
opencode_waitWait for a session or durable job. Returns completed, failed, input_required, or a resumable timeout. Cancelling this wait stops observation; use job_cancel or session_abort to stop OpenCode.
opencode_review_changesGet a formatted summary of all file changes made in a session. Shows diffs in a readable format.
opencode_provider_testQuick-test whether a provider is working. Creates a temporary session, sends a trivial prompt, checks the response, and cleans up. Great for debugging auth issues.
opencode_runSend a task and wait for its correlated response. Returns a durable job ID; an observation timeout leaves the remote job running and can be resumed with opencode_wait.
opencode_fireDispatch a durable background task and return its job, session and message IDs immediately. Use opencode_check or opencode_wait to observe; job_cancel stops the task.
opencode_checkGet current task status, pending input, todos and file counts. Uses session summary metadata instead of fetching patches. Pass jobId for exact durable turn correlation; detailed includes response text.
opencode_statusGet a quick status dashboard: server health, provider count, session count, and VCS info. Lighter than opencode_setup — good for at-a-glance checks.
opencode_tui_append_promptAppend text to the TUI's prompt input field
opencode_tui_submit_promptSubmit the current prompt in the TUI (equivalent to pressing Enter)
opencode_tui_clear_promptClear the current prompt text in the TUI
opencode_tui_execute_commandExecute a slash command through the TUI (e.g. '/init', '/undo')
opencode_tui_show_toastShow a toast notification in the TUI
opencode_tui_open_helpOpen the help dialog in the TUI
opencode_tui_open_sessionsOpen the session selector in the TUI
opencode_tui_open_modelsOpen the model selector in the TUI
opencode_tui_open_themesOpen the theme selector in the TUI
opencode_events_pollPoll project events from OpenCode, or explicitly select global scope. Collects up to maxEvents within the duration. Connection failures are reported with any partial events; stopping observation does not abort remote work.
opencode_question_listList pending OpenCode questions, optionally filtered to a session.
opencode_question_replyAnswer an OpenCode question request. Supply one array of selected labels or free text per question.
opencode_question_rejectReject a pending OpenCode question explicitly.
opencode_job_getObserve a durable job by ID, including pending inputs and final results.
opencode_job_cancelExplicitly abort the OpenCode session owned by a job. This also stops other work in that session.
opencode_job_listList locally retained jobs in this OpenCode server and credential scope.
opencode_job_inputRespond to a job's pending questions or permissions. Omit responses to request MCP forms when supported, or receive manual response instructions. Never approves automatically.
Automated result for the commit shown. See our scan policy. View the scan log
Maintainers can claim the listing to rescan, or dispute a result.
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 |