Lumen MCP server
io.github.nitishagar/lumen·v0.3.0Deterministic SEO audits as MCP tools: 36-rule site audit, keywords, rank, CWV reports.
0 stars9 downloads/wk
Reviews
Write oneNobody has reviewed Lumen yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Lumen tools
No tool declarations could be read from the package source. They show once the server is installed.
Public scan report
scanner v0.1.10 · 2026-10-01 · same rubric, same numbers if you re-run it
- Code scan75 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 0 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Lumen compares
Against every graded SEO MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 83/100
- higher than 70% of 769 SEO servers
- Downloads a week
- 9
- more than 0% of 170 SEO servers with a package
Install Lumen in Claude Code, Cursor or VS Code
Runs npx -y @lumen-seo/cli on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add lumen -- npx -y @lumen-seo/cli
What the publisher says
From the Lumen repository's README, as published. We do not edit it. Read it on GitHub
lumen
Lightweight, pluggable, MCP-first SEO toolkit — free services only, bring your own keys, provenance on every number.
Status: v0.2.x — first public release. The CLI, the five MCP tools, and the docs site are live; see CHANGELOG.md for what shipped and the docs for the full guides.
Why lumen
Most SEO tooling is a black box with a subscription. lumen is the opposite: a local-first, agent-first audit toolkit that runs on free data sources, never ships a number it can't attribute, and speaks MCP so your coding agent can run it for you.
- Local site audits — bounded, robots-respecting crawler with 36 built-in rules, severity scoring, and CI-friendly exit codes (0 pass, 1 findings, 2 usage/abort).
- Free-tier data providers — PageSpeed Insights, CrUX, Google Suggest, Wikipedia demand, OpenPageRank, Tranco, DuckDuckGo SERP. BYOK: keys are read from env vars by name, never stored or logged.
- MCP-first — five tools (lumenauditsite, lumenpagereport, lumenkeywordideas, lumenrankcheck, lumen_authority) over stdio or a thin Cloudflare Worker gateway.
- Provenance on every number — each metric carries its source and fetch timestamp; no free source, no number.
Quickstart
Requires Node >= 22.7.
# One-off audit — no install
npx -y @lumen-seo/cli audit https://example.com
# Install globally
npm install -g @lumen-seo/cli
lumen audit https://example.com --max-pages 50Wire it into Claude Code (or Cursor / VS Code — MCP onboarding):
claude mcp add --transport stdio lumen -- npx -y @lumen-seo/cli mcpThen just ask: "audit my site and tell me what to fix first."
Packages
Note on packaging: npm packages ship compiled JavaScript + type declarations (dist/) — plain node import, no flags, no tsx. The TypeScript sources stay the source of truth in the repo; the release pipeline compiles per package at publish time.
Documentation
- Quickstart — first audit, JSON output, CI usage
- CLI reference — all thirteen commands and flags
- Rules reference — the 36 rules, severities, scoring
- Providers & BYOK — data sources, keys, rate-limit etiquette
- MCP onboarding — Claude, Cursor, VS Code, remote gateway
Development
Requires Node >= 22.
npm install
npm run lint
npm run typecheck
npm testShortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Lumen: common questions
- Is Lumen MCP server safe?
- Mostly: it is graded B (83/100). Read the Lumen safety report
- How do I install Lumen?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Lumen need an API key?
- Yes. The registry entry asks for
LUMEN_PSI_KEY,LUMEN_CRUX_KEY,LUMEN_OPR_KEY. - Is Lumen maintained?
- The last commit was 34 days ago (2026-10-01). The latest release is v0.3.0.
- What can I use instead of Lumen?
- Servers from other publishers that do the same job: DispatchSEO MCP server, Crawlie MCP server and Outrank MCP server.
- How does Lumen compare with other SEO MCP servers?
- safety score 83/100 (higher than 70% of 769 SEO servers); downloads a week 9 (more than 0% of 170 SEO servers with a package). Full comparison.
Alternatives to Lumen
Same job from other publishers: the closest match first, then the best rated.
DispatchSEOOpen-source SEO manager for coding agents: keyword research, content PRs, rank + Search Console.not reviewedGrowingA- CrawlieTechnical SEO + GEO (AI-search) site audits: hosted crawls, prioritized fixes, report diffs.not reviewedGrowingA
OutrankPlan SEO keywords, write and publish articles to your site, read Search Console and backlink datanot reviewedGrowingA- pseolintPenalty-risk audit for programmatic SEO sites: verdict, risk score, and a fix manifest.not reviewedGrowingB
Open SEO CrawlerSelf-hosted SEO crawler: run site audits and AI crawler checks, then read the issues and pages.not reviewedGrowingA