MCP server
Lumen
Deterministic SEO audits as MCP tools: 36-rule site audit, keywords, rank, CWV reports.
Runs locallyStatus and history
- Pricing
- Open source
- Runs
- Locally
- Version
- 0.3.0
- Listing updated
- 5 days ago
About Lumen
Lumen is an open-source MCP server. It runs locally on your machine and is started by your AI client.
Install
Run in a terminal
claude mcp add lumen --env LUMEN_PSI_KEY='<LUMEN_PSI_KEY>' --env LUMEN_CRUX_KEY='<LUMEN_CRUX_KEY>' --env LUMEN_OPR_KEY='<LUMEN_OPR_KEY>' -- npx -y @lumen-seo/cliAdd to claude_desktop_config.json
{
"mcpServers": {
"lumen": {
"command": "npx",
"args": [
"-y",
"@lumen-seo/cli"
],
"env": {
"LUMEN_PSI_KEY": "<LUMEN_PSI_KEY>",
"LUMEN_CRUX_KEY": "<LUMEN_CRUX_KEY>",
"LUMEN_OPR_KEY": "<LUMEN_OPR_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"lumen": {
"command": "npx",
"args": [
"-y",
"@lumen-seo/cli"
],
"env": {
"LUMEN_PSI_KEY": "<LUMEN_PSI_KEY>",
"LUMEN_CRUX_KEY": "<LUMEN_CRUX_KEY>",
"LUMEN_OPR_KEY": "<LUMEN_OPR_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"lumen": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@lumen-seo/cli"
],
"env": {
"LUMEN_PSI_KEY": "<LUMEN_PSI_KEY>",
"LUMEN_CRUX_KEY": "<LUMEN_CRUX_KEY>",
"LUMEN_OPR_KEY": "<LUMEN_OPR_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"lumen": {
"command": "npx",
"args": [
"-y",
"@lumen-seo/cli"
],
"env": {
"LUMEN_PSI_KEY": "<LUMEN_PSI_KEY>",
"LUMEN_CRUX_KEY": "<LUMEN_CRUX_KEY>",
"LUMEN_OPR_KEY": "<LUMEN_OPR_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"lumen": {
"command": "npx",
"args": [
"-y",
"@lumen-seo/cli"
],
"env": {
"LUMEN_PSI_KEY": "<LUMEN_PSI_KEY>",
"LUMEN_CRUX_KEY": "<LUMEN_CRUX_KEY>",
"LUMEN_OPR_KEY": "<LUMEN_OPR_KEY>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
LUMEN_PSI_KEYGoogle PageSpeed Insights API key — enables the CWV lab leg of page reports. Optional; without it that leg reports not-configured.LUMEN_CRUX_KEYChrome UX Report API key — enables field CWV data. Optional; without it that leg reports not-configured.LUMEN_OPR_KEYOpen PageRank API key — enables the OPR authority signal. Optional; without it that signal reports not-configured.
Pricing
Open source
Lumen FAQ
Is Lumen free?
Yes. Lumen is open source, so you can use and self-host it for free.
How do I add Lumen to Claude Code?
Run this command in your terminal: claude mcp add lumen --env LUMEN_PSI_KEY='<LUMEN_PSI_KEY>' --env LUMEN_CRUX_KEY='<LUMEN_CRUX_KEY>' --env LUMEN_OPR_KEY='<LUMEN_OPR_KEY>' -- npx -y @lumen-seo/cli
Where this comes from
- Description: from the official MCP Registry entry.
- Install steps: from the official MCP Registry entry.