@j0hanz/superfetch 2.4.4 → 2.4.5

package/dist/config.d.ts

@@ -48,6 +48,7 @@ export declare const config: {
         metadataFormat: TransformMetadataFormat;
     };
     tools: {
+        enabled: string[];
         timeoutMs: number;
     };
     cache: {

package/dist/config.js

@@ -204,6 +204,7 @@ export const config = {
         metadataFormat: parseTransformMetadataFormat(process.env.TRANSFORM_METADATA_FORMAT),
     },
     tools: {
+        enabled: parseList(process.env.ENABLED_TOOLS ?? 'fetch-url'),
         timeoutMs: parseInteger(process.env.TOOL_TIMEOUT_MS, DEFAULT_TOOL_TIMEOUT_MS, 1000, 300000),
     },
     cache: {

package/dist/mcp.js

@@ -220,6 +220,26 @@ function registerTaskHandlers(server) {
         });
     });
 }
+function registerPrompts(server) {
+    if (config.tools.enabled.includes(FETCH_URL_TOOL_NAME)) {
+        server.registerPrompt('summarize-webpage', {
+            description: 'Summarize the content of a webpage given its URL.',
+            argsSchema: {
+                url: z.string().describe('The URL to summarize'),
+            },
+        }, (args) => ({
+            messages: [
+                {
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: `Please summarize the content of the webpage at the following URL: ${args.url}`,
+                    },
+                },
+            ],
+        }));
+    }
+}
 export function createMcpServer() {
     const instructions = createServerInstructions(config.server.version);
     const server = new McpServer(createServerInfo(), {
@@ -228,11 +248,12 @@ export function createMcpServer() {
     });
     setMcpServer(server);
     const localIcons = getLocalIcons();
-    registerTools(server, localIcons);
+    registerTools(server);
     registerCachedContentResource(server, localIcons);
     registerInstructionsResource(server, instructions);
     registerConfigResource(server);
     registerTaskHandlers(server);
+    registerPrompts(server);
     return server;
 }
 function attachServerErrorHandler(server) {

package/dist/tools.d.ts

@@ -1,6 +1,5 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { CallToolResult, ContentBlock } from '@modelcontextprotocol/sdk/types.js';
-import * as cache from './cache.js';
 import type { MarkdownTransformResult } from './transform-types.js';
 export interface FetchUrlInput {
     url: string;
@@ -73,7 +72,7 @@ export interface ToolHandlerExtra {
     sendNotification?: (notification: ProgressNotification) => Promise<void>;
 }
 export declare const FETCH_URL_TOOL_NAME = "fetch-url";
-export declare const FETCH_URL_TOOL_DESCRIPTION = "Fetches a webpage and converts it to clean Markdown format";
+export declare const FETCH_URL_TOOL_DESCRIPTION: string;
 interface ProgressReporter {
     report: (progress: number, message: string) => Promise<void>;
 }
@@ -119,5 +118,5 @@ type MarkdownPipelineResult = MarkdownTransformResult & {
 export declare function parseCachedMarkdownResult(cached: string): MarkdownPipelineResult | undefined;
 export declare function fetchUrlToolHandler(input: FetchUrlInput, extra?: ToolHandlerExtra): Promise<ToolResponseBase>;
 export declare function withRequestContextIfMissing<TParams, TResult, TExtra = unknown>(handler: (params: TParams, extra?: TExtra) => Promise<TResult>): (params: TParams, extra?: TExtra) => Promise<TResult>;
-export declare function registerTools(server: McpServer, serverIcons?: cache.McpIcon[]): void;
+export declare function registerTools(server: McpServer): void;
 export {};

package/dist/tools.js

@@ -15,7 +15,7 @@ const fetchUrlInputSchema = z.strictObject({
         .url({ protocol: /^https?$/i })
         .min(1)
         .max(config.constants.maxUrlLength)
-        .describe('The URL to fetch'),
+        .describe('The URL of the webpage to fetch and convert to Markdown'),
 });
 const fetchUrlOutputSchema = z.strictObject({
     url: z
@@ -46,7 +46,23 @@ const fetchUrlOutputSchema = z.strictObject({
         .describe('Error message if the request failed'),
 });
 export const FETCH_URL_TOOL_NAME = 'fetch-url';
-export const FETCH_URL_TOOL_DESCRIPTION = 'Fetches a webpage and converts it to clean Markdown format';
+export const FETCH_URL_TOOL_DESCRIPTION = `
+Fetches a webpage and converts it to clean Markdown format optimized for LLM context.
+
+This tool is useful for:
+- Reading documentation, blog posts, or articles.
+- Extracting main content while removing navigation and ads (noise removal).
+- Caching content to speed up repeated queries.
+
+Limitations:
+- Returns truncated content if it exceeds ${config.constants.maxInlineContentChars} characters.
+- Does not execute complex client-side JavaScript interactions.
+`.trim();
+// Specific icon for the fetch-url tool (download cloud / web)
+const TOOL_ICON = {
+    src: 'data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0ibm9uZSIgc3Ryb2tlPSJjdXJyZW50Q29sb3IiIHN0cm9rZS13aWR0aD0iMiIgc3Ryb2tlLWxpbmVjYXA9InJvdW5kIiBzdHJva2UtbGluZWpvaW49InJvdW5kIj48cGF0aCBkPSJNMjEgMTV2NGEyIDIgMCAwIDEtMiAySDVhMiAyIDAgMCAxLTItMnYtNCIvPjxwb2x5bGluZSBwb2ludHM9IjcgMTAgMTIgMTUgMTcgMTAiLz48bGluZSB4MT0iMTIiIHkxPSIxNSIgeDI9IjEyIiB5Mj0iMyIvPjwvc3ZnPg==',
+    mimeType: 'image/svg+xml',
+};
 /* -------------------------------------------------------------------------------------------------
  * Progress reporting
  * ------------------------------------------------------------------------------------------------- */
@@ -512,13 +528,16 @@ function resolveRequestIdFromExtra(extra) {
         return String(requestId);
     return undefined;
 }
-export function registerTools(server, serverIcons) {
-    server.registerTool(TOOL_DEFINITION.name, {
-        title: TOOL_DEFINITION.title,
-        description: TOOL_DEFINITION.description,
-        inputSchema: TOOL_DEFINITION.inputSchema,
-        outputSchema: TOOL_DEFINITION.outputSchema,
-        annotations: TOOL_DEFINITION.annotations,
-        ...(serverIcons ? { icons: serverIcons } : {}),
-    }, withRequestContextIfMissing(TOOL_DEFINITION.handler));
+export function registerTools(server) {
+    if (config.tools.enabled.includes(FETCH_URL_TOOL_NAME)) {
+        server.registerTool(TOOL_DEFINITION.name, {
+            title: TOOL_DEFINITION.title,
+            description: TOOL_DEFINITION.description,
+            inputSchema: TOOL_DEFINITION.inputSchema,
+            outputSchema: TOOL_DEFINITION.outputSchema,
+            annotations: TOOL_DEFINITION.annotations,
+            // Use specific tool icon here
+            icons: [TOOL_ICON],
+        }, withRequestContextIfMissing(TOOL_DEFINITION.handler));
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@j0hanz/superfetch",
-  "version": "2.4.4",
+  "version": "2.4.5",
   "mcpName": "io.github.j0hanz/superfetch",
   "description": "Intelligent web content fetcher MCP server that converts HTML to clean, AI-readable Markdown",
   "type": "module",