Server data from the Official MCP Registry
Deterministic SEO audits as MCP tools: 36-rule site audit, keywords, rank, CWV reports.
About
Deterministic SEO audits as MCP tools: 36-rule site audit, keywords, rank, CWV reports.
Security Report
Valid MCP server (2 strong, 1 medium validity signals). 1 known CVE in dependencies ⚠️ Package registry links to a different repository than scanned source. Imported from the Official MCP Registry. 1 finding(s) downgraded by scanner intelligence.
13 files analyzed · 2 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Environment variable: LUMEN_PSI_KEY
Environment variable: LUMEN_CRUX_KEY
Environment variable: LUMEN_OPR_KEY
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-nitishagar-lumen": {
"env": {
"LUMEN_OPR_KEY": "your-lumen-opr-key-here",
"LUMEN_PSI_KEY": "your-lumen-psi-key-here",
"LUMEN_CRUX_KEY": "your-lumen-crux-key-here"
},
"args": [
"-y",
"@lumen-seo/cli"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
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 (
0pass,1findings,2usage/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.
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 50
Wire it into Claude Code (or Cursor / VS Code — MCP onboarding):
claude mcp add --transport stdio lumen -- npx -y @lumen-seo/cli mcp
Then just ask: "audit my site and tell me what to fix first."
Packages
| Package | Purpose |
|---|---|
@lumen-seo/core | types + payload models, config loader (failThreshold), Fetcher (SSRF/timeout/backoff), robots, provider/rule SPIs + registries |
@lumen-seo/audit | bounded crawler, 36 built-in AuditRules, severity scorer, report assembly |
@lumen-seo/providers | built-in data providers (BYOK, free services only) |
@lumen-seo/cli | lumen CLI, JSONL history, stdio MCP launcher |
@lumen-seo/mcp | MCP tool definitions + transport adapters (Cloudflare Worker) |
@lumen-seo/site | 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.
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 test
See CONTRIBUTING.md for conventions, SECURITY.md for the security policy, and docs/release.md for the release runbook.
License
Apache-2.0 — Copyright 2026 Nitish Agarwal
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Fetch
Freeby Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
Worldmonitor
Freeby Koala73 · Developer Tools
Live markets, conflicts, country risk, chokepoints, energy, and China decision signals. 86 tools.
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.