@microlink/mcp 2.0.0 → 2.0.3

package/package.json

@@ -2,7 +2,7 @@
   "name": "@microlink/mcp",
   "description": "MCP server for Microlink API",
   "homepage": "https://github.com/microlinkhq/microlink",
-  "version": "2.0.0",
+  "version": "2.0.3",
   "main": "./src/index.js",
   "exports": {
     ".": "./src/index.js"
@@ -45,7 +45,7 @@
   "dependencies": {
     "@microlink/mql": "0.18.0",
     "@modelcontextprotocol/sdk": "1.30.0",
-    "microlink.io": "0.0.4",
+    "microlink.io": "0.1.1",
     "zod": "~4.4.3"
   },
   "engines": {
@@ -66,5 +66,5 @@
     "access": "public"
   },
   "type": "module",
-  "gitHead": "13e0818cc80bca85a19f16837095bd7d6b31f76a"
+  "gitHead": "a12fcd2a7bc918e741a71b50fd2cd93876f4ca8f"
 }

package/src/schemas.js

@@ -120,6 +120,7 @@ export const screenshotConfigSchema = objectLikeSchema(
       optimizeForSpeed: booleanSchema.optional(),
       overlay: screenshotOverlaySchema.optional(),
       palette: booleanSchema.optional(),
+      quality: z.number().min(0).max(100).optional(),
       type: z.enum(['jpeg', 'png']).optional()
     })
     .strict()
@@ -227,12 +228,15 @@ const fullShape = {
   ping: toggledObjectSchema.optional()
 }
 
-const visualSchema = {
+// Shared Microlink API query parameters (see microlink.io/docs/api/parameters).
+// Product tools layer their own fields on top; these apply to any URL fetch.
+// `data` is separate: content/collection helpers overwrite it with their field rule.
+const browserSchema = {
   adblock: booleanSchema.optional(),
   animations: booleanSchema.optional(),
+  cacheKey: z.string().min(1).optional(),
   click: stringOrStringArraySchema.optional(),
   colorScheme: z.enum(['no-preference', 'light', 'dark']).optional(),
-  data: objectLikeSchema(z.record(z.string(), dataRuleSchema)).optional(),
   device: z.string().min(1).optional(),
   filename: z.string().min(1).optional(),
   filter: z.string().min(1).optional(),
@@ -260,6 +264,11 @@ const visualSchema = {
     .optional()
 }
 
+const visualSchema = {
+  ...browserSchema,
+  data: objectLikeSchema(z.record(z.string(), dataRuleSchema)).optional()
+}
+
 export const extractInputSchema = baseSchema
   .extend(fullShape)
   .extend(visualSchema)
@@ -287,35 +296,40 @@ export const pdfInputSchema = baseSchema
   .strict()
 
 export const audioInputSchema = baseSchema
+  .extend(visualSchema)
   .extend({
-    proxy: proxySchema.optional(),
     meta: z.union([booleanSchema, metaConfigSchema]).optional(),
     audio: booleanSchema.optional()
   })
   .strict()
 
 export const videoInputSchema = baseSchema
+  .extend(visualSchema)
   .extend({
-    proxy: proxySchema.optional(),
     meta: z.union([booleanSchema, metaConfigSchema]).optional(),
     video: booleanSchema.optional()
   })
   .strict()
 
 export const logoInputSchema = baseSchema
+  .extend(visualSchema)
   .extend({
-    square: booleanSchema.optional()
+    square: booleanSchema.optional(),
+    palette: booleanSchema.optional()
   })
   .strict()
 
 export const metadataInputSchema = baseSchema
+  .extend(visualSchema)
   .extend({
-    meta: z.union([booleanSchema, metaConfigSchema]).optional()
+    meta: z.union([booleanSchema, metaConfigSchema]).optional(),
+    palette: booleanSchema.optional()
   })
   .strict()
 
 // Content tools (markdown/html/text) accept a selector to scope the extraction.
 const contentSchema = baseSchema
+  .extend(browserSchema)
   .extend({
     selector: selectorSchema.optional(),
     selectorAll: selectorSchema.optional(),
@@ -325,6 +339,7 @@ const contentSchema = baseSchema
 
 // Collection tools accept selector/attr/type overrides for the data rule.
 const collectionSchema = baseSchema
+  .extend(browserSchema)
   .extend({
     selector: selectorSchema.optional(),
     selectorAll: selectorSchema.optional(),
@@ -340,6 +355,7 @@ export const htmlInputSchema = contentSchema
 export const textInputSchema = contentSchema
 
 export const embedInputSchema = baseSchema
+  .extend(visualSchema)
   .extend({
     maxWidth: z.coerce.number().int().positive().optional(),
     maxHeight: z.coerce.number().int().positive().optional()
@@ -356,9 +372,10 @@ export const audiosInputSchema = collectionSchema
 
 export const emailsInputSchema = collectionSchema
 
-export const technologiesInputSchema = baseSchema.strict()
+export const technologiesInputSchema = baseSchema.extend(visualSchema).strict()
 
 export const lighthouseInputSchema = baseSchema
+  .extend(visualSchema)
   .extend({
     onlyCategories: z.array(z.string().min(1)).optional(),
     onlyAudits: z.array(z.string().min(1)).optional(),
@@ -392,6 +409,7 @@ export const searchInputSchema = z
   .strict()
 
 export const functionInputSchema = baseSchema
+  .extend(visualSchema)
   .extend({
     code: z.string().min(1)
   })

package/src/tools/function.js

@@ -8,6 +8,7 @@ export function fn (server) {
     [
       'Run a JavaScript function against any public URL inside Microlink’s server-side browser sandbox.',
       'Pass `code` as the function source (e.g. "async ({ page }) => page.title()"); it receives `{ page, response, ...args }` and its return value comes back in `value`.',
+      'Combine with browser options such as `javascript`, `waitUntil`, `waitForSelector`, `click`, `scroll`, `headers`, and `proxy`.',
       'Also returns `isFulfilled`, `profiling`, and `logging`. Mirrors the `microlink.function(url, code)` library method.'
     ].join(' '),
     functionInputSchema,

package/src/tools/html.js

@@ -8,6 +8,7 @@ export function html (server) {
     [
       'Extract the HTML content of any public URL via Microlink.',
       'Returns the page HTML as a string. Pass `selector` to scope it to part of the page.',
+      'Combine with browser options such as `javascript`, `waitUntil`, `waitForSelector`, `headers`, and `proxy`.',
       'Mirrors the `microlink.html(url)` library method.'
     ].join(' '),
     htmlInputSchema,

package/src/tools/markdown.js

@@ -8,6 +8,7 @@ export function markdown (server) {
     [
       'Convert any public URL to Markdown via Microlink.',
       'Returns the page content as a Markdown string. Pass `selector` to scope it to part of the page.',
+      'Combine with browser options such as `javascript`, `waitUntil`, `waitForSelector`, `headers`, and `proxy`.',
       'Mirrors the `microlink.markdown(url)` library method.'
     ].join(' '),
     markdownInputSchema,

package/src/tools/text.js

@@ -8,6 +8,7 @@ export function text (server) {
     [
       'Extract the plain text of any public URL via Microlink.',
       'Returns the readable page text as a string. Pass `selector` to scope it to part of the page.',
+      'Combine with browser options such as `javascript`, `waitUntil`, `waitForSelector`, `headers`, and `proxy`.',
       'Mirrors the `microlink.text(url)` library method.'
     ].join(' '),
     textInputSchema,