From a363e6d7171da622d6934225cd46f0742a1a3e55 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:09:14 +0200
Subject: [PATCH] docs(mcp): state Node.js prerequisite
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

@microlink/mcp declares engines.node >= 24; a clean npx run on an older
Node warns EBADENGINE and fails outright under engine-strict. Say so in
the README, with a test deriving the minimum from package.json.

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

diff --git a/packages/mcp/README.md b/packages/mcp/README.md
index bc2de53..63ced0b 100644
--- a/packages/mcp/README.md
+++ b/packages/mcp/README.md
@@ -23,6 +23,8 @@ See the [MCP integration page](https://microlink.io/integration/mcp) for a guide
 
 ## Install
 
+Requires Node.js 24 or newer.
+
 ### Use the published package (recommended)
 
 No local installation is required. Run directly with `npx`:
diff --git a/packages/mcp/test/readme-requirements.test.js b/packages/mcp/test/readme-requirements.test.js
new file mode 100644
index 0000000..74a83aa
--- /dev/null
+++ b/packages/mcp/test/readme-requirements.test.js
@@ -0,0 +1,18 @@
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import { readFile } from 'node:fs/promises'
+
+const readJson = async path =>
+  JSON.parse(await readFile(new URL(path, import.meta.url), 'utf8'))
+
+test('README states the package Node.js requirement', async () => {
+  const readme = await readFile(
+    new URL('../README.md', import.meta.url),
+    'utf8'
+  )
+  const pkg = await readJson('../package.json')
+  const minimumNode = pkg.engines.node.match(/\d+/)?.[0]
+
+  assert.ok(minimumNode)
+  assert.match(readme, new RegExp(`Node\\.js ${minimumNode} or newer`))
+})