Connect your client.
Choose a local MCP server or install a plugin that includes the workflow skill and catalog together.
Local server
Run with npx over stdio or HTTP
The server ships a self-contained snapshot of the catalog, so no repository checkout is required. With Node.js 20.20 or newer, point your MCP client at npx -y @santi020k/lumen-mcp.
[mcp_servers.lumen]
enabled = true
command = "npx"
args = ["-y", "@santi020k/lumen-mcp"]
startup_timeout_sec = 10.0
tool_timeout_sec = 30.0{
"mcpServers": {
"lumen": {
"command": "npx",
"args": ["-y", "@santi020k/lumen-mcp"]
}
}
}{
"mcpServers": {
"lumen": {
"command": "npx",
"args": ["-y", "@santi020k/lumen-mcp"]
}
}
}{
"name": "lumen",
"transport": "stdio",
"command": "npx",
"args": ["-y", "@santi020k/lumen-mcp"]
}npx -y --package @santi020k/lumen-mcp lumen-mcp-http
# MCP endpoint: http://127.0.0.1:3000/mcp
# Health check: http://127.0.0.1:3000/health
# Default limit: 120 requests per minuteSave the configuration in .codex/config.toml for Codex, claude_desktop_config.json for Claude Desktop, or .cursor/mcp.json for Cursor. For another stdio client, adapt the generic configuration to its server settings.
Codex also supports the command codex mcp add lumen -- npx -y @santi020k/lumen-mcp.
Lumen UI for ChatGPT and Codex
Open Lumen UI in the Plugins Directory and select Install plugin. Then mention @Lumen UI in a request or choose a starter prompt. The plugin bundles the workflow skill and hosted, read-only public catalog, with no separate Lumen account, API key, or local server setup.
Try: “Find the right Lumen components for an accessible React settings screen.”
Install Lumen UIInstall the skill and live catalog together
Add Lumen's repository marketplace, then install one plugin that bundles the portable workflow skill with the latest published read-only MCP catalog.
/plugin marketplace add santi020k/lumen
/plugin install lumen-ui@lumen/plugin marketplace add santi020k/lumen
/plugin install lumen-ui@lumen