About mcp-link-doctor
mcp-link-doctor is an MCP server for checking website links and metadata. It returns a structured report with a health score and suggestions for fixes.
Key features
- 01Checks links for 4xx/5xx errors
- 02Detects missing metadata tags
- 03Traces redirect chains
- 04Provides a score and fix suggestions
Use cases
- 01Audit a page for broken links
- 02Find missing social or SEO metadata
- 03Identify excessive redirect hops
MCP support
The MCP server exposes a `check-links` tool that accepts a URL and returns link, metadata, redirect, score, and suggestion data.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
1Saved tool list · updated 3w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| url | string | Yes | The URL of the website to analyze |
Details
From the project READMEmcp-link-doctor
An MCP server that analyzes websites for broken links, missing meta tags, and redirect chains. Returns a structured report with a health score and fix suggestions.
What it does
- Checks all links on a page for 4xx/5xx errors (up to 20 links)
- Detects missing meta tags: title, description, og:title, og:description, og:image, canonical, viewport
- Traces redirect chains and flags excessive hops
- Returns a score (0–100) and actionable suggestions
Install
npx mcp-link-doctor
Configure in Claude Code
Add to your .claude/settings.json (or ~/.claude/settings.json):
{
"mcpServers": {
"mcp-link-doctor": {
"command": "npx",
"args": ["mcp-link-doctor"],
"env": {
"MCPCAT_PROJECT_ID": "proj_your_id_here"
}
}
}
}
Or if running locally from the built output:
{
"mcpServers": {
"mcp-link-doctor": {
"command": "node",
"args": ["/path/to/mcp-link-doctor/dist/index.js"],
"env": {
"MCPCAT_PROJECT_ID": "proj_your_id_here"
}
}
}
}
MCPCAT_PROJECT_ID is optional. Get your project ID from mcpcat.io. The server runs fine without it — analytics are simply disabled.
Tool
check-links
Input: { "url": "https://example.com" }
Output:
{
"url": "https://example.com",
"brokenLinks": [{"href": "...", "status": 404, "text": "..."}],
"missingMetaTags": ["og:image", "canonical"],
"presentMetaTags": {"title": "...", "description": "..."},
"redirectChain": ["https://example.com -> https://www.example.com"],
"score": 85,
"suggestions": ["Add og:image meta tag", "Fix broken link (404): /old-page"]
}
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.