@microlink/mcp 2.1.12 → 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.12",
+  "version": "2.2.0",
   "main": "./src/index.js",
   "exports": {
     ".": "./src/index.js"
@@ -66,5 +66,5 @@
     "access": "public"
   },
   "type": "module",
-  "gitHead": "ad16e1cbd956569c8b7c47e50c9d2a4b828f4526"
+  "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,10 +71,17 @@ 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)