OpenCode MCP Server: Setup for Claude, Cursor and Other Apps

• Checks OpenCode and your provider setup

  Reports whether OpenCode is reachable, which model providers are configured and what is still missing. Run it first.

  Try: “Check that OpenCode is ready to use.”

  Read · opencode_setup

• Asks OpenCode a question in one step

  Starts a new session, sends your prompt and returns the answer. The OpenCode agent can act on the project, not just talk.

  Try: “Ask OpenCode how the auth flow works in this repo.”

  Runs code · opencode_ask

• Sends a task and waits for the result

  Runs a coding task through OpenCode, waits for it and returns a job ID. If the wait times out the task keeps running.

  Try: “Have OpenCode add input validation to POST /api/users.”

  Runs code · opencode_run

• Starts a background coding task

  Sends a task and returns job, session and message IDs at once, so you can check later.

  Try: “Start OpenCode on the refactor and report back later.”

  Runs code · opencode_fire

• Checks progress of a task

  Shows current status, pending input, todos and file counts for a session or job.

  Try: “How is the OpenCode task going?”

  Read · opencode_check

• Waits for a task to finish

  Waits until a session or job completes, fails, needs input or reaches a time limit. Cancelling the wait does not stop OpenCode.

  Try: “Wait for the OpenCode task to finish.”

  Read · opencode_wait

• Sends a follow-up to a session

  Continues an existing session with another message.

  Try: “Tell OpenCode to also update the tests.”

  Runs code · opencode_reply

• Summarizes file changes from a session

  Returns a readable summary of every file change a session made, with diffs.

  Try: “Show what OpenCode changed.”

  Read · opencode_review_changes

• Shows a session's full conversation

  Returns all messages of a session with their roles and content.

  Try: “Show the conversation from the last session.”

  Read · opencode_conversation

• Shows project context

  Returns the current project, path, version control info, config and available agents in one call.

  Try: “What project is OpenCode working in?”

  Read · opencode_context

• Shows a quick status dashboard

  Reports server health, provider count, session count and version control info.

  Try: “Give me OpenCode's status.”

  Read · opencode_status

• Overviews all sessions

  Lists sessions with titles and status to find one to continue.

  Try: “Which sessions are open?”

  Read · opencode_sessions_overview

• Tests that a provider works

  Creates a temporary session, sends a trivial prompt, checks the answer and cleans up. It may use provider credits.

  Try: “Test whether my Anthropic provider works.”

  Write · opencode_provider_test

• Lists retained jobs

  Shows jobs this server remembers in your credential scope.

  Try: “List my OpenCode jobs.”

  Read · opencode_job_list

• Looks at a job

  Shows a job's state, pending inputs and final result.

  Try: “Show job abc.”

  Read · opencode_job_get

• Cancels a job

  Aborts the OpenCode session that owns the job, which also stops other work in that session.

  Try: “Cancel job abc.”

  Write · opencode_job_cancel

• Answers a job's pending questions

  Responds to questions or permission requests of a job. It never approves automatically.

  Try: “Answer the pending question on job abc with option A.”

  Write · opencode_job_input

• Lists pending questions

  Shows questions OpenCode is waiting on, optionally for one session.

  Try: “Does OpenCode have questions for me?”

  Read · opencode_question_list

• Answers a question

  Replies to a question with chosen labels or free text.

  Try: “Pick the second option for that question.”

  Write · opencode_question_reply

• Declines a question

  Rejects a pending question explicitly.

  Try: “Reject that question.”

  Write · opencode_question_reject

• Lists pending permission requests

  Shows sessions blocked waiting for approval, for example to run a shell command.

  Try: “Is any session waiting for permission?”

  Read · opencode_permission_list

• Answers a permission request

  Approves once, approves always for matching requests, or rejects. Always lets OpenCode do the same thing again without asking.

  Try: “Approve that request once.”

  Write · opencode_session_permission

• Lists sessions

  Returns all sessions.

  Try: “List all OpenCode sessions.”

  Read · opencode_session_list

• Reads one session

  Returns details of a session by ID.

  Try: “Show session abc.”

  Read · opencode_session_get

• Lists child sessions

  Returns sessions created under a session.

  Try: “Show child sessions of abc.”

  Read · opencode_session_children

• Shows status of all sessions

  Returns running or idle state for every session.

  Try: “Which sessions are running?”

  Read · opencode_session_status

• Shows a session's todo list

  Returns the todo items of a session.

  Try: “Show the todos of session abc.”

  Read · opencode_session_todo

• Shows a session's diff

  Returns the diff for a session or one message.

  Try: “Show the diff for session abc.”

  Read · opencode_session_diff

• Searches sessions by title

  Finds sessions whose title contains a keyword.

  Try: “Find the session about the login bug.”

  Read · opencode_session_search

• Creates a session

  Starts a new, empty session, optionally under a parent and with a title.

  Try: “Create a session called Refactor.”

  Write · opencode_session_create

• Forks a session

  Copies a session, optionally from a chosen message.

  Try: “Fork session abc at message 3.”

  Write · opencode_session_fork

• Renames a session

  Updates properties such as the title.

  Try: “Rename session abc to Auth work.”

  Write · opencode_session_update

• Stops a running session

  Aborts a session that is running.

  Try: “Stop session abc.”

  Write · opencode_session_abort

• Deletes a session

  Removes a session and all its data.

  Try: “Delete session abc.”

  Delete · opencode_session_delete

• Creates AGENTS.md for a project

  Analyzes the app and writes an AGENTS.md. It can take a minute or more.

  Try: “Initialize AGENTS.md for this project.”

  Write · opencode_session_init

• Summarizes a session

  Summarizes a session with a model you choose. It can take a minute or more.

  Try: “Summarize session abc.”

  Write · opencode_session_summarize

• Reverts a message

  Undoes a message's changes in a session.

  Try: “Revert the last message in session abc.”

  Write · opencode_session_revert

• Restores reverted messages

  Brings back all messages that were reverted in a session.

  Try: “Undo the revert in session abc.”

  Write · opencode_session_unrevert

• Shares a session publicly

  Makes a session available at a public link.

  Try: “Share session abc.”

  Write · opencode_session_share

• Stops sharing a session

  Removes the public link of a session.

  Try: “Unshare session abc.”

  Write · opencode_session_unshare

• Runs a slash command in a session

  Executes a command such as /init, /undo or /redo.

  Try: “Run /undo in session abc.”

  Runs code · opencode_command_execute

• Lists messages in a session

  Returns the messages of a session with roles and content.

  Try: “List the messages in session abc.”

  Read · opencode_message_list

• Reads one message

  Returns the details of a message in a session.

  Try: “Show message 3 of session abc.”

  Read · opencode_message_get

• Sends a message and waits for the answer

  Posts a prompt to a session and returns the reply. OpenCode can act on the project.

  Try: “Send this prompt to session abc.”

  Runs code · opencode_message_send

• Sends a message without waiting

  Posts a prompt and returns a message ID to observe later.

  Try: “Send this prompt and let it run.”

  Runs code · opencode_message_send_async

• Runs a shell command through OpenCode

  Executes a shell command in a session, on the machine where OpenCode runs.

  Try: “Run npm test through OpenCode.”

  Runs code · opencode_shell_execute

• Lists files at a path

  Lists files and folders on the OpenCode server's project.

  Try: “List the src folder.”

  Files · opencode_file_list

• Reads a file

  Returns the content of a file on the OpenCode server.

  Try: “Read src/index.ts.”

  Files · opencode_file_read

• Shows version control file status

  Lists modified, added and deleted files.

  Try: “Which files changed?”

  Read · opencode_file_status

• Finds files by name

  Fuzzy-matches file and folder names.

  Try: “Find files named config.”

  Read · opencode_find_file

• Finds code symbols

  Searches workspace symbols such as functions and classes.

  Try: “Find the function parseConfig.”

  Read · opencode_find_symbol

• Searches text in files

  Searches project files for a pattern, regex allowed, and returns paths, lines and matches.

  Try: “Search for TODO in the project.”

  Read · opencode_find_text

• Reads OpenCode's configuration

  Returns the current OpenCode configuration.

  Try: “Show my OpenCode config.”

  Read · opencode_config_get

• Lists providers and default models

  Returns configured providers and their default models.

  Try: “Which providers are configured?”

  Read · opencode_config_providers

• Changes OpenCode's configuration

  Updates the configuration with the fields you pass.

  Try: “Set the default model to claude-sonnet.”

  Write · opencode_config_update

• Stores a provider credential

  Saves an API key for a provider globally, shared across projects.

  Try: “Save this API key for the OpenAI provider.”

  Write · opencode_auth_set

• Lists sign-in methods for providers

  Shows how each provider can be authenticated.

  Try: “How can I sign in to each provider?”

  Read · opencode_provider_auth_methods

• Lists providers and connection status

  Returns a compact summary of providers and whether they are connected.

  Try: “Which providers are connected?”

  Read · opencode_provider_list

• Lists models of a provider

  Returns the models available from one provider.

  Try: “Which models does Anthropic offer here?”

  Read · opencode_provider_models

• Starts provider OAuth sign-in

  Begins the OAuth flow for a provider.

  Try: “Start signing in to the provider.”

  Write · opencode_provider_oauth_authorize

• Completes provider OAuth sign-in

  Handles the OAuth callback for a provider.

  Try: “Finish the provider sign-in.”

  Write · opencode_provider_oauth_callback

• Adds text to the terminal prompt

  Appends text to OpenCode's terminal UI prompt box.

  Try: “Add this text to the TUI prompt.”

  Write · opencode_tui_append_prompt

• Clears the terminal prompt

  Empties the TUI prompt box.

  Try: “Clear the TUI prompt.”

  Write · opencode_tui_clear_prompt

• Submits the terminal prompt

  Presses Enter on the TUI prompt, which sends it to the agent.

  Try: “Submit the TUI prompt.”

  Runs code · opencode_tui_submit_prompt

• Runs a command in the terminal UI

  Executes a slash command through the TUI.

  Try: “Run /init in the TUI.”

  Runs code · opencode_tui_execute_command

• Opens the TUI help

  Shows the help dialog in the terminal UI.

  Try: “Open help in the TUI.”

  Write · opencode_tui_open_help

• Opens the TUI model picker

  Shows the model selector in the terminal UI.

  Try: “Open the model picker.”

  Write · opencode_tui_open_models

• Opens the TUI session picker

  Shows the session selector in the terminal UI.

  Try: “Open the session picker.”

  Write · opencode_tui_open_sessions

• Opens the TUI theme picker

  Shows the theme selector in the terminal UI.

  Try: “Open the theme picker.”

  Write · opencode_tui_open_themes

• Shows a TUI notification

  Displays a toast message in the terminal UI.

  Try: “Show a toast saying done.”

  Write · opencode_tui_show_toast

• Shows the active project

  Returns the project OpenCode is using now.

  Try: “Which project is active?”

  Read · opencode_project_current

• Lists known projects

  Returns projects the OpenCode server knows.

  Try: “List OpenCode projects.”

  Read · opencode_project_list

• Creates or opens a project folder

  Makes or opens a folder on the machine running this MCP server to host a separate OpenCode session.

  Try: “Create a new project in /work/demo.”

  Write · opencode_project_init

• Collects recent OpenCode events

  Listens for project events for a set time and returns what it saw.

  Try: “Watch OpenCode events for 10 seconds.”

  Read · opencode_events_poll

• Checks server health

  Returns whether the OpenCode server is healthy and its version.

  Try: “Is OpenCode up?”

  Read · opencode_health

• Lists available agents

  Returns agents with names, descriptions and modes.

  Try: “Which OpenCode agents exist?”

  Read · opencode_agent_list

• Lists slash commands

  Returns built-in and custom commands.

  Try: “Which commands can I run?”

  Read · opencode_command_list

• Shows formatter status

  Returns the state of configured formatters.

  Try: “Which formatters are active?”

  Read · opencode_formatter_status

• Shows language server status

  Returns the state of language servers.

  Try: “Are language servers running?”

  Read · opencode_lsp_status

• Shows OpenCode's own MCP servers

  Returns the status of MCP servers configured inside OpenCode.

  Try: “Which MCP servers does OpenCode use?”

  Read · opencode_mcp_status

• Adds an MCP server to OpenCode

  Registers another MCP server in OpenCode at run time, which gives OpenCode more tools.

  Try: “Add this MCP server to OpenCode.”

  Write · opencode_mcp_add

• Shows the server's working path

  Returns the working directory of the OpenCode server.

  Try: “What folder is OpenCode running in?”

  Read · opencode_path_get

• Lists tool IDs OpenCode can use

  Returns tool identifiers available to the model (experimental).

  Try: “List OpenCode's tool IDs.”

  Read · opencode_tool_ids

• Lists tools with schemas

  Returns tools and input schemas for a provider and model (experimental).

  Try: “Show tools available for this model.”

  Read · opencode_tool_list

• Shows version control info

  Returns branch, remote and status of the project.

  Try: “Which branch is OpenCode on?”

  Read · opencode_vcs_info

• Writes a log entry

  Adds an entry to the OpenCode server log.

  Try: “Log that the migration started.”

  Write · opencode_log

• Shuts down the OpenCode instance

  Disposes the current OpenCode instance, which terminates the server.

  Try: “Shut down OpenCode.”

  Delete · opencode_instance_dispose

Watch out for

• It can run shell commands and edit your code

  The shell tool and the task tools make OpenCode act on the project and the machine it runs on. Keep OpenCode's own permission prompts on and review the diff afterwards. github.com

• One tool shuts the OpenCode server down

  The dispose tool terminates the running OpenCode instance, and the session delete tool removes a session and its data. github.com

• It can change OpenCode's settings and credentials

  Tools update the config, save provider API keys and add other MCP servers to OpenCode. Only allow these when you asked for them. github.com

• The always-approve reply is permanent for matching requests

  Replying always to a permission request approves the same kind of request again later. Prefer approving once. github.com

• The smaller tool profile still includes risky tools

  Setting OPENCODE_TOOL_PROFILE to essential gives 25 tools, but it keeps the run, fire, reply, ask and session abort tools, so OpenCode can still change code. github.com

Security advisories