@microlink/mcp 2.1.11 → 2.2.0

package/package.json

@@ -2,7 +2,7 @@
   "name": "@microlink/mcp",
   "description": "MCP server for Microlink API",
   "homepage": "https://github.com/microlinkhq/microlink",
-  "version": "2.1.11",
+  "version": "2.2.0",
   "main": "./src/index.js",
   "exports": {
     ".": "./src/index.js"
@@ -45,7 +45,7 @@
   "dependencies": {
     "@microlink/mql": "0.19.0",
     "@modelcontextprotocol/sdk": "1.30.0",
-    "microlink.io": "0.10.2",
+    "microlink.io": "0.10.3",
     "zod": "~4.4.3"
   },
   "engines": {
@@ -66,5 +66,5 @@
     "access": "public"
   },
   "type": "module",
-  "gitHead": "f7e00ece88868167e449fc6c26db3bfc59db2cec"
+  "gitHead": "6a9b3891741143671b096d53c0d9e69f6b62cb94"
 }

package/src/tools/function.js

@@ -1,5 +1,5 @@
 import { functionInputSchema } from '../schemas.js'
-import { register } from './register.js'
+import { INTERACTIVE_ANNOTATIONS, register } from './register.js'
 
 export function fn (server) {
   register(
@@ -12,6 +12,7 @@ export function fn (server) {
       'Also returns `isFulfilled`, `profiling`, and `logging`. Mirrors the `microlink.function(url, code)` library method.'
     ].join(' '),
     functionInputSchema,
-    (client, { url, code, ...options }) => client.function(url, code, options)
+    (client, { url, code, ...options }) => client.function(url, code, options),
+    INTERACTIVE_ANNOTATIONS
   )
 }

package/src/tools/register.js

@@ -39,6 +39,20 @@ function getApiKeyFromRequestHeaders (headers) {
   return undefined
 }
 
+// Every tool is a remote read against the Microlink API: it never modifies
+// the caller's environment. `microlink_function` is the exception: it runs
+// caller-supplied code against the live page, so it is not declared read-only.
+const READ_ONLY_ANNOTATIONS = {
+  readOnlyHint: true,
+  destructiveHint: false,
+  openWorldHint: true
+}
+
+export const INTERACTIVE_ANNOTATIONS = {
+  readOnlyHint: false,
+  openWorldHint: true
+}
+
 // Common shape: a tool that maps to `client.<method>(url, options)`.
 export function urlMethod (method) {
   return (client, { url, ...options }) => client[method](url, options)
@@ -57,29 +71,29 @@ export function capabilityMethod (method, key) {
   }
 }
 
-export function register (server, name, description, inputSchema, invoke) {
+export function register (
+  server,
+  name,
+  description,
+  inputSchema,
+  invoke,
+  annotations = READ_ONLY_ANNOTATIONS
+) {
   server.registerTool(
     name,
-    { description, inputSchema },
+    { description, inputSchema, annotations },
     async (args, extra) => {
       const parsed = inputSchema.safeParse(args)
 
       if (!parsed.success) {
+        const payload = {
+          message: 'Input validation failed.',
+          issues: parsed.error.issues
+        }
         return {
           isError: true,
-          content: [
-            {
-              type: 'text',
-              text: JSON.stringify(
-                {
-                  message: 'Input validation failed.',
-                  issues: parsed.error.issues
-                },
-                null,
-                2
-              )
-            }
-          ]
+          structuredContent: { error: payload },
+          content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }]
         }
       }