io.github.webmoleai/mcp-check-links
Find broken links, missing meta tags, and redirect chains on any website.
Open source Open in the app JSON README (API)
About
Find broken links, missing meta tags, and redirect chains on any website.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- webmoleai
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.2.0
- Stars
- 1
- Last push
- 2026-04-07T11:53:57Z
- Repository state
- ativo
- Language
- JavaScript
- Added
- 2026-08-29 04:01:39
- Updated
- 2026-08-29 04:01:39
- Origin id
io.github.webmoleai/mcp-check-links
README
# 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"]
}
```