linkrescue-mcp
LinkRescue MCP lets AI agents find, prioritize, and fix broken affiliate links through MCP tools.
check_broken_links: Scan a URL or sitemap for broken links; returns a structured report with HTTP status codes, discovering page, link type, SEO impact, and estimated revenue loss.
monitor_links: Set up recurring broken-link monitoring (default every 24 hours; hourly on Agency tier) and track new, fixed, or worsening link issues.
get_fix_suggestions: Generate prioritized remediation actions from a scan report, including recommended actions, explanations, and code snippets.
health_check: Verify MCP server status, backend API reachability, and current configuration.
Provides container deployment capability through included Dockerfile for hosting on container platforms, enabling portable deployment of the LinkRescue MCP server.
Supports deployment to Fly.io hosting platform via included Dockerfile, allowing cloud hosting of the LinkRescue MCP server for production use.
Enables repository hosting and integration with GitHub for source code management, with specific deployment workflows via Smithery when pushing to GitHub.
Supports package distribution and installation via PyPI, with published package available for installation through Python package management.
Provides runtime environment for the MCP server implementation, with Python 3.11+ requirement for executing the LinkRescue MCP server.
Supports deployment to Railway hosting platform via included Dockerfile, enabling cloud deployment and hosting of the LinkRescue MCP server.
Provides badge generation for PyPI version and license status display in the README documentation.
Provides configuration format for deployment via Smithery with included smithery.yaml file for deployment automation.
LinkRescue MCP Server
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 |
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 reportmonitor_links: set up recurring monitoring for a websiteget_fix_suggestions: generate prioritized remediation recommendationshealth_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.
Related MCP server: webcheck-mcp
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, then point any
remote-capable MCP client at it:
{
"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
{
"mcpServers": {
"linkrescue": {
"command": "linkrescue-mcp"
}
}
}Then ask your AI agent:
"Scan example.com for broken affiliate links"
Free vs Pro
Tool | Free | Pro | Agency |
| Yes | Yes | Yes |
| Yes | Yes | Yes |
| - | Yes | Yes |
| - | - | Yes |
| - | Yes | Yes |
| - | Yes | Yes |
| - | - | 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 — that page is the single source of truth. Install on MCPize.
Install
MCPize (Recommended)
One-click install with managed hosting: Install on MCPize
PyPI
pip install linkrescue-mcp
linkrescue-mcpFrom source
git clone https://github.com/carsonroell-debug/linkrescue-mcp.git
cd linkrescue-mcp
pip install -r requirements.txt
python main.pyMCP endpoint:
http://localhost:8000/mcp
Configuration
Variable | Description | Default |
| Base URL for LinkRescue API |
|
| API key for authenticated requests | empty |
| Return labelled sample data instead of erroring when the API is unreachable. Off by default — never enable against a real site. | empty (off) |
Example:
export LINKRESCUE_API_BASE_URL="https://www.linkrescue.io/api/v1"
export LINKRESCUE_API_KEY="your-api-key"
linkrescue-mcpGet an API key at linkrescue.io/settings/api (Pro and Agency tiers only).
Running Options
Run via the installed entry point:
linkrescue-mcpRun directly from source:
python main.pyRun via FastMCP CLI:
fastmcp run main.py --transport streamable-http --port 8000Connect an MCP Client
Claude Desktop
Add this to claude_desktop_config.json:
{
"mcpServers": {
"linkrescue": {
"command": "linkrescue-mcp"
}
}
}Claude Code
claude mcp add linkrescue --transport http http://localhost:8000/mcpTry It
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 scansitemap_url(optional, Agency tier): crawl from sitemapmax_depth(optional, default3): 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, default24; Agency tier supports1)
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, orraw
broken_linksarray, orJSON 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.
Push repository to GitHub
Create/add server in Smithery
Point Smithery to this repository
Docker / Hosting Platforms
A Dockerfile is included for Railway, Fly.io, and other container hosts.
# Railway
railway up
# Fly.io
fly launch
fly deploySet LINKRESCUE_API_BASE_URL and LINKRESCUE_API_KEY in your host environment.
Architecture
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
Related
SelfHeal MCP — Self-healing proxy for MCP servers
SiteHealth MCP — Full website health audit
LeadEnrich MCP — Waterfall lead enrichment
Additional README Variants
Developer-focused version:
README.dev.mdMarketplace-focused version:
README.marketplace.md
Available Tools
4 toolscheck_broken_linksA
Scans a single URL or entire site/sitemap for broken links.
Returns a structured report with every broken link found, its HTTP status code, the page it was discovered on, link type (affiliate/external/internal), SEO impact rating, and estimated revenue loss.
Agents can pass the output directly to get_fix_suggestions for remediation steps.
Inputs: url (required), sitemap_url, max_depth. Returns: object
get_fix_suggestionsA
Given a broken links report, returns prioritized remediation suggestions.
Each suggestion includes the broken URL, a recommended action (update link, follow redirect, remove, etc.), a human-readable explanation, and a code snippet where applicable.
Accepts either the full JSON report from check_broken_links or just the broken_links array.
Inputs: broken_links_report (required). Returns: object
health_checkA
Confirms the LinkRescue MCP server is alive and can reach the backend API.
Use this to verify connectivity before running scans. Returns server status, API reachability, and current configuration.
Inputs: no named parameters. Returns: object
monitor_linksA
Sets up ongoing broken-link monitoring for a website.
The monitor runs on a schedule (default: every 24 hours) and will detect new broken links, links that were fixed, and changes in site health score.
Returns a monitoring_id you can reference later to check status or cancel.
Inputs: url (required), frequency_hours. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose: check_broken_links for scanning, get_fix_suggestions for remediation, health_check for connectivity, and monitor_links for ongoing monitoring. There is no overlap or ambiguity in their functions.
The tools follow a consistent verb_noun pattern (check_broken_links, get_fix_suggestions, monitor_links), with one minor deviation (health_check uses noun_verb). This is mostly consistent and readable.
With 4 tools, the server is well-scoped for its purpose of broken link detection and management. Each tool earns its place, covering scanning, remediation, monitoring, and health checks without being too sparse or bloated.
The tool set provides complete coverage for the domain: check_broken_links for detection, get_fix_suggestions for remediation, monitor_links for ongoing tracking, and health_check for connectivity. There are no obvious gaps, and agents can follow a full workflow from scan to fix to monitoring.
Maintenance
Related MCP Connectors
Free MCP server that audits any public URL: technical SEO, Core Web Vitals, indexing checks.
Security, SEO and AI-visibility scanner for web apps · free scans and focused checks via MCP.
Unified 15-tool SEO, SERP, clean Markdown & GEO (LLM citation Share-of-Voice) MCP server.
Network, domain and website diagnostics for AI clients via MCP.
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceMCP server for website SEO + GEO analysis. Scan any URL to get scores across 5 categories (SEO, GEO, Performance, Security, Accessibility) with actionable fix recommendations. Enables AI coding assistants to audit websites and implement fixes autonomously.-
- AlicenseNot gradedqualityDmaintenanceWebsite health checker MCP server - SEO audit, accessibility scan, broken link detection, performance analysis, and page comparison.47 npm3MIT
- AlicenseNot gradedqualityDmaintenanceDead link checker MCP server - find broken links, redirects, and timeouts on any website. Free tier: 30 links/scan.6 npmMIT
- AlicenseNot gradedqualityFmaintenanceAn MCP server that lets AI assistants check single URLs, scan HTML content, and crawl entire websites for broken links via four tools.MIT