Uncover broken links in your content.

Linkspector

Linkspector is a CLI tool that checks for dead hyperlinks in your files. It supports Markdown and AsciiDoc, with a rich interactive TUI for local use and clean output for CI/CD pipelines. Now, with the Linkspector MCP Server, you can integrate link checking directly into your AI agent workflows.

Linkspector MCP Server

An MCP (Model Context Protocol) server that exposes Linkspector as a tool for AI agents. Check for broken hyperlinks in Markdown and AsciiDoc files directly from Claude, Cursor, VS Code Copilot, and other MCP-compatible clients.

Tools

check_links

Check for broken hyperlinks and get detailed results in RDJSON format with file paths, line numbers, URLs, and HTTP status codes.

Parameters:

• directory (optional) — Directory to check. Defaults to current working directory.
• config (optional) — Path to a custom .linkspector.yml configuration file.

check_links_summary

Quick pass/fail check with statistics. Faster to process than full results.

Parameters:

• directory (optional) — Directory to check. Defaults to current working directory.
• config (optional) — Path to a custom .linkspector.yml configuration file.

Installation

npm install -g @umbrelladocs/linkspector-mcp

Configuration

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "linkspector": {
      "command": "linkspector-mcp"
    }
  }
}

Claude Code

claude mcp add linkspector -- linkspector-mcp

VS Code / Cursor

Add to your MCP settings:

{
  "mcpServers": {
    "linkspector": {
      "command": "linkspector-mcp"
    }
  }
}

Development

npm install
npm run build

License

Apache-2.0