Connect your client.
Add the hosted Claude connector, run a local MCP server, or install a plugin with workflow skills and the catalog.
Add Lumen UI to Claude
Find accessible components, inspect their APIs, and explore design tokens and migration guidance from Claude. Open Customize → Connectors, search for Lumen UI, and add it. No separate Lumen account, API key, or local server setup is required.
Try asking Claude to find Lumen components for an accessible React settings screen or show the SwiftUI Button contract. The connector sends catalog queries and tool arguments to the hosted Lumen service over HTTPS. Keep credentials, personal data, and private source out of those arguments.
If the listing is unavailable, choose Add → Custom → Web, name the connector Lumen UI, and enter https://mcp.lumen.santi020k.com/mcp. Select No sign-in when Claude detects authentication.
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.
These unpinned commands use the latest published catalog. Read lumen_get_meta and check installed package versions with lumen_check_compatibility before applying its contracts. Migration guidance defaults to the catalog's bundled release. Request lumen_get_migration with targetVersion: "5.0.0" or targetVersion: "4.0.0" to select a supported major explicitly.
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.
The repository's plugin 1.1.0 candidate bundles build, review and migration skills for the v5 catalog. Publishing the MCP package, deploying the hosted catalog and approving the directory update are separate steps; installing the published plugin does not establish v5 availability.
Try: “Find the right Lumen components for an accessible React settings screen.”
Install Lumen UIInstall the skills and pinned catalog together
Add Lumen's repository marketplace, then install one plugin that bundles the build, review and migration skills with an exact read-only MCP catalog version.
The repository plugin starts an exact MCP package version locally with Node.js 20.20 or newer. The Claude directory connector above provides the hosted catalog tools.
/plugin marketplace add santi020k/lumen
/plugin install lumen-ui@lumen