Check server health and version

Get the current opencode configuration

Update the opencode configuration. Pass a partial config object with fields to update.

List all configured providers and their default models

List all projects known to the opencode server

Initialize 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 directories separately.

Get the current active project

List all sessions

Create a new session. Optionally provide a parentID to create a child session, and a title.

Get details of a specific session by ID

Delete a session and all its data

Update session properties (e.g. title)

Get child sessions of a session

Get status for all sessions (running, idle, etc.)

Get the todo list for a session

Analyze 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.

Abort a running session

Fork an existing session, optionally at a specific message

Share a session publicly

Unshare a previously shared session

Get the diff for a session, optionally for a specific message

Summarize a session using a specified model. NOTE: This is a long-running operation that may take 30-60+ seconds.

Revert a message in a session

Restore all reverted messages in a session

List 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.

Respond 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).

Search sessions by keyword in title. Useful for finding a specific session among many.

List all messages in a session with formatted output showing roles and content

Get details of a specific message in a session

Send a prompt message to a session and wait for the AI response. Use parts to send text, and optionally specify a model.

Send a prompt asynchronously and return its messageId. Pass sessionId and messageId to opencode_wait to observe this exact turn.

Execute a slash command in a session (e.g. /init, /undo, /redo)

Run a shell command through the opencode session

Search for text patterns in project files (regex supported). Returns file paths, line numbers, and matching lines.

Find files and directories by name (fuzzy match)

Find workspace symbols by name (functions, classes, variables, etc.)

List files and directories at a path

Read the content of a file

Get status for tracked files (VCS changes: modified, added, deleted, etc.)

List all configured providers with their connection status. Returns a compact summary — use opencode_provider_models to see models for a specific provider.

List available models for a specific provider. Call opencode_provider_list first to see provider IDs.

Get available authentication methods for all providers

Start OAuth authorization for a provider

Handle OAuth callback for a provider

Set authentication credentials for a provider (e.g. API key). Credentials are stored globally and shared across all projects.

Get the current working path of the opencode server

Get VCS (version control) info for the current project (branch, remote, status)

Dispose the current opencode instance (shuts it down). WARNING: This is destructive and will terminate the server.

List all available agents with their names, descriptions, and modes (primary/subagent)

List all available commands (built-in and custom slash commands)

Get the status of LSP (Language Server Protocol) servers

Get the status of configured formatters

Get the status of all MCP servers configured in opencode

Add an MCP server dynamically to opencode

List all available tool IDs that the LLM can use (experimental)

List tools with JSON schemas for a given provider and model (experimental)

Write a log entry to the opencode server

Check 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.

Ask 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.

Send a follow-up message to an existing session. Use this to continue a conversation started with opencode_ask or opencode_session_create.

Get the full conversation history of a session, formatted for easy reading. Shows all messages with their roles and content.

Get a quick overview of all sessions with their titles and status. Useful to find which session to continue working in.

Get full project context in one call: current project, path, VCS info, config, and available agents. Useful to understand the current state before starting work.

Wait 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.

Get a formatted summary of all file changes made in a session. Shows diffs in a readable format.

Quick-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.

Send 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.

Dispatch 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.

Get 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.

Get a quick status dashboard: server health, provider count, session count, and VCS info. Lighter than opencode_setup — good for at-a-glance checks.

Append text to the TUI's prompt input field

Submit the current prompt in the TUI (equivalent to pressing Enter)

Clear the current prompt text in the TUI

Execute a slash command through the TUI (e.g. '/init', '/undo')

Show a toast notification in the TUI

Open the help dialog in the TUI

Open the session selector in the TUI

Open the model selector in the TUI

Open the theme selector in the TUI

Poll 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.

List pending OpenCode questions, optionally filtered to a session.

Answer an OpenCode question request. Supply one array of selected labels or free text per question.

Reject a pending OpenCode question explicitly.

Observe a durable job by ID, including pending inputs and final results.

Explicitly abort the OpenCode session owned by a job. This also stops other work in that session.

List locally retained jobs in this OpenCode server and credential scope.

Respond to a job's pending questions or permissions. Omit responses to request MCP forms when supported, or receive manual response instructions. Never approves automatically.