Install Lightsage MCP in OpenCode

OpenCode can connect to remote MCP servers from opencode.json or opencode.jsonc. Use this guide to connect OpenCode to the hosted Lightsage MCP endpoint.

Get your Lightsage API key

Open the Lightsage dashboard, copy your API key, and store it as LIGHTSAGE_API_KEY:

export LIGHTSAGE_API_KEY="ls_cli_your_api_key"

Do not put your API key in shared project config, screenshots, issue reports, or public repositories.

Add Lightsage MCP to OpenCode

Add Lightsage MCP to opencode.json or opencode.jsonc:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "lightsage": {
      "type": "remote",
      "url": "https://mcp.lightsage.com/mcp",
      "enabled": true,
      "oauth": false,
      "headers": {
        "X-Lightsage-Api-Key": "{env:LIGHTSAGE_API_KEY}"
      }
    }
  }
}

Verify OpenCode can use Lightsage

Run OpenCode and ask it to use the lightsage MCP server. Use opencode mcp list if you need to inspect connection state.Then run a read-only prompt:

Use the Lightsage MCP server to check my Lightsage auth status.

See the OpenCode MCP docs for local and remote server options.

Getting Started

Clients

Install Lightsage MCP in OpenCode