# bulk-url-checker MCP server

> Allows an AI client to perform large-scale HTTP status checks, detect broken links, and analyze redirect chains using managed residential proxies.

- Repository: https://github.com/carlosofscience/bulkurlchecker-python
- Page: https://hostedmcp.org/servers/carlosofscience/bulkurlchecker-python
- Transport: remote
- Stars: 0
- License: MIT
- Latest version: 1.0.1

## Install

### Claude Code

```sh
claude mcp add --transport http bulkurlchecker-python https://mcp.bulkurlchecker.com/mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "bulkurlchecker-python": {
      "url": "https://mcp.bulkurlchecker.com/mcp"
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "bulkurlchecker-python": {
      "type": "http",
      "url": "https://mcp.bulkurlchecker.com/mcp"
    }
  }
}
```

### Codex (`~/.codex/config.toml`)

```toml
[mcp_servers.bulkurlchecker-python]
url = "https://mcp.bulkurlchecker.com/mcp"
```

### Gemini CLI (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "bulkurlchecker-python": {
      "httpUrl": "https://mcp.bulkurlchecker.com/mcp"
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `BULKURLCHECKER_API_KEY` | no | no |  |

## FAQ

### Is there a free tier available?

Yes, the first 300 URLs are free and no credit card is required to start.

### How can I prevent duplicate jobs if a network error occurs during submission?

You can pass an idempotency key to the submit or check_urls methods to ensure retries return the original result without creating a duplicate.

### Can the service detect if a page is a 'soft 404'?

Yes, the engine can flag pages that return a 200 OK status but contain 'not found' content.