mcp-opencode
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| OPENCODE_BASE_URL | No | Base URL for connecting to an already running OpenCode server. | |
| OPENCODE_AUTO_SERVE | No | Whether to automatically start OpenCode via the SDK (default: 'true'). | true |
| OPENCODE_DEFAULT_AGENT | No | Default agent to use (default: 'chatgpt-coordinator'). | chatgpt-coordinator |
| OPENCODE_DEFAULT_MODEL | No | Default model to use, in the format 'provider/model'. | |
| OPENCODE_SERVER_PASSWORD | No | Password for the OpenCode server. | |
| OPENCODE_SERVER_USERNAME | No | Username for the OpenCode server. | |
| OPENCODE_DEFAULT_DIRECTORY | No | Default project directory used for operations; must be an existing folder. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| opencode_setupA | Comprueba salud, agentes, proveedores, proyecto, Git y sesiones activas. Úsalo antes de delegar una tarea nueva. |
| opencode_agentsA | Devuelve los agentes primarios y subagentes disponibles, sus modelos y modos. |
| opencode_statusB | Consulta salud, sesiones ocupadas, MCP de OpenCode y estado Git del proyecto. |
| opencode_contextA | Agrega proyecto, agentes, proveedores, sesiones, comandos, MCP y estado de archivos para que ChatGPT pueda planear correctamente. |
| opencode_projectsA | Lista los proyectos que OpenCode conoce. Úsalo para orientar una tarea cuando no se tenga claro el directorio. |
| opencode_sessionsA | Lista sesiones recientes del proyecto, útil para retomar trabajo o auditar tareas en segundo plano. |
| opencode_providersA | Lista proveedores y modelos disponibles, incluido OpenCode Go, para seleccionar Flash o Pro con evidencia. |
| opencode_commandsA | Lista comandos y workflows definidos globalmente o por el proyecto. |
| opencode_mcp_statusA | Consulta los MCP que OpenCode tiene conectados y sus estados sin modificar configuración. |
| opencode_permissionsA | Consulta solicitudes de permiso pendientes y eventos recientes para resolver pausas de una sesión headless. |
| opencode_runA | Crea una sesión, delega una tarea al agente elegido, espera su respuesta y devuelve evidencia incluyendo diff. |
| opencode_replyA | Envía una nueva instrucción a una sesión existente y devuelve respuesta, estado y diff actualizado. |
| opencode_fireA | Crea una sesión y dispara una tarea sin esperar. Úsalo para tareas independientes; devuelve un sessionId para seguimiento. |
| opencode_parallelA | Despacha hasta 12 tareas independientes. Rechaza por defecto escrituras concurrentes en el mismo directorio; usa worktrees/directorios distintos o permite la excepción explícitamente. |
| opencode_checkA | Devuelve estado, TODO, diff y mensajes recientes de una sesión. |
| opencode_forkA | Crea una sesión hija desde una sesión existente para explorar una alternativa sin perder el contexto original. |
| opencode_summarizeA | Resume/compacta una sesión larga usando un modelo explícito para conservar continuidad y liberar contexto. |
| opencode_childrenA | Devuelve las sesiones hijas creadas por OpenCode mediante Task, útil para auditar la delegación interna. |
| opencode_messagesA | Devuelve mensajes recientes de una sesión para continuidad, diagnóstico y evidencia. |
| opencode_waitA | Espera una sesión asíncrona hasta que termine o alcance el tiempo límite y devuelve su evidencia. |
| opencode_wait_manyA | Espera en paralelo varias sesiones previamente despachadas y devuelve el resultado de cada una. |
| opencode_reviewA | Obtiene la sesión, diff y estado de archivos para revisar el resultado antes de aceptarlo. |
| opencode_file_statusA | Obtiene el estado de archivos que OpenCode ve en el proyecto para comprobar cambios antes y después de una tarea. |
| opencode_abortA | Detiene una sesión en ejecución. Úsalo solo cuando el usuario lo solicite o exista un bloqueo claro. |
| opencode_respond_permissionB | Responde una solicitud headless con once, always o reject. Úsalo solo después de revisar el título y patrón del permiso. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 25 tools
Many tools have overlapping purposes, especially status/check/review which all inspect sessions and diffs. However, descriptions attempt to differentiate in specific ways, and the rest are more distinct.
All tools share the consistent 'opencode_' prefix, but the suffix mixes verbs (run, fire, wait) and nouns (sessions, projects) without a strict verb_noun pattern. Still, the pattern is predictable and readable.
At 25 tools, the server is on the heavy side for its scope. Several tools could likely be consolidated (e.g., status-like queries), but the count is not unreasonable for a full-featured session manager.
The tool set covers session lifecycle well: create, run, reply, fork, wait, abort, and monitor. Gaps include no explicit session deletion or update of provider configurations, but core workflows are present.