From ef9e7028050f95045453dbd3933d83901e03423b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jose=20Francisco=20=27Kiko=27=20Verd=C3=BA=20Gamb=C3=ADn?=
 <2096101+Kikobeats@users.noreply.github.com>
Date: Sun, 13 Sep 2026 10:06:48 +0200
Subject: [PATCH] fix(mcp): point README to live integration guide
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The README linked to https://microlink.io/integration/mcp, which returns
404; the live page is https://microlink.io/integrations/mcp. Add a
regression test asserting the canonical route.

Signed-off-by: Jose Francisco 'Kiko' Verdú Gambín <2096101+Kikobeats@users.noreply.github.com>
---
 packages/mcp/README.md                 |  2 +-
 packages/mcp/test/readme-links.test.js | 16 ++++++++++++++++
 2 files changed, 17 insertions(+), 1 deletion(-)
 create mode 100644 packages/mcp/test/readme-links.test.js

diff --git a/packages/mcp/README.md b/packages/mcp/README.md
index bc2de53..485c3c7 100644
--- a/packages/mcp/README.md
+++ b/packages/mcp/README.md
@@ -9,7 +9,7 @@ A [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that ex
 
 It turns natural-language requests into Microlink calls: take screenshots, generate PDFs, extract metadata or readable text, detect video/audio sources, run Lighthouse audits, and scrape custom fields with CSS selectors, all without leaving the assistant.
 
-See the [MCP integration page](https://microlink.io/integration/mcp) for a guided walkthrough, or the [`@microlink/mcp`](https://www.npmjs.com/package/@microlink/mcp) npm package.
+See the [MCP integration page](https://microlink.io/integrations/mcp) for a guided walkthrough, or the [`@microlink/mcp`](https://www.npmjs.com/package/@microlink/mcp) npm package.
 
 ## Table of contents
 
diff --git a/packages/mcp/test/readme-links.test.js b/packages/mcp/test/readme-links.test.js
new file mode 100644
index 0000000..ada4e50
--- /dev/null
+++ b/packages/mcp/test/readme-links.test.js
@@ -0,0 +1,16 @@
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import { readFile } from 'node:fs/promises'
+
+const README_URL_PATTERN = /https:\/\/microlink\.io[^\s)\]]*/g
+
+test('README uses the live MCP integration route', async () => {
+  const readme = await readFile(
+    new URL('../README.md', import.meta.url),
+    'utf8'
+  )
+  const urls = [...new Set(readme.match(README_URL_PATTERN) ?? [])]
+
+  assert.ok(urls.includes('https://microlink.io/integrations/mcp'))
+  assert.ok(!urls.includes('https://microlink.io/integration/mcp'))
+})