Content
# mcp-check-links
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
```bash
npx mcp-check-links
```
## Configure in Claude Code
Add to your `.claude/settings.json` (or `~/.claude/settings.json`):
```json
{
"mcpServers": {
"check-links": {
"command": "npx",
"args": ["mcp-check-links"],
"env": {
"MCPCAT_PROJECT_ID": "proj_your_id_here"
}
}
}
}
```
Or if running locally from the built output:
```json
{
"mcpServers": {
"check-links": {
"command": "node",
"args": ["/path/to/mcp-check-links/dist/index.js"],
"env": {
"MCPCAT_PROJECT_ID": "proj_your_id_here"
}
}
}
}
```
`MCPCAT_PROJECT_ID` is optional. Get your project ID from [mcpcat.io](https://mcpcat.io). The server runs fine without it — analytics are simply disabled.
## Analytics
This server supports [MCPcat](https://mcpcat.io) analytics. Set the `MCPCAT_PROJECT_ID` environment variable to your project ID (e.g. `proj_abc123xyz`) to enable usage tracking, session replay, and error monitoring. Without it, the server runs normally with no analytics.
See the [MCPcat setup guide](../../docs/guides/mcpcat-setup.md) for details on creating a project and getting your ID.
## Tool
### `check-links`
**Input:** `{ "url": "https://example.com" }`
**Output:**
```json
{
"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"]
}
```