seo-mcp
Summary: seo-mcp is a free, keyless SEO MCP server that audits pages and sites, generates PDF reports, inspects robots.txt/sitemaps/structured data, checks broken links, suggests keywords, and runs PageSpeed/Lighthouse performance checks.
Audit a single page (
audit_page): full on-page audit — title, meta description, canonical, indexability, redirects, viewport, OG/Twitter, heading outline, word count, image alt coverage, link counts, structured data, issues list, and 0–100 score; optional PageSpeed withpagespeed: true.Export a page audit PDF (
export_audit_pdf): professionally formatted report with score badge, summary cards, severity-colored issues, and optional PageSpeed metrics.Audit an entire site (
audit_site): discovers URLs from the sitemap and runs on-page audits across pages (default 50), returning aggregates, common issues, and a compact worst-first per-page table (or full detail).Export a site-wide PDF (
export_site_pdf): multi-page report with overall score, coverage, common-issues rollup, and per-page details.Inspect robots.txt (
check_robots): fetch and parse user-agent groups, allow/disallow rules, and declared sitemaps.Inspect sitemaps (
check_sitemap): discover and summarize index vs urlset, URL count, and samples.Extract structured data (
extract_schema): pull JSON-LD and list schema.org@types plus microdata and parse errors.Find broken links (
find_broken_links): HEAD-check links on a page and report 4xx/5xx or unreachable ones.Get keyword ideas (
keyword_ideas): related queries for a seed term via Google Suggest (no volume).Run PageSpeed/Lighthouse (
pagespeed): performance score, lab Core Web Vitals, CrUX field data, and top opportunities — keyless or withPAGESPEED_API_KEY, with local Lighthouse fallback.
Provides Google PageSpeed Insights data including performance score, Core Web Vitals, and optimization opportunities.
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., "@seo-mcp audit https://example.com for SEO"
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.
seo-tools-mcp
Upgrading from an earlier package name: replace the package in your MCP client command with npx -y seo-tools-mcp@latest. Existing environment settings and saved data remain compatible.
An SEO MCP server — a stdio Model Context Protocol server that gives an AI host a set of SEO tools. The MVP is 100% free and keyless: on-page/technical audits, robots.txt, sitemaps, structured data, broken-link checks, and keyword ideas.
Built on the same proven scaffold as mcp-browser-extension: SDK Server → StdioServerTransport, a flat tool registry, and a never-throw dispatch firewall.
Tools (all free, no API key)
Tool | What it does |
| Full on-page audit: title, meta description, canonical, robots, viewport, OG/Twitter, heading outline, word count, image alt coverage, link counts, structured-data presence → issues + 0–100 score. Pass |
| Fetch & parse |
| Discover & summarize a sitemap (index vs urlset, URL count, sample) |
| Pull JSON-LD structured data and list schema.org |
| HEAD-check links on a page; report 4xx/5xx/unreachable |
| Related queries for a seed term via Google Suggest (no volume) |
| Google PageSpeed Insights (Lighthouse): perf score, lab Core Web Vitals + real-user CrUX field data + top opportunities. Keyless (rate-limited); set |
Related MCP server: gkb-seo-mcp-server
Use it as an MCP server
Requires Node 20.18.1+. Local Lighthouse audits require Node 22.19+; Node 24 is recommended for all features. There is nothing to clone, build, or configure — add this to your MCP host config (e.g. a project .mcp.json) and restart the host:
{
"mcpServers": {
"seo-tools-mcp": {
"type": "stdio",
"command": "npx",
"args": ["-y", "seo-tools-mcp@latest"]
}
}
}Or with Claude Code: claude mcp add seo-tools-mcp -- npx -y seo-tools-mcp@latest
Or, after npm install -g seo-tools-mcp@latest, set "command": "seo-tools-mcp" with no args.
Windows
WSL2 is not required — native Windows works. One config change is, though: on Windows npx is npx.cmd, a batch shim, and MCP hosts spawn the server without a shell, which cannot execute a .cmd. So "command": "npx" fails to start. Wrap it in cmd /c:
{
"mcpServers": {
"seo-tools-mcp": {
"type": "stdio",
"command": "cmd",
"args": ["/c", "npx", "-y", "seo-tools-mcp@latest"]
}
}
}Or: claude mcp add seo-tools-mcp -- cmd /c npx -y seo-tools-mcp@latest
Develop
From a source checkout:
npm install
npm run build # → dist/src/cli.js
npm testThen point your host at the local build with "command": "node", "args": ["<abs-path>/dist/src/cli.js"].
Then ask things like "audit https://example.com for SEO" or "what does example.com's robots.txt block?".
Quick smoke test (no MCP host needed)
node -e "require('./dist/src/seo/audit').auditPage('https://example.com').then(r=>console.log(JSON.stringify(r,null,2)))"Develop
npm run typecheck # tsc --noEmit
npm run build # → dist/
npm test # node:test suite (no network — fetch is stubbed)CI (.github/workflows/ci.yml) runs typecheck → build → test on Node 20/22. Node 20.18.1+ is required by Cheerio and Undici. The optional local Lighthouse engine requires Node 22.19+; hosted PageSpeed checks remain available on Node 20.18.1+.
Performance & output size
Request caching — identical GETs are de-duplicated by a short-TTL cache with in-flight coalescing, so a
audit_page→export_audit_pdfpair (or a sitemap/robots.txt referenced during a crawl) hits the network once. Tune withSEO_MCP_CACHE_TTL_MS(milliseconds, default15000); set0to disable.Compact
audit_site— by default the site audit returns a slim, worst-first per-page table (score + issue counts) plus the aggregates, to keep the response small inside an MCP host's context. Passdetail: truefor the full per-page breakdown, or useexport_site_pdffor a formatted report.
PageSpeed (optional key)
The pagespeed tool works keyless but Google rate-limits anonymous requests. To raise the quota, grab a free PageSpeed Insights API key and set it in your MCP host config:
{
"mcpServers": {
"seo-tools-mcp": {
"type": "stdio",
"command": "node",
"args": ["<absolute-path>/seo-tools-mcp/dist/src/cli.js"],
"env": { "PAGESPEED_API_KEY": "your-key-here" }
}
}
}Roadmap (needs a key — not in the free MVP)
serp_rank— real SERP position checks (drive a browser, or a paid SERP API)domain_authority— OpenPageRank (free key) for an authority scorebacklinks— real backlink profiles (paid: Ahrefs / SEMrush / DataForSEO)
Related
MCP Browser Extension (mcp-browser-extension): let Claude, Cursor or any MCP agent use the Chrome you are already logged into, with a deny-all domain allowlist.
License
MIT
Available Tools
10 toolsaudit_pageA
Full on-page SEO audit of a URL: title, meta description, canonical, indexability (meta robots, X-Robots-Tag header, and robots.txt), redirect chain, viewport, Open Graph/Twitter, heading outline and hierarchy, word count, image alt coverage, internal/external link counts, structured-data presence, plus a list of issues and a 0–100 score. Free, no API key. Set pagespeed=true to also attach PageSpeed Insights performance metrics. After presenting the results, ASK THE USER whether they want a professionally formatted PDF report; if they say yes, call export_audit_pdf with the same url (and same pagespeed/strategy).
Inputs: url (required), local, detail, strategy, +1 more.
audit_siteA
Site-wide on-page SEO audit: discovers the site's URLs from its sitemap (resolving a sitemap index into child sitemaps), runs the on-page audit on each page (keyless, concurrency-limited), and returns site-level aggregates — average/min/max score, pages with errors, site-wide gaps (missing titles/meta/H1/schema), a rollup of the most common issues, and a per-page table. By DEFAULT the response is compact: per-page rows carry score and issue counts only (sorted worst-first) to keep the payload small; set detail=true to get full per-page metadata and each page's specific issues. PageSpeed is NOT run per page (too slow across many URLs). Use audit_page or pagespeed for deep per-page performance, or export_site_pdf for a formatted report.
Inputs: url (required), max, detail.
check_robotsA
Fetch and parse a site's /robots.txt — user-agent groups, allow/disallow rules, and declared sitemaps.
Inputs: url (required).
check_sitemapA
Discover and summarize a sitemap (via /sitemap.xml or robots.txt): index vs urlset, URL count, and a sample of URLs.
Inputs: url (required).
export_audit_pdfA
Generate a professionally laid-out PDF report of an on-page SEO audit (score badge, summary cards, severity-colored issue list, metadata, content/structure, social tags, and optional PageSpeed metrics). Re-runs the audit for the URL and writes a .pdf to disk, returning the file path. Use this after audit_page when the user asks for a PDF report.
Inputs: url (required), path, detail, strategy, +1 more.
export_site_pdfB
Run a site-wide audit and write a professionally formatted multi-page PDF report (overall average-score badge, summary cards, coverage, common-issues rollup, a per-page results table sorted worst-first, and a full per-page details section — metadata, structure, and each page's specific issues). Returns the file path.
Inputs: url (required), max, path, details.
extract_schemaA
Extract JSON-LD structured data from a page and list the schema.org @types found (plus any microdata itemtypes and JSON-LD parse errors).
Inputs: url (required).
find_broken_linksB
Check the links on a page with HEAD requests and report any that return 4xx/5xx or are unreachable.
Inputs: url (required), max.
keyword_ideasA
Get related keyword/query ideas for a seed term via Google Suggest (free; related queries only, no search volume).
Inputs: seed (required), lang.
pagespeedA
Run Lighthouse for performance score (0–100), lab Core Web Vitals (LCP, CLS, TBT, FCP, Speed Index, TTI), and top improvement opportunities. Default engine is Google PageSpeed Insights (hosted; adds real-user CrUX field data when available; keyless but rate-limited — set PAGESPEED_API_KEY to raise the quota), and it auto-falls-back to a LOCAL Lighthouse run if PSI is over quota. Set local=true to force the local engine (no key, no quota; needs Chrome on the host; no CrUX field data; runs headless Chrome silently).
Inputs: url (required), local, detail, strategy.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Tools target mostly distinct SEO subtasks, but audit_page and pagespeed overlap because audit_page can optionally attach PageSpeed metrics. Similarly, check_robots/check_sitemap partially overlap with audit_page's indexability checks, though descriptions usually clarify intended use.
Nearly all names use snake_case and mostly follow a verb_noun pattern, such as audit_page, check_robots, and export_site_pdf. However, keyword_ideas and pagespeed are noun-only exceptions, so it is not a strict verb_noun pattern throughout.
Ten tools is well-scoped for an SEO audit server. Each tool covers a clear, non-trivial function: page/site audits, technical checks, PDF exports, performance, and keyword ideas.
The core technical and on-page SEO audit lifecycle is covered, including page audits, site-wide audits, robots.txt, sitemaps, structured data, broken links, performance, keyword ideas, and PDF reporting. Broader SEO capabilities like backlink analysis, rank tracking, or keyword search volume are missing, but common audit workflows are workable.
Maintenance
Related MCP Connectors
SEO MCP server for keyword research, SERP analysis, audits, and Search Console workflows.
SEO MCP server for keyword research, live SERPs, backlinks, site audits and AI visibility.
Free MCP server that audits any public URL: technical SEO, Core Web Vitals, indexing checks.
Free SEO MCP that closes the loop: find, fix, ship as a PR or to a CMS, prove. 37 tools, no key.
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP server for on-page SEO auditing and JSON-LD schema validation, providing tools for full SEO audit, schema validation, heading hierarchy, and image audit without requiring API keys.468 npm2MIT
- FlicenseAqualityCmaintenanceAn MCP server providing 20 SEO tools including coverage reports, supporting both stdio and HTTP modes for data-driven SEO analysis.20-
- AlicenseNot gradedqualityDmaintenanceAn MCP server that provides SEO analysis tools including backlink analysis, keyword research, and traffic estimation using Ahrefs data, with CAPTCHA solving and caching.MIT
- AlicenseAqualityDmaintenanceAn MCP server that provides a suite of SEO analysis tools for auditing meta tags, headings, links, keyword density, page speed, and sitemaps without requiring external API keys.61MIT