# deadlink-checker-mcp

Dead link checker MCP server — find broken links, redirects, and timeouts on any website.

## Installation

### Claude Code
```bash
claude mcp add deadlink-checker -- npx -y deadlink-checker-mcp
```

### Claude Desktop
Add to `claude_desktop_config.json`:
```json
{
  "mcpServers": {
    "deadlink-checker": {
      "command": "npx",
      "args": ["-y", "deadlink-checker-mcp"]
    }
  }
}
```

### Cursor
Add to MCP settings:
```json
{
  "mcpServers": {
    "deadlink-checker": {
      "command": "npx",
      "args": ["-y", "deadlink-checker-mcp"]
    }
  }
}
```

## Tools

### `check_links`
Check all links on a single webpage.

**Example prompt:**
> Check all links on https://example.com for broken URLs

**Output:** JSON with status, statusText, redirectTo, responseTime, and location for every link found.

---

### `deep_scan`
Recursively crawl internal pages and check all discovered links.

**Example prompt:**
> Deep scan https://example.com with depth 2 to find all broken links

**Parameters:**
- `url` — Starting URL
- `depth` — Crawl depth 1-3 (free: max 1)

---

### `check_sitemap`
Parse a sitemap.xml and check every listed URL.

**Example prompt:**
> Check all URLs in https://example.com/sitemap.xml

**Output:** Status of every URL in the sitemap, with broken links and timeouts highlighted.

## How It Works

1. Fetches the target page and extracts all `<a href>` links
2. Checks each link using HTTP HEAD (fast), falls back to GET if HEAD is rejected
3. Parallel batch requests (10 at a time) with 10s timeout and 1 retry
4. Reports: broken (4xx/5xx), redirects (301/302), timeouts, and healthy links

## Part of the MCP Toolkit

**[View all servers →](https://yifanyifan897645.github.io/mcp-toolkit/)**

- [webcheck-mcp](https://www.npmjs.com/package/webcheck-mcp) — Website health analysis
- [git-summary-mcp](https://www.npmjs.com/package/git-summary-mcp) — Git repository intelligence
- [mcp-checkup](https://www.npmjs.com/package/mcp-checkup) — MCP setup health analyzer
- [dev-utils-mcp](https://www.npmjs.com/package/dev-utils-mcp) — Developer utilities
- [codescan-mcp](https://www.npmjs.com/package/codescan-mcp) — Codebase health scanner
- [deadlink-checker-mcp](https://www.npmjs.com/package/deadlink-checker-mcp) — Dead link detector

## License

MIT