{
  "markdown": "<!-- mcp-name: io.github.carsonroell-debug/linkrescue-mcp -->\n\n# LinkRescue MCP Server\n\n[![PyPI](https://img.shields.io/pypi/v/linkrescue-mcp)](https://pypi.org/project/linkrescue-mcp/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![MCPize](https://img.shields.io/badge/MCPize-Install-22c55e)](https://mcpize.com/mcp/linkrescue-mcp?ref=YHCCR&utm_source=github&utm_medium=readme)\n\nFind broken affiliate links fast, prioritize by impact, and generate fix suggestions your AI agent can act on.\n\n**One call. 38+ affiliate networks checked. Revenue loss estimated.**\n\n> **One-click install:** [Install on MCPize](https://mcpize.com/mcp/linkrescue-mcp?ref=YHCCR&utm_source=github&utm_medium=readme) | `pip install linkrescue-mcp`\n\nLinkRescue 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.\n\n## What You Get\n\n- `check_broken_links`: scan a URL (or sitemap) and return a structured broken-link report\n- `monitor_links`: set up recurring monitoring for a website\n- `get_fix_suggestions`: generate prioritized remediation recommendations\n- `health_check`: verify MCP server and backend API connectivity\n\nIf the LinkRescue backend API is unreachable, the server falls back to realistic simulated data so local testing and demos keep working.\n\n## Quick Start\n\n```json\n{\n  \"mcpServers\": {\n    \"linkrescue\": {\n      \"command\": \"linkrescue-mcp\"\n    }\n  }\n}\n```\n\nThen ask your AI agent:\n\n> \"Scan example.com for broken affiliate links\"\n\n## Free vs Pro\n\n| Tool | Free | Pro ($19/mo) | Agency ($29/mo) |\n|------|------|--------------|-----------------|\n| `health_check` | Yes | Yes | Yes |\n| `check_broken_links` (up to 50 pages) | Yes | Yes | Yes |\n| `check_broken_links` (up to 2,000 pages) | - | Yes | Yes |\n| `check_broken_links` (unlimited + sitemap crawl) | - | - | Yes |\n| `get_fix_suggestions` | - | Yes | Yes |\n| `monitor_links` (daily) | - | Yes | Yes |\n| `monitor_links` (hourly + webhooks) | - | - | Yes |\n| Revenue loss estimates | - | Yes | Yes |\n| Multi-site monitoring | - | 5 sites | 25 sites |\n\nFree 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.\n\n**[Upgrade to Pro on MCPize](https://mcpize.com/mcp/linkrescue-mcp?ref=YHCCR&utm_source=github&utm_medium=readme)** — $19/mo or $190/yr. Agency $29/mo or $290/yr.\n\n## Install\n\n### MCPize (Recommended)\n\nOne-click install with managed hosting: **[Install on MCPize](https://mcpize.com/mcp/linkrescue-mcp?ref=YHCCR&utm_source=github&utm_medium=readme)**\n\n### PyPI\n\n```bash\npip install linkrescue-mcp\nlinkrescue-mcp\n```\n\n### From source\n\n```bash\ngit clone https://github.com/carsonroell-debug/linkrescue-mcp.git\ncd linkrescue-mcp\npip install -r requirements.txt\npython main.py\n```\n\nMCP endpoint:\n\n- `http://localhost:8000/mcp`\n\n## Configuration\n\n| Variable | Description | Default |\n|---|---|---|\n| `LINKRESCUE_API_BASE_URL` | Base URL for LinkRescue API | `http://localhost:3000/api/v1` |\n| `LINKRESCUE_API_KEY` | API key for authenticated requests | empty |\n\nExample:\n\n```bash\nexport LINKRESCUE_API_BASE_URL=\"https://www.linkrescue.io/api/v1\"\nexport LINKRESCUE_API_KEY=\"your-api-key\"\nlinkrescue-mcp\n```\n\nGet an API key at [linkrescue.io/settings/api](https://www.linkrescue.io/settings/api) (Pro and Agency tiers only).\n\n## Running Options\n\nRun via the installed entry point:\n\n```bash\nlinkrescue-mcp\n```\n\nRun directly from source:\n\n```bash\npython main.py\n```\n\nRun via FastMCP CLI:\n\n```bash\nfastmcp run main.py --transport streamable-http --port 8000\n```\n\n## Connect an MCP Client\n\n### Claude Desktop\n\nAdd this to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"linkrescue\": {\n      \"command\": \"linkrescue-mcp\"\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add linkrescue --transport http http://localhost:8000/mcp\n```\n\n## Try It\n\n```bash\nfastmcp list-tools main.py\nfastmcp call-tool main.py health_check '{}'\nfastmcp call-tool main.py check_broken_links '{\"url\":\"https://example.com\"}'\n```\n\n## Tool Inputs and Outputs\n\n### `check_broken_links`\n\nInputs:\n\n- `url` (required): site URL to scan\n- `sitemap_url` (optional, Agency tier): crawl from sitemap\n- `max_depth` (optional, default `3`): crawl depth\n\nReturns scan metadata, broken-link details, and summary statistics. Pro and Agency tiers include estimated monthly revenue loss for broken affiliate links.\n\n### `monitor_links`\n\nInputs:\n\n- `url` (required)\n- `frequency_hours` (optional, default `24`; Agency tier supports `1`)\n\nReturns monitoring ID, schedule details, and status. Free tier returns a simulated monitor (no persistence).\n\n### `get_fix_suggestions`\n\nInput:\n\n- full report from `check_broken_links`, or\n- raw `broken_links` array, or\n- JSON string of either format\n\nReturns prioritized actions and suggested remediation steps. Pro and Agency tiers only.\n\n### `health_check`\n\nNo input. Returns server status and backend API reachability.\n\n## Deployment\n\n### Smithery\n\nThis repo includes `smithery.yaml` and `smithery.json`.\n\n1. Push repository to GitHub\n2. Create/add server in [Smithery](https://smithery.ai/)\n3. Point Smithery to this repository\n\n### Docker / Hosting Platforms\n\nA `Dockerfile` is included for Railway, Fly.io, and other container hosts.\n\n```bash\n# Railway\nrailway up\n\n# Fly.io\nfly launch\nfly deploy\n```\n\nSet `LINKRESCUE_API_BASE_URL` and `LINKRESCUE_API_KEY` in your host environment.\n\n## Architecture\n\n```text\nAgent (Claude, Cursor, etc.)\n  -> MCP\nLinkRescue MCP Server (this repo)\n  -> HTTP API\nLinkRescue Backend API (linkrescue.io)\n```\n\nThis server is a translation layer between MCP tool calls and LinkRescue API operations.\n\n## License\n\nMIT — Built by [Freedom Engineers](https://freedomengineers.tech)\n\n## Related\n\n- [SelfHeal MCP](https://mcpize.com/mcp/selfheal-mcp?ref=YHCCR&utm_source=github&utm_medium=readme) — Self-healing proxy for MCP servers\n- [SiteHealth MCP](https://mcpize.com/mcp/sitehealth-mcp?ref=YHCCR&utm_source=github&utm_medium=readme) — Full website health audit\n- [LeadEnrich MCP](https://mcpize.com/mcp/leadenrich-mcp?ref=YHCCR&utm_source=github&utm_medium=readme) — Waterfall lead enrichment\n\n## Additional README Variants\n\n- Developer-focused version: `README.dev.md`\n- Marketplace-focused version: `README.marketplace.md`\n",
  "bytes": 6446,
  "sha": "122632b3de975cdda85df03f677ac7897fec0d7c4fd466af6082d313ffddd58d",
  "repo_slug": "carsonroell-debug/linkrescue-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_carsonroell_debug_linkrescue_m_095b5221/readme"
}