Skip to main content
Glama

opencode-cli-mcp

MCP server that wraps opencode CLI's HTTP API (opencode serve) into MCP tools, plus a SOTA fleet webapp dashboard.

Architecture

Clients (MCP hosts)  →  opencode-cli-mcp (FastMCP 3.2)
                             ↕ HTTP
                         opencode serve (port 4096)
  • MCP Server (stdio): Exposes 9 tools for agent run, session management, and server status

  • FastAPI Bridge (port 10951): REST API for the webapp + capability introspection

  • Vite Webapp (port 10950): SOTA fleet-standard dashboard

Prerequisites

  • opencodenpm i -g opencode-ai

  • Python 3.12+ with uv

  • Node.js 18+ with npm

Quick Start

.\start.ps1

This starts opencode serve, the API backend, and the webapp frontend.

Or run individually:

uv run -m opencode_cli_mcp.server    # MCP server (stdio)
uv run -m api.main                   # API backend (port 10951)
cd web_sota && npm run dev           # Frontend (port 10950)

MCP Tools

Tool

Description

opencode_run_agent

Run an agent non-interactively with a prompt

opencode_list_sessions

List all active/recent sessions

opencode_get_session

Get detailed session info

opencode_export_session

Export session as JSON

opencode_send_message

Send message to a running session

opencode_get_messages

Retrieve session transcript

opencode_server_status

Check server health and status

opencode_list_providers

List configured LLM providers

opencode_get_project

Get current project context

Ports

Port

Service

10950

Frontend (Vite)

10951

Backend (FastAPI)

4096

opencode serve

License

MIT

F
license - not found
-
quality - not tested
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/sandraschi/opencode-cli-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server