# 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"]
}
```