Install Lumen as an OpenCode plugin from npm. The plugin registers a local MCP server automatically.
- OpenCode.ai installed
Add Lumen to the plugin array in your opencode.json:
{
"plugin": ["@ory/lumen-opencode"]
}Restart OpenCode. The plugin registers a local mcp.lumen server that runs
scripts/run stdio on all platforms (cross-spawn resolves scripts/run.cmd
via PATHEXT on Windows).
opencode mcp listThen ask OpenCode to call the Lumen semantic_search, health_check, or
index_status MCP tools directly.
Restart OpenCode after updating the version pin in opencode.json, or pin a
specific version:
{
"plugin": ["@ory/lumen-opencode@0.0.29"]
}Remove the @ory/lumen-opencode entry from opencode.json and restart
OpenCode.