Skip to main content
Glama

site-audit-mcp

An MCP server that gives Claude (or any MCP client) the ability to audit websites for SEO and technical health. Ask in plain language, for example "Audit acme.com and tell me the five fixes that matter most", and the assistant crawls the site, checks every page, and explains what to fix.

No API keys and no paid services are needed. It runs locally over studio.

Tools

Tool

What it does

audit_page

On-page SEO audit of one URL: title, meta description, H1/heading structure, image alt text, lang, mobile viewport, canonical, Open Graph, noindex, word count, HTTPS, page weight, response time. Returns a 0–100 score and prioritized issues.

check_links

Collects every link on a page and checks its HTTP status in parallel. Lists broken (4xx/5xx/unreachable) links. Falls back from HEAD to GET for servers that reject HEAD.

check_site_files

Checks robots.txt (presence, Disallow: / for all crawlers, declared sitemaps) and the XML sitemap (presence, URL count).

audit_site

Crawls a site from a start URL (same domain only, up to 50 pages), audits each page, and summarizes the average score, the most common issues, and duplicate titles and meta descriptions.

Example output

# Site audit: https://www.python.org/
Pages audited: 5 · Average score: 97/100

## Most common issues
- ℹ️ `canonical_missing` on 5 page(s): No canonical link tag.
- ⚠️ `h1_multiple` on 3 page(s): Found 5 <h1> headings (recommended 1).
- ℹ️ `heading_skip` on 2 page(s): Heading level jumps from h2 to h4.

## Duplicate meta descriptions
- https://www.python.org/, https://www.python.org/jobs/, ...

Related MCP server: Keytomic

Install

Requires Node.js 20 or newer.

git clone https://github.com/zakyalzd/site-audit-mcp.git
cd site-audit-mcp
npm install
npm run build

Claude Code

claude mcp add site-audit -- node /absolute/path/to/site-audit-mcp/dist/index.js

Claude Desktop

Add this to claude_desktop_config.json:

{
  "mcpServers": {
    "site-audit": {
      "command": "node",
      "args": ["/absolute/path/to/site-audit-mcp/dist/index.js"]
    }
  }
}

Scoring

Each page starts at 100. Every error costs 15 points (for example a missing title, a missing H1, or an HTTP 4xx/5xx), and every warning costs 5 (for example a missing meta description, images without alt text, no viewport, or a slow response). Info items are suggestions and cost nothing.

Development

npm test        # 8 tests against a local HTTP fixture server, using an in-memory MCP client
npm run dev     # run the server from source with tsx

Project layout:

  • src/audit.ts: fetching, HTML analysis, link checking and crawling. It has no MCP dependency.

  • src/server.ts: MCP tool definitions and markdown formatting.

  • src/index.ts: stdio entry point.

Notes

  • The server only makes read-only GET/HEAD requests and sends a site-audit-mcp user agent.

  • Only http and https URLs are accepted.

  • It fetches whatever URL it is given, including local network addresses. Do not expose it as a public network service without adding an allow-list.

License

MIT

Available Tools

4 tools
audit_pageAudit page SEOA
Read-only

Fetch one web page and run an on-page SEO and technical audit: title, meta description, headings, image alt text, mobile viewport, canonical, Open Graph, noindex, content length, HTTPS and response time. Returns a 0–100 score and issues.

Inputs: url (required).

audit_siteCrawl and audit siteA
Read-only

Crawl a site from a start URL (same domain only), audit every page found, and summarize scores, the most common issues, and duplicate titles or meta descriptions.

Inputs: url (required), max_pages.

check_site_filesCheck robots.txt and sitemapB
Read-only

Check a site's robots.txt and XML sitemap: presence, crawler blocking, sitemap location and URL count.

Inputs: url (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 4 tools

    Disambiguation4/5

    The four tools have mostly distinct scopes: file-level checks, site-wide crawl audit, single-page audit, and link checking. The main potential confusion is between audit_page and check_links, since both operate on a single page, but their descriptions clarify the difference.

    Naming Consistency5/5

    All tool names use snake_case and follow a clear verb_noun pattern (check_site_files, audit_site, audit_page, check_links). The convention is consistent and easy to predict.

    Tool Count5/5

    Four tools is a well-scoped set for a focused site-audit server. Each tool covers a distinct audit concern and none feels redundant or superfluous.

    Completeness4/5

    The surface covers key SEO audit needs: robots/sitemap checks, site-wide crawl auditing, on-page auditing, and link status checks. Minor gaps remain, such as site-wide broken-link aggregation or structured-data checks, but these are workable by combining existing tools.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables running comprehensive SEO audits on websites, checking meta tags, sitemaps, robots.txt, broken links, headings, duplicate titles, and keyword density through MCP tools.
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Remote MCP server for Keytomic, the AI SEO agent: SEO audits, Search Console and GA4 data, keyword research, articles, CMS publishing, indexing, backlinks, Reddit and AI visibility. You sign in with your Keytomic account.
      1
      MIT