# link-check-lite

> link-check-lite is an open-source MCP server for developer tools. Check a text file of links for status codes, broken pages and redirect chains. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Windows, macOS, Linux, self-hosted
- **Website:** https://tidybytetools.github.io/tools/link-check/
- **Repository:** https://github.com/tidybytetools/link-check-lite
- **MCP Registry name:** io.github.tidybytetools/link-check-lite
- **Categories:** developer tools, marketing and SEO
- **Listing updated:** 2026-11-14

## About

link-check-lite is the free tier of a small family of link checkers from Tidy Byte Tools. Give it a text file with one URL per line and it reports the HTTP status, any redirect chain and the final address for each link, treating 404 and 410 as broken and 301 as still working. The checker uses only Python's standard library and runs on your own machine.

The same package includes a CLI that exits with code 1 when any link is broken, which suits cron jobs and CI, a GitHub Action, and an MCP server for apps such as Cursor and Claude Desktop with no API key. It checks five links at a time with a short pause.

The README lists limits plainly: some sites answer 403 or 429 to bots, JavaScript redirects are not followed, there is no sitemap or CSV input, no robots.txt handling and no scam detection. Those extras, plus speed checks and CSV, JSON and Markdown reports, are in the paid versions.

## Features

- **Status and redirect report:** Shows status code, redirect hops and final URL per link.
- **CI-friendly exit code:** Returns 0 when all links work and 1 when any is broken.
- **MCP server included:** Lets Cursor, Claude Desktop and other MCP apps run checks without a key.
- **GitHub Action:** Also published on the GitHub Marketplace.
- **Standard-library checker:** Runs offline on your own computer using only built-in Python tools.

## Good for

- Find broken links in a documentation list before release
- Trace where old redirects end up
- Run a scheduled link check in CI
- Ask an AI assistant to verify URLs it has collected

## Install

### Claude Code (Terminal)

```sh
claude mcp add link-check-lite -- uvx link-check-lite
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "link-check-lite": {
      "command": "uvx",
      "args": [
        "link-check-lite"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "link-check-lite": {
      "command": "uvx",
      "args": [
        "link-check-lite"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "link-check-lite": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "link-check-lite"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "link-check-lite": {
      "command": "uvx",
      "args": [
        "link-check-lite"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "link-check-lite": {
      "command": "uvx",
      "args": [
        "link-check-lite"
      ]
    }
  }
}
```

## FAQ

### Is it free?

Yes. The lite version is free under the MIT license; paid versions add sitemaps, speed checks and reports.

### What does the paid version cost?

The site lists $7 on Gumroad, or about $0.001 per link on Apify.

### Which Python version is needed?

Python 3.10 or newer on Windows, Mac or Linux.

### Does it read sitemaps or CSV?

Not in the lite version, which only reads a plain text file.

### Why might a good link show as broken?

Some sites block bots and answer 403 or 429 even when the page opens in a browser.

### Is link-check-lite free?

Yes. link-check-lite is open source, so you can use and self-host it for free.

### How do I add link-check-lite to Claude Code?

Run this command in your terminal: claude mcp add link-check-lite -- uvx link-check-lite

### What are the best alternatives to link-check-lite?

The closest alternatives to link-check-lite are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.

---
Source: https://ai-powered.com/mcp/link-check-lite
