Uses Google Suggest to generate keyword ideas for SEO research.
Provides site speed and Core Web Vitals metrics from PageSpeed Insights for audits and page reports.
Uses Wikipedia demand data to support keyword and content research.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@lumen Run an SEO audit on example.com and show me the Core Web Vitals report"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
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 (lumen_audit_site, lumen_page_report, lumen_keyword_ideas, lumen_rank_check, 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.
Related MCP server: SEOMonster
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."
Package | Purpose |
types + payload models, config loader ( | |
bounded crawler, 36 built-in AuditRules, severity scorer, report assembly | |
built-in data providers (BYOK, free services only) | |
| |
MCP tool definitions + transport adapters (Cloudflare Worker) | |
| docs site (live) |
Note on packaging: npm packages ship compiled JavaScript + type declarations (
dist/) — plainnodeimport, no flags, notsx. The TypeScript sources stay the source of truth in the repo; the release pipeline compiles per package at publish time.
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
Requires Node >= 22.
npm install
npm run lint
npm run typecheck
npm testSee CONTRIBUTING.md for conventions, SECURITY.md for the security policy, and docs/release.md for the release runbook.
Apache-2.0 — Copyright 2026 Nitish Agarwal
This server cannot be deployed
SEO MCP: Search Console, GA4, SERP and domain data, rank tracking, AI citations and site fixes.
Free SEO MCP that closes the loop: find, fix, ship as a PR or to a CMS, prove. 37 tools, no key.
Open-source AI SEO over MCP: audits, ranks, keywords, backlinks + AI visibility (GEO).
SEO MCP server for keyword research, SERP analysis, audits, and Search Console workflows.
