# LinkRescue MCP Server [](https://pypi.org/project/linkrescue-mcp/) [](https://opensource.org/licenses/MIT) [](https://mcpize.com/mcp/linkrescue-mcp?ref=YHCCR&utm_source=github&utm_medium=readme) Find broken affiliate links fast, prioritize by impact, and generate fix suggestions your AI agent can act on. **One call. 38+ affiliate networks checked. Silent tracking failures caught.** > **One-click install:** [Install on MCPize](https://mcpize.com/mcp/linkrescue-mcp?ref=YHCCR&utm_source=github&utm_medium=readme) | `pip install linkrescue-mcp` LinkRescue MCP exposes broken-link scanning, monitoring, and remediation workflows through the Model Context Protocol (MCP), so tools like Claude and Cursor can run link-health operations directly. ## What You Get - `check_broken_links`: scan a URL (or sitemap) and return a structured broken-link report - `monitor_links`: set up recurring monitoring for a website - `get_fix_suggestions`: generate prioritized remediation recommendations - `health_check`: verify MCP server and backend API connectivity If the LinkRescue backend API is unreachable, tools raise an error naming the endpoint they could not reach. They never return invented findings. For local testing, set `LINKRESCUE_DEMO_MODE=1` to get sample data — every simulated payload carries `"simulated": true` and an explicit warning. ## Hosted endpoint (no install) LinkRescue runs a remote MCP server at **`https://www.linkrescue.io/api/mcp`** (streamable HTTP). Get a free API key at [linkrescue.io/signup](https://www.linkrescue.io/signup), then point any remote-capable MCP client at it: ```json { "mcpServers": { "linkrescue": { "url": "https://www.linkrescue.io/api/mcp", "headers": { "Authorization": "Bearer lr_your_api_key" } } } } ``` The hosted server exposes `check_links`, `start_site_scan`, `get_scan` and `get_fix_suggestions`. It never returns simulated data. The stdio package below is for local and offline use. ## Quick Start ```json { "mcpServers": { "linkrescue": { "command": "linkrescue-mcp" } } } ``` Then ask your AI agent: > "Scan example.com for broken affiliate links" ## Free vs Pro | Tool | Free | Pro | Agency | |------|------|--------------|-----------------| | `health_check` | Yes | Yes | Yes | | `check_broken_links` (up to 50 pages) | Yes | Yes | Yes | | `check_broken_links` (up to 2,000 pages) | - | Yes | Yes | | `check_broken_links` (unlimited + sitemap crawl) | - | - | Yes | | `get_fix_suggestions` | - | Yes | Yes | | `monitor_links` (daily) | - | Yes | Yes | | `monitor_links` (hourly + webhooks) | - | - | Yes | | Multi-site monitoring | - | 5 sites | 25 sites | Free tier gives you single-page broken-link checks. Pro unlocks the full crawler + fix suggestions + recurring monitoring. Agency adds hourly checks, webhooks, and unlimited site count. Current pricing lives at **[linkrescue.io/pricing](https://www.linkrescue.io/pricing)** — that page is the single source of truth. [Install on MCPize](https://mcpize.com/mcp/linkrescue-mcp?ref=YHCCR&utm_source=github&utm_medium=readme). ## Install ### MCPize (Recommended) One-click install with managed hosting: **[Install on MCPize](https://mcpize.com/mcp/linkrescue-mcp?ref=YHCCR&utm_source=github&utm_medium=readme)** ### PyPI ```bash pip install linkrescue-mcp linkrescue-mcp ``` ### From source ```bash git clone https://github.com/carsonroell-debug/linkrescue-mcp.git cd linkrescue-mcp pip install -r requirements.txt python main.py ``` MCP endpoint: - `http://localhost:8000/mcp` ## Configuration | Variable | Description | Default | |---|---|---| | `LINKRESCUE_API_BASE_URL` | Base URL for LinkRescue API | `https://www.linkrescue.io/api/v1` | | `LINKRESCUE_API_KEY` | API key for authenticated requests | empty | | `LINKRESCUE_DEMO_MODE` | Return labelled sample data instead of erroring when the API is unreachable. Off by default — never enable against a real site. | empty (off) | Example: ```bash export LINKRESCUE_API_BASE_URL="https://www.linkrescue.io/api/v1" export LINKRESCUE_API_KEY="your-api-key" linkrescue-mcp ``` Get an API key at [linkrescue.io/settings/api](https://www.linkrescue.io/settings/api) (Pro and Agency tiers only). ## Running Options Run via the installed entry point: ```bash linkrescue-mcp ``` Run directly from source: ```bash python main.py ``` Run via FastMCP CLI: ```bash fastmcp run main.py --transport streamable-http --port 8000 ``` ## Connect an MCP Client ### Claude Desktop Add this to `claude_desktop_config.json`: ```json { "mcpServers": { "linkrescue": { "command": "linkrescue-mcp" } } } ``` ### Claude Code ```bash claude mcp add linkrescue --transport http http://localhost:8000/mcp ``` ## Try It ```bash fastmcp list-tools main.py fastmcp call-tool main.py health_check '{}' fastmcp call-tool main.py check_broken_links '{"url":"https://example.com"}' ``` ## Tool Inputs and Outputs ### `check_broken_links` Inputs: - `url` (required): site URL to scan - `sitemap_url` (optional, Agency tier): crawl from sitemap - `max_depth` (optional, default `3`): crawl depth Returns scan metadata, broken-link details, and summary statistics. Affiliate links that resolve but have lost their tracking parameters are reported as exposure — a count of links that earn nothing when clicked. LinkRescue does not estimate lost revenue; multiply by your own RPM. ### `monitor_links` Inputs: - `url` (required) - `frequency_hours` (optional, default `24`; Agency tier supports `1`) Returns monitoring ID, schedule details, and status. Free tier returns a simulated monitor (no persistence). ### `get_fix_suggestions` Input: - full report from `check_broken_links`, or - raw `broken_links` array, or - JSON string of either format Returns prioritized actions and suggested remediation steps. Pro and Agency tiers only. ### `health_check` No input. Returns server status and backend API reachability. ## Deployment ### Smithery This repo includes `smithery.yaml` and `smithery.json`. 1. Push repository to GitHub 2. Create/add server in [Smithery](https://smithery.ai/) 3. Point Smithery to this repository ### Docker / Hosting Platforms A `Dockerfile` is included for Railway, Fly.io, and other container hosts. ```bash # Railway railway up # Fly.io fly launch fly deploy ``` Set `LINKRESCUE_API_BASE_URL` and `LINKRESCUE_API_KEY` in your host environment. ## Architecture ```text Agent (Claude, Cursor, etc.) -> MCP LinkRescue MCP Server (this repo) -> HTTP API LinkRescue Backend API (linkrescue.io) ``` This server is a translation layer between MCP tool calls and LinkRescue API operations. ## License MIT — Built by [Freedom Engineers](https://freedomengineers.tech) ## Related - [SelfHeal MCP](https://mcpize.com/mcp/selfheal-mcp?ref=YHCCR&utm_source=github&utm_medium=readme) — Self-healing proxy for MCP servers - [SiteHealth MCP](https://mcpize.com/mcp/sitehealth-mcp?ref=YHCCR&utm_source=github&utm_medium=readme) — Full website health audit - [LeadEnrich MCP](https://mcpize.com/mcp/leadenrich-mcp?ref=YHCCR&utm_source=github&utm_medium=readme) — Waterfall lead enrichment ## Additional README Variants - Developer-focused version: `README.dev.md` - Marketplace-focused version: `README.marketplace.md`