Bragproof

← Reports

opencode-mcp

Starts with no setup3.1.0npm

Installed, started with no arguments, no environment and no input, and listed its tools. Run 2026-11-16.

Needs to start: nothing
Returns a result when called with no setup: 0 of 5 tools tried
Contacts while installing and starting: nothing

87tools listed
0hosts contacted
0files written
0.2 sto start
10dependencies

What it contacted

Nothing besides the npm registry it was installed from. Watched from outside its sandbox while it was installed and started with no input. Its tools may still contact things when called.

Starting it

npx -y opencode-mcp@3.1.0

Installing a package runs its code. Use a sandbox for anything you have not read.

Calling its tools

5 tools that take no input and look read-only were called once with nothing. 0 returned a result.

opencode_healthNo usable answer tool reported an error: Error: fetch failed **Suggestions:** - Is `opencode serve` running? Check with `opencode_setup` - Verify OPENCODE_BASE_URL is correct (
opencode_config_getNo usable answer tool reported an error: Error: fetch failed **Suggestions:** - Is `opencode serve` running? Check with `opencode_setup` - Verify OPENCODE_BASE_URL is correct (
opencode_project_listNo usable answer tool reported an error: Error: fetch failed **Suggestions:** - Is `opencode serve` running? Check with `opencode_setup` - Verify OPENCODE_BASE_URL is correct (
opencode_project_currentNo usable answer tool reported an error: Error: fetch failed **Suggestions:** - Is `opencode serve` running? Check with `opencode_setup` - Verify OPENCODE_BASE_URL is correct (
opencode_session_listNo usable answer tool reported an error: Error: fetch failed **Suggestions:** - Is `opencode serve` running? Check with `opencode_setup` - Verify OPENCODE_BASE_URL is correct (

During the calls it contacted nothing it had not already contacted.

Only tools whose names read like looking something up, with no required input, are tried, five at most. Tools that need input, and anything that sounds like it changes or sends something, are not called.

What its tools tell an agent

In the tool descriptions, nothing that talks about the user, other tools or private files, or uses hidden characters.

Found by simple pattern rules in each tool's description (up to 3,000 characters), quoted as written. Parameter descriptions are not scanned. A clean result is not a safety review.

Tools

opencode_health directory
Check server health and version
opencode_config_get directory
Get the current opencode configuration
opencode_config_update config, directory
Update the opencode configuration. Pass a partial config object with fields to update.
opencode_config_providers directory
List all configured providers and their default models
opencode_project_list directory
List all projects known to the opencode server
82 more tools
opencode_project_init path
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.
opencode_project_current directory
Get the current active project
opencode_session_list directory
List all sessions
opencode_session_create parentID, title, directory
Create a new session. Optionally provide a parentID to create a child session, and a title.
opencode_session_get id, directory
Get details of a specific session by ID
opencode_session_delete id, directory
Delete a session and all its data
opencode_session_update id, title, directory
Update session properties (e.g. title)
opencode_session_children id, directory
Get child sessions of a session
opencode_session_status directory
Get status for all sessions (running, idle, etc.)
opencode_session_todo id, directory
Get the todo list for a session
opencode_session_init id, messageID, providerID, modelID, variant, directory
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.
opencode_session_abort id, directory
Abort a running session
opencode_session_fork id, messageID, directory
Fork an existing session, optionally at a specific message
opencode_session_share id, directory
Share a session publicly
opencode_session_unshare id, directory
Unshare a previously shared session
opencode_session_diff id, messageID, directory
Get the diff for a session, optionally for a specific message
opencode_session_summarize id, providerID, modelID, variant, directory
Summarize a session using a specified model. NOTE: This is a long-running operation that may take 30-60+ seconds.
opencode_session_revert id, messageID, partID, directory
Revert a message in a session
opencode_session_unrevert id, directory
Restore all reverted messages in a session
opencode_permission_list directory
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`.
opencode_session_permission id, permissionID, reply, directory
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).
opencode_session_search query, directory
Search sessions by keyword in title. Useful for finding a specific session among many.
opencode_message_list sessionId, limit, directory
List all messages in a session with formatted output showing roles and content
opencode_message_get sessionId, messageId, directory
Get details of a specific message in a session
opencode_message_send sessionId, text, providerID, modelID, variant, agent, noReply, system, format, directory
Send 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_async sessionId, text, providerID, modelID, variant, agent, format, directory
Send a prompt asynchronously and return its messageId. Pass sessionId and messageId to opencode_wait to observe this exact turn.
opencode_command_execute sessionId, command, arguments, agent, providerID, modelID, variant, directory
Execute a slash command in a session (e.g. /init, /undo, /redo)
opencode_shell_execute sessionId, command, agent, providerID, modelID, directory
Run a shell command through the opencode session
opencode_find_text pattern, directory
Search for text patterns in project files (regex supported). Returns file paths, line numbers, and matching lines.
opencode_find_file query, type, searchDirectory, limit, directory
Find files and directories by name (fuzzy match)
opencode_find_symbol query, directory
Find workspace symbols by name (functions, classes, variables, etc.)
opencode_file_list path, directory
List files and directories at a path
opencode_file_read path, directory
Read the content of a file
opencode_file_status directory
Get status for tracked files (VCS changes: modified, added, deleted, etc.)
opencode_provider_list directory
List all configured providers with their connection status. Returns a compact summary — use opencode_provider_models to see models for a specific provider.
opencode_provider_models providerId, limit, directory
List available models for a specific provider. Call opencode_provider_list first to see provider IDs.
opencode_provider_auth_methods directory
Get available authentication methods for all providers
opencode_provider_oauth_authorize providerId, method, inputs
Start OAuth authorization for a provider
opencode_provider_oauth_callback providerId, callbackData
Handle OAuth callback for a provider
opencode_auth_set providerId, type, key
Set authentication credentials for a provider (e.g. API key). Credentials are stored globally and shared across all projects.
opencode_path_get directory
Get the current working path of the opencode server
opencode_vcs_info directory
Get VCS (version control) info for the current project (branch, remote, status)
opencode_instance_dispose directory
Dispose the current opencode instance (shuts it down). WARNING: This is destructive and will terminate the server.
opencode_agent_list directory
List all available agents with their names, descriptions, and modes (primary/subagent)
opencode_command_list directory
List all available commands (built-in and custom slash commands)
opencode_lsp_status directory
Get the status of LSP (Language Server Protocol) servers
opencode_formatter_status directory
Get the status of configured formatters
opencode_mcp_status directory
Get the status of all MCP servers configured in opencode
opencode_mcp_add name, config, directory
Add an MCP server dynamically to opencode
opencode_tool_ids directory
List all available tool IDs that the LLM can use (experimental)
opencode_tool_list provider, model, directory
List tools with JSON schemas for a given provider and model (experimental)
opencode_log service, level, message, extra, directory
Write a log entry to the opencode server
opencode_setup directory
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.
opencode_ask prompt, title, providerID, modelID, variant, agent, system, format, directory
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.
opencode_reply sessionId, prompt, providerID, modelID, variant, agent, format, directory
Send a follow-up message to an existing session. Use this to continue a conversation started with opencode_ask or opencode_session_create.
opencode_conversation sessionId, limit, directory
Get the full conversation history of a session, formatted for easy reading. Shows all messages with their roles and content.
opencode_sessions_overview directory
Get a quick overview of all sessions with their titles and status. Useful to find which session to continue working in.
opencode_context directory
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.
opencode_wait sessionId, jobId, messageId, timeoutSeconds, pollIntervalMs, directory
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.
opencode_review_changes sessionId, messageID, directory
Get a formatted summary of all file changes made in a session. Shows diffs in a readable format.
opencode_provider_test providerId, modelID, variant, format, directory
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.
opencode_run prompt, sessionId, title, providerID, modelID, variant, agent, directory, format, maxDurationSeconds
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.
opencode_fire prompt, sessionId, title, providerID, modelID, variant, agent, directory, format
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.
opencode_check sessionId, jobId, messageId, detailed, directory
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.
opencode_status directory
Get 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_prompt text, directory
Append text to the TUI's prompt input field
opencode_tui_submit_prompt directory
Submit the current prompt in the TUI (equivalent to pressing Enter)
opencode_tui_clear_prompt directory
Clear the current prompt text in the TUI
opencode_tui_execute_command command, directory
Execute a slash command through the TUI (e.g. '/init', '/undo')
opencode_tui_show_toast message, title, variant, directory
Show a toast notification in the TUI
opencode_tui_open_help directory
Open the help dialog in the TUI
opencode_tui_open_sessions directory
Open the session selector in the TUI
opencode_tui_open_models directory
Open the model selector in the TUI
opencode_tui_open_themes directory
Open the theme selector in the TUI
opencode_events_poll durationMs, maxEvents, directory, scope
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.
opencode_question_list sessionId, directory
List pending OpenCode questions, optionally filtered to a session.
opencode_question_reply requestId, answers, directory
Answer an OpenCode question request. Supply one array of selected labels or free text per question.
opencode_question_reject requestId, directory
Reject a pending OpenCode question explicitly.
opencode_job_get jobId
Observe a durable job by ID, including pending inputs and final results.
opencode_job_cancel jobId
Explicitly abort the OpenCode session owned by a job. This also stops other work in that session.
opencode_job_list limit
List locally retained jobs in this OpenCode server and credential scope.
opencode_job_input jobId, responses
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.

Descriptions are the package's own words, cut at 3,000 characters. Treat them as data.

Install facts

LicenseMIT
Needsnode >=22.0.0
Sourcegithub.com/AlaeddineMessadi/opencode-mcp
Install scriptsNone declared by it or anything installed with it.
Tarballsha512-x4JLxKxh2fgKYiUzyGp+TlvYGBe5u8xXkltftswIFEvUufKW1WXnqJWsfgXmMo+DYweYudjxbeoOCdTBRGoKQA==

Check this report yourself

This site did not write the report. A public job on a GitHub-hosted machine did: the run, from this commit of the open-source runner. GitHub signed a token that names that job and the hash of the report, so any edit since would show.

Show it on your README

Bragproof: Starts with no setup

[![Bragproof](https://bragproof.smaverk.com/badge/opencode-mcp.svg)](https://bragproof.smaverk.com/r/opencode-mcp)

New version out? Ask for a fresh report.