@llmindset/hf-mcp 0.2.44 → 0.2.46

package/dist/space/commands/discover.d.ts

@@ -0,0 +1,3 @@
+import type { ToolResult } from '../../types/tool-result.js';
+export declare function discoverSpaces(searchQuery?: string, limit?: number, hfToken?: string): Promise<ToolResult>;
+//# sourceMappingURL=discover.d.ts.map

package/dist/space/commands/discover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../../../src/space/commands/discover.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AA4E7D,wBAAsB,cAAc,CACnC,WAAW,CAAC,EAAE,MAAM,EACpB,KAAK,GAAE,MAA8B,EACrC,OAAO,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,UAAU,CAAC,CA8BrB"}

package/dist/space/commands/discover.js

@@ -0,0 +1,109 @@
+import { SpaceSearchTool } from '../../space-search.js';
+import { escapeMarkdown } from '../../utilities.js';
+const DEFAULT_RESULTS_LIMIT = 10;
+const DISCOVER_PROMPTS = {
+    TASK_HINTS: `Here are some examples of tasks that dynamic spaces can perform:
+
+- Image Generation
+- Video Generation
+- Text Generation
+- Visual QA
+- Language Translation
+- Speech Synthesis
+- 3D Modeling
+- Object Detection
+- Text Analysis
+- Image Editing
+- Code Generation
+- Question Answering
+- Data Visualization
+- Voice Cloning
+- Background Removal
+- OCR
+- Image Captioning
+- Sentiment Analysis
+- Music Generation
+- Style Transfer
+
+To discover MCP-enabled Spaces for a specific task, call this operation with a search query:
+
+**Example:**
+\`\`\`json
+{
+  "operation": "discover",
+  "search_query": "image generation",
+  "limit": 10
+}
+\`\`\``,
+    RESULTS_HEADER: (query, showing, total) => {
+        const showingText = showing < total ? `Showing ${showing} of ${total} results` : `All ${showing} results`;
+        return `# MCP Space Discovery Results for "${query}" (${showingText})
+
+These MCP-enabled Spaces can be invoked using the \`dynamic_space\` tool.
+Use \`"operation": "view_parameters"\` to inspect a space's parameters before invoking.
+
+`;
+    },
+    NO_RESULTS: (query) => `No MCP-enabled Spaces found for "${query}".
+
+Try:
+- Broader search terms (e.g., "image generation" instead of specific model names)
+- Task-focused queries (e.g., "text generation", "object detection")
+- Different task categories (e.g., "video generation", "image classification")`,
+};
+export async function discoverSpaces(searchQuery, limit = DEFAULT_RESULTS_LIMIT, hfToken) {
+    if (!searchQuery || searchQuery.trim() === '') {
+        return {
+            formatted: DISCOVER_PROMPTS.TASK_HINTS,
+            totalResults: 0,
+            resultsShared: 0,
+        };
+    }
+    try {
+        const searchTool = new SpaceSearchTool(hfToken);
+        const { results, totalCount } = await searchTool.search(searchQuery, limit, true);
+        return formatDiscoverResults(searchQuery, results, totalCount);
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            formatted: `Error discovering spaces: ${errorMessage}`,
+            totalResults: 0,
+            resultsShared: 0,
+            isError: true,
+        };
+    }
+}
+function formatDiscoverResults(query, results, totalCount) {
+    if (results.length === 0) {
+        return {
+            formatted: DISCOVER_PROMPTS.NO_RESULTS(query),
+            totalResults: 0,
+            resultsShared: 0,
+        };
+    }
+    let markdown = DISCOVER_PROMPTS.RESULTS_HEADER(query, results.length, totalCount);
+    markdown += '| Space | Description | Space ID | Category | Likes | Trending | Relevance |\n';
+    markdown += '|-------|-------------|----------|----------|-------|----------|----------|\n';
+    for (const result of results) {
+        const title = result.title || 'Untitled';
+        const description = result.shortDescription || result.ai_short_description || 'No description';
+        const id = result.id || '';
+        const emoji = result.emoji ? escapeMarkdown(result.emoji) + ' ' : '';
+        const relevance = result.semanticRelevancyScore ? (result.semanticRelevancyScore * 100).toFixed(1) + '%' : 'N/A';
+        markdown +=
+            `| ${emoji}[${escapeMarkdown(title)}](https://hf.co/spaces/${id}) ` +
+                `| ${escapeMarkdown(description)} ` +
+                `| \`${escapeMarkdown(id)}\` ` +
+                `| \`${escapeMarkdown(result.ai_category ?? '-')}\` ` +
+                `| ${escapeMarkdown(result.likes?.toString() ?? '-')} ` +
+                `| ${escapeMarkdown(result.trendingScore?.toString() ?? '-')} ` +
+                `| ${relevance} |\n`;
+    }
+    return {
+        formatted: markdown,
+        totalResults: totalCount,
+        resultsShared: results.length,
+    };
+}
+//# sourceMappingURL=discover.js.map

package/dist/space/commands/discover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.js","sourceRoot":"","sources":["../../../src/space/commands/discover.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAA0B,MAAM,uBAAuB,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGpD,MAAM,qBAAqB,GAAG,EAAE,CAAC;AAMjC,MAAM,gBAAgB,GAAG;IAExB,UAAU,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCN;IAGN,cAAc,EAAE,CAAC,KAAa,EAAE,OAAe,EAAE,KAAa,EAAE,EAAE;QACjE,MAAM,WAAW,GAAG,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,WAAW,OAAO,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,OAAO,OAAO,UAAU,CAAC;QAC1G,OAAO,sCAAsC,KAAK,MAAM,WAAW;;;;;CAKpE,CAAC;IACD,CAAC;IAGD,UAAU,EAAE,CAAC,KAAa,EAAE,EAAE,CAC7B,oCAAoC,KAAK;;;;;+EAKoC;CAC9E,CAAC;AAUF,MAAM,CAAC,KAAK,UAAU,cAAc,CACnC,WAAoB,EACpB,QAAgB,qBAAqB,EACrC,OAAgB;IAGhB,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC/C,OAAO;YACN,SAAS,EAAE,gBAAgB,CAAC,UAAU;YACtC,YAAY,EAAE,CAAC;YACf,aAAa,EAAE,CAAC;SAChB,CAAC;IACH,CAAC;IAED,IAAI,CAAC;QAEJ,MAAM,UAAU,GAAG,IAAI,eAAe,CAAC,OAAO,CAAC,CAAC;QAChD,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,UAAU,CAAC,MAAM,CACtD,WAAW,EACX,KAAK,EACL,IAAI,CACJ,CAAC;QAGF,OAAO,qBAAqB,CAAC,WAAW,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IAChE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5E,OAAO;YACN,SAAS,EAAE,6BAA6B,YAAY,EAAE;YACtD,YAAY,EAAE,CAAC;YACf,aAAa,EAAE,CAAC;YAChB,OAAO,EAAE,IAAI;SACb,CAAC;IACH,CAAC;AACF,CAAC;AAOD,SAAS,qBAAqB,CAAC,KAAa,EAAE,OAA4B,EAAE,UAAkB;IAC7F,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO;YACN,SAAS,EAAE,gBAAgB,CAAC,UAAU,CAAC,KAAK,CAAC;YAC7C,YAAY,EAAE,CAAC;YACf,aAAa,EAAE,CAAC;SAChB,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,GAAG,gBAAgB,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAGlF,QAAQ,IAAI,gFAAgF,CAAC;IAC7F,QAAQ,IAAI,+EAA+E,CAAC;IAG5F,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,UAAU,CAAC;QACzC,MAAM,WAAW,GAAG,MAAM,CAAC,gBAAgB,IAAI,MAAM,CAAC,oBAAoB,IAAI,gBAAgB,CAAC;QAC/F,MAAM,EAAE,GAAG,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,MAAM,SAAS,GAAG,MAAM,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,sBAAsB,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;QAEjH,QAAQ;YACP,KAAK,KAAK,IAAI,cAAc,CAAC,KAAK,CAAC,0BAA0B,EAAE,IAAI;gBACnE,KAAK,cAAc,CAAC,WAAW,CAAC,GAAG;gBACnC,OAAO,cAAc,CAAC,EAAE,CAAC,KAAK;gBAC9B,OAAO,cAAc,CAAC,MAAM,CAAC,WAAW,IAAI,GAAG,CAAC,KAAK;gBACrD,KAAK,cAAc,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,GAAG,CAAC,GAAG;gBACvD,KAAK,cAAc,CAAC,MAAM,CAAC,aAAa,EAAE,QAAQ,EAAE,IAAI,GAAG,CAAC,GAAG;gBAC/D,KAAK,SAAS,MAAM,CAAC;IACvB,CAAC;IAED,OAAO;QACN,SAAS,EAAE,QAAQ;QACnB,YAAY,EAAE,UAAU;QACxB,aAAa,EAAE,OAAO,CAAC,MAAM;KAC7B,CAAC;AACH,CAAC"}

package/dist/space/space-tool.d.ts

@@ -7,17 +7,23 @@ export declare const DYNAMIC_SPACE_TOOL_CONFIG: {
     readonly name: "dynamic_space";
     readonly description: string;
     readonly schema: import("zod").ZodObject<{
-        operation: import("zod").ZodOptional<import("zod").ZodEnum<["view_parameters", "invoke"]>>;
+        operation: import("zod").ZodOptional<import("zod").ZodEnum<["discover", "view_parameters", "invoke"]>>;
         space_name: import("zod").ZodOptional<import("zod").ZodString>;
         parameters: import("zod").ZodOptional<import("zod").ZodString>;
+        search_query: import("zod").ZodOptional<import("zod").ZodString>;
+        limit: import("zod").ZodOptional<import("zod").ZodNumber>;
     }, "strip", import("zod").ZodTypeAny, {
+        limit?: number | undefined;
         parameters?: string | undefined;
-        operation?: "view_parameters" | "invoke" | undefined;
+        operation?: "discover" | "view_parameters" | "invoke" | undefined;
         space_name?: string | undefined;
+        search_query?: string | undefined;
     }, {
+        limit?: number | undefined;
         parameters?: string | undefined;
-        operation?: "view_parameters" | "invoke" | undefined;
+        operation?: "discover" | "view_parameters" | "invoke" | undefined;
         space_name?: string | undefined;
+        search_query?: string | undefined;
     }>;
     readonly annotations: {
         readonly title: "Gradio Space Interaction";
@@ -29,6 +35,7 @@ export declare class SpaceTool {
     private hfToken?;
     constructor(hfToken?: string);
     execute(params: SpaceArgs, extra?: RequestHandlerExtra<ServerRequest, ServerNotification>): Promise<InvokeResult | ToolResult>;
+    private handleDiscover;
     private handleViewParameters;
     private handleInvoke;
 }

package/dist/space/space-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"space-tool.d.ts","sourceRoot":"","sources":["../../src/space/space-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAC5F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACxF,OAAO,EAAwD,KAAK,SAAS,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAKrH,cAAc,YAAY,CAAC;AA2E3B,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;CAY5B,CAAC;AAKX,qBAAa,SAAS;IACrB,OAAO,CAAC,OAAO,CAAC,CAAS;gBAEb,OAAO,CAAC,EAAE,MAAM;IAStB,OAAO,CACZ,MAAM,EAAE,SAAS,EACjB,KAAK,CAAC,EAAE,mBAAmB,CAAC,aAAa,EAAE,kBAAkB,CAAC,GAC5D,OAAO,CAAC,YAAY,GAAG,UAAU,CAAC;YAyDvB,oBAAoB;YAyBpB,YAAY;CA+C1B"}
+{"version":3,"file":"space-tool.d.ts","sourceRoot":"","sources":["../../src/space/space-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAC5F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACxF,OAAO,EAAwD,KAAK,SAAS,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAMrH,cAAc,YAAY,CAAC;AAkF3B,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;CAW5B,CAAC;AAKX,qBAAa,SAAS;IACrB,OAAO,CAAC,OAAO,CAAC,CAAS;gBAEb,OAAO,CAAC,EAAE,MAAM;IAStB,OAAO,CACZ,MAAM,EAAE,SAAS,EACjB,KAAK,CAAC,EAAE,mBAAmB,CAAC,aAAa,EAAE,kBAAkB,CAAC,GAC5D,OAAO,CAAC,YAAY,GAAG,UAAU,CAAC;YA4DvB,cAAc;YAOd,oBAAoB;YAyBpB,YAAY;CA+C1B"}

package/dist/space/space-tool.js

@@ -1,10 +1,11 @@
 import { spaceArgsSchema, OPERATION_NAMES } from './types.js';
+import { discoverSpaces } from './commands/discover.js';
 import { viewParameters } from './commands/view-parameters.js';
 import { invokeSpace } from './commands/invoke.js';
 export * from './types.js';
 const USAGE_INSTRUCTIONS = `# Gradio Space Interaction
 
-Dynamically interact with any Gradio MCP Space. View parameter schemas or invoke spaces with custom parameters.
+Dynamically interact with any Gradio MCP Space. Discover dynamic spaces, view space parameter schemas, and invoke spaces.
 
 ## Supported Schema Types
 
@@ -15,16 +16,22 @@ Dynamically interact with any Gradio MCP Space. View parameter schemas or invoke
 - Shallow objects (one level deep)
 - FileData (as URL strings)
 
-❌ **Complex types** (not supported):
-- Deeply nested objects (2+ levels)
-- Arrays of objects
-- Union types
-- Recursive schemas
-
-For spaces with complex schemas, direct the user to huggingface.co/settings/mcp to add the space via settings panel.
+To use spaces with complex schemas, add them from  huggingface.co/settings/mcp.
 
 ## Available Operations
 
+### discover
+Find MCP-enabled Spaces for available for invocation based on task-focused or semantic searches.
+
+**Example:**
+\`\`\`json
+{
+  "operation": "discover",
+  "search_query": "image generation",
+  "limit": 10
+}
+\`\`\`
+
 ### view_parameters
 Display the parameter schema for a space's first tool.
 
@@ -50,9 +57,9 @@ Execute a space's first tool with provided parameters.
 
 ## Workflow
 
-1. **Discover parameters** - Use \`view_parameters\` to see what a space accepts
-2. **Invoke the space** - Use \`invoke\` with the required parameters
-3. **Review results** - Get formatted output (text, images, resources)
+1. **Discover Spaces** - Use \`discover\` to find MCP-enabled spaces for your task
+2. **Inspect Parameters** - Use \`view_parameters\` to see what a space accepts
+3. **Invoke the Space** - Use \`invoke\` with the required parameters
 
 ## File Handling
 
@@ -63,6 +70,7 @@ For parameters that accept files (FileData types):
 
 ## Tips
 
+- Focus searches on specific tasks (e.g., "video generation", "object detection")
 - The tool automatically applies default values for optional parameters
 - Unknown parameters generate warnings but are still passed through (permissive inputs)
 - Enum parameters show all allowed values in view_parameters
@@ -70,8 +78,7 @@ For parameters that accept files (FileData types):
 `;
 export const DYNAMIC_SPACE_TOOL_CONFIG = {
     name: 'dynamic_space',
-    description: 'Dynamically interact with Gradio MCP Spaces . View parameter schemas or invoke spaces with custom parameters. ' +
-        'Supports simple parameter types (strings, numbers, booleans, arrays, enums, shallow objects). ' +
+    description: 'Discover (semantic/task search), inspect (view parameter schema) and dynamically invoke Gradio MCP Spaces to perform various ML Tasks. ' +
         'Call with no operation for full usage instructions.',
     schema: spaceArgsSchema,
     annotations: {
@@ -108,6 +115,8 @@ Call this tool with no operation for full usage instructions.`,
         }
         try {
             switch (normalizedOperation) {
+                case 'discover':
+                    return await this.handleDiscover(params);
                 case 'view_parameters':
                     return await this.handleViewParameters(params);
                 case 'invoke':
@@ -131,6 +140,9 @@ Call this tool with no operation for full usage instructions.`,
             };
         }
     }
+    async handleDiscover(params) {
+        return await discoverSpaces(params.search_query, params.limit, this.hfToken);
+    }
     async handleViewParameters(params) {
         if (!params.space_name) {
             return {

package/dist/space/space-tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"space-tool.js","sourceRoot":"","sources":["../../src/space/space-tool.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"space-tool.js","sourceRoot":"","sources":["../../src/space/space-tool.ts"],"names":[],"mappings":"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"}

package/dist/space/types.d.ts

@@ -1,18 +1,24 @@
 import { z } from 'zod';
-export declare const OPERATION_NAMES: readonly ["view_parameters", "invoke"];
+export declare const OPERATION_NAMES: readonly ["discover", "view_parameters", "invoke"];
 export type OperationName = (typeof OPERATION_NAMES)[number];
 export declare const spaceArgsSchema: z.ZodObject<{
-    operation: z.ZodOptional<z.ZodEnum<["view_parameters", "invoke"]>>;
+    operation: z.ZodOptional<z.ZodEnum<["discover", "view_parameters", "invoke"]>>;
     space_name: z.ZodOptional<z.ZodString>;
     parameters: z.ZodOptional<z.ZodString>;
+    search_query: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
+    limit?: number | undefined;
     parameters?: string | undefined;
-    operation?: "view_parameters" | "invoke" | undefined;
+    operation?: "discover" | "view_parameters" | "invoke" | undefined;
     space_name?: string | undefined;
+    search_query?: string | undefined;
 }, {
+    limit?: number | undefined;
     parameters?: string | undefined;
-    operation?: "view_parameters" | "invoke" | undefined;
+    operation?: "discover" | "view_parameters" | "invoke" | undefined;
     space_name?: string | undefined;
+    search_query?: string | undefined;
 }>;
 export type SpaceArgs = z.infer<typeof spaceArgsSchema>;
 export interface ParameterInfo {

package/dist/space/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/space/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,eAAe,wCAAyC,CAAC;AACtE,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAK7D,eAAO,MAAM,eAAe;;;;;;;;;;;;EAO1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAKxD,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAKD,MAAM,WAAW,sBAAsB;IACtC,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CACzB;AAKD,MAAM,WAAW,uBAAuB;IACvC,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAKD,MAAM,WAAW,kBAAkB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAChD,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAKD,MAAM,WAAW,UAAU;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAChD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAKD,eAAO,MAAM,uBAAuB,QAEsE,CAAC;AAK3G,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAOpE;AAKD,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAIvD;AAMD,MAAM,WAAW,YAAY;IAC5B,MAAM,EAAE;QACP,OAAO,EAAE,OAAO,EAAE,CAAC;QACnB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACvB,CAAC;IACF,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/space/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,eAAe,oDAAqD,CAAC;AAClF,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAK7D,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;EAgB1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAKxD,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAKD,MAAM,WAAW,sBAAsB;IACtC,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CACzB;AAKD,MAAM,WAAW,uBAAuB;IACvC,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAKD,MAAM,WAAW,kBAAkB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAChD,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAKD,MAAM,WAAW,UAAU;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAChD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAKD,eAAO,MAAM,uBAAuB,QAEmD,CAAC;AAKxF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAOpE;AAKD,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAIvD;AAMD,MAAM,WAAW,YAAY;IAC5B,MAAM,EAAE;QACP,OAAO,EAAE,OAAO,EAAE,CAAC;QACnB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACvB,CAAC;IACF,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB"}

package/dist/space/types.js

@@ -1,15 +1,20 @@
 import { z } from 'zod';
-export const OPERATION_NAMES = ['view_parameters', 'invoke'];
+export const OPERATION_NAMES = ['discover', 'view_parameters', 'invoke'];
 export const spaceArgsSchema = z.object({
-    operation: z
-        .enum(OPERATION_NAMES)
+    operation: z.enum(OPERATION_NAMES).optional().describe('Operation to execute.'),
+    space_name: z
+        .string()
         .optional()
-        .describe('Operation to execute. Valid values: "view_parameters", "invoke"'),
-    space_name: z.string().optional().describe('The Hugging Face space ID (format: "username/space-name")'),
+        .describe('The Hugging Face space ID (format: "username/space-name"). Required for view_parameters and invoke operations.'),
     parameters: z.string().optional().describe('For invoke operation: JSON object string of parameters'),
+    search_query: z
+        .string()
+        .optional()
+        .describe('For discover operation: Search query or task category (e.g. "Image Generation", "OCR", "FLUX image generation") to find MCP-enabled Spaces. Call with blank query to see task hints.'),
+    limit: z.number().optional().describe('For discover operation: Maximum number of results to return (default: 10)'),
 });
-export const FILE_INPUT_HELP_MESSAGE = 'Provide a publicly accessible URL (http:// or https://) pointing to the file. ' +
-    'To upload local files, use the dedicated gr_* prefixed tool for this space, which supports file upload.';
+export const FILE_INPUT_HELP_MESSAGE = 'Provide a publicly accessible URL (http:// or https://) for the Gradio file input. ' +
+    "Content previuosly generated by 'invoke' is usable, as well as Hub Repository URLs. ";
 export function isFileDataProperty(prop) {
     return (prop.title === 'ImageData' ||
         prop.title === 'FileData' ||

package/dist/space/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/space/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,iBAAiB,EAAE,QAAQ,CAAU,CAAC;AAMtE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,SAAS,EAAE,CAAC;SACV,IAAI,CAAC,eAAe,CAAC;SACrB,QAAQ,EAAE;SACV,QAAQ,CAAC,iEAAiE,CAAC;IAC7E,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2DAA2D,CAAC;IACvG,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;CACpG,CAAC,CAAC;AAqEH,MAAM,CAAC,MAAM,uBAAuB,GACnC,gFAAgF;IAChF,yGAAyG,CAAC;AAK3G,MAAM,UAAU,kBAAkB,CAAC,IAAwB;IAC1D,OAAO,CACN,IAAI,CAAC,KAAK,KAAK,WAAW;QAC1B,IAAI,CAAC,KAAK,KAAK,UAAU;QACzB,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QAChE,KAAK,CACL,CAAC;AACH,CAAC;AAKD,MAAM,UAAU,WAAW,CAAC,MAAkB;IAC7C,IAAI,CAAC,MAAM,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IAErC,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC;AAClF,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/space/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,UAAU,EAAE,iBAAiB,EAAE,QAAQ,CAAU,CAAC;AAMlF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IAC/E,UAAU,EAAE,CAAC;SACX,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACR,gHAAgH,CAChH;IACF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;IACpG,YAAY,EAAE,CAAC;SACb,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACR,sLAAsL,CACtL;IACF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2EAA2E,CAAC;CAClH,CAAC,CAAC;AAqEH,MAAM,CAAC,MAAM,uBAAuB,GACnC,qFAAqF;IACrF,sFAAsF,CAAC;AAKxF,MAAM,UAAU,kBAAkB,CAAC,IAAwB;IAC1D,OAAO,CACN,IAAI,CAAC,KAAK,KAAK,WAAW;QAC1B,IAAI,CAAC,KAAK,KAAK,UAAU;QACzB,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QAChE,KAAK,CACL,CAAC;AACH,CAAC;AAKD,MAAM,UAAU,WAAW,CAAC,MAAkB;IAC7C,IAAI,CAAC,MAAM,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IAErC,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC;AAClF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llmindset/hf-mcp",
-  "version": "0.2.44",
+  "version": "0.2.46",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/space/commands/discover.ts

@@ -0,0 +1,156 @@
+import type { ToolResult } from '../../types/tool-result.js';
+import { SpaceSearchTool, type SpaceSearchResult } from '../../space-search.js';
+import { escapeMarkdown } from '../../utilities.js';
+
+// Default number of results to return
+const DEFAULT_RESULTS_LIMIT = 10;
+
+/**
+ * Prompt configuration for discover operation
+ * These prompts can be easily tweaked to adjust the search behavior
+ */
+const DISCOVER_PROMPTS = {
+	// Task hints shown when called with blank query
+	TASK_HINTS: `Here are some examples of tasks that dynamic spaces can perform:
+
+- Image Generation
+- Video Generation
+- Text Generation
+- Visual QA
+- Language Translation
+- Speech Synthesis
+- 3D Modeling
+- Object Detection
+- Text Analysis
+- Image Editing
+- Code Generation
+- Question Answering
+- Data Visualization
+- Voice Cloning
+- Background Removal
+- OCR
+- Image Captioning
+- Sentiment Analysis
+- Music Generation
+- Style Transfer
+
+To discover MCP-enabled Spaces for a specific task, call this operation with a search query:
+
+**Example:**
+\`\`\`json
+{
+  "operation": "discover",
+  "search_query": "image generation",
+  "limit": 10
+}
+\`\`\``,
+
+	// Header for search results
+	RESULTS_HEADER: (query: string, showing: number, total: number) => {
+		const showingText = showing < total ? `Showing ${showing} of ${total} results` : `All ${showing} results`;
+		return `# MCP Space Discovery Results for "${query}" (${showingText})
+
+These MCP-enabled Spaces can be invoked using the \`dynamic_space\` tool.
+Use \`"operation": "view_parameters"\` to inspect a space's parameters before invoking.
+
+`;
+	},
+
+	// No results message
+	NO_RESULTS: (query: string) =>
+		`No MCP-enabled Spaces found for "${query}".
+
+Try:
+- Broader search terms (e.g., "image generation" instead of specific model names)
+- Task-focused queries (e.g., "text generation", "object detection")
+- Different task categories (e.g., "video generation", "image classification")`,
+};
+
+/**
+ * Discovers MCP-enabled Spaces based on search criteria
+ *
+ * @param searchQuery - The search query or task category
+ * @param limit - Maximum number of results to return
+ * @param hfToken - Optional HuggingFace API token
+ * @returns Formatted search results
+ */
+export async function discoverSpaces(
+	searchQuery?: string,
+	limit: number = DEFAULT_RESULTS_LIMIT,
+	hfToken?: string
+): Promise<ToolResult> {
+	// Return task hints when called with blank query
+	if (!searchQuery || searchQuery.trim() === '') {
+		return {
+			formatted: DISCOVER_PROMPTS.TASK_HINTS,
+			totalResults: 0,
+			resultsShared: 0,
+		};
+	}
+
+	try {
+		// Use SpaceSearchTool to search for MCP-enabled spaces only
+		const searchTool = new SpaceSearchTool(hfToken);
+		const { results, totalCount } = await searchTool.search(
+			searchQuery,
+			limit,
+			true // mcp = true (only MCP-enabled spaces)
+		);
+
+		// Format and return results
+		return formatDiscoverResults(searchQuery, results, totalCount);
+	} catch (error) {
+		const errorMessage = error instanceof Error ? error.message : String(error);
+		return {
+			formatted: `Error discovering spaces: ${errorMessage}`,
+			totalResults: 0,
+			resultsShared: 0,
+			isError: true,
+		};
+	}
+}
+
+/**
+ * Formats discover results as a markdown table
+ * Note: Author column is omitted as it's superfluous for invocation purposes
+ * Duplication is OK for the mean time; space_search will be rolled in to a general tool
+ */
+function formatDiscoverResults(query: string, results: SpaceSearchResult[], totalCount: number): ToolResult {
+	if (results.length === 0) {
+		return {
+			formatted: DISCOVER_PROMPTS.NO_RESULTS(query),
+			totalResults: 0,
+			resultsShared: 0,
+		};
+	}
+
+	let markdown = DISCOVER_PROMPTS.RESULTS_HEADER(query, results.length, totalCount);
+
+	// Table header (without Author column)
+	markdown += '| Space | Description | Space ID | Category | Likes | Trending | Relevance |\n';
+	markdown += '|-------|-------------|----------|----------|-------|----------|----------|\n';
+
+	// Table rows
+	for (const result of results) {
+		const title = result.title || 'Untitled';
+		const description = result.shortDescription || result.ai_short_description || 'No description';
+		const id = result.id || '';
+		const emoji = result.emoji ? escapeMarkdown(result.emoji) + ' ' : '';
+		const relevance = result.semanticRelevancyScore ? (result.semanticRelevancyScore * 100).toFixed(1) + '%' : 'N/A';
+
+		markdown +=
+			`| ${emoji}[${escapeMarkdown(title)}](https://hf.co/spaces/${id}) ` +
+			`| ${escapeMarkdown(description)} ` +
+			`| \`${escapeMarkdown(id)}\` ` +
+			`| \`${escapeMarkdown(result.ai_category ?? '-')}\` ` +
+			`| ${escapeMarkdown(result.likes?.toString() ?? '-')} ` +
+			`| ${escapeMarkdown(result.trendingScore?.toString() ?? '-')} ` +
+			`| ${relevance} |\n`;
+	}
+
+	return {
+		formatted: markdown,
+		totalResults: totalCount,
+		resultsShared: results.length,
+	};
+}

package/src/space/space-tool.ts

@@ -2,6 +2,7 @@ import type { ToolResult } from '../types/tool-result.js';
 import type { ServerNotification, ServerRequest } from '@modelcontextprotocol/sdk/types.js';
 import type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';
 import { spaceArgsSchema, OPERATION_NAMES, type OperationName, type SpaceArgs, type InvokeResult } from './types.js';
+import { discoverSpaces } from './commands/discover.js';
 import { viewParameters } from './commands/view-parameters.js';
 import { invokeSpace } from './commands/invoke.js';
 
@@ -13,7 +14,7 @@ export * from './types.js';
  */
 const USAGE_INSTRUCTIONS = `# Gradio Space Interaction
 
-Dynamically interact with any Gradio MCP Space. View parameter schemas or invoke spaces with custom parameters.
+Dynamically interact with any Gradio MCP Space. Discover dynamic spaces, view space parameter schemas, and invoke spaces.
 
 ## Supported Schema Types
 
@@ -24,16 +25,22 @@ Dynamically interact with any Gradio MCP Space. View parameter schemas or invoke
 - Shallow objects (one level deep)
 - FileData (as URL strings)
 
-❌ **Complex types** (not supported):
-- Deeply nested objects (2+ levels)
-- Arrays of objects
-- Union types
-- Recursive schemas
-
-For spaces with complex schemas, direct the user to huggingface.co/settings/mcp to add the space via settings panel.
+To use spaces with complex schemas, add them from  huggingface.co/settings/mcp.
 
 ## Available Operations
 
+### discover
+Find MCP-enabled Spaces for available for invocation based on task-focused or semantic searches.
+
+**Example:**
+\`\`\`json
+{
+  "operation": "discover",
+  "search_query": "image generation",
+  "limit": 10
+}
+\`\`\`
+
 ### view_parameters
 Display the parameter schema for a space's first tool.
 
@@ -59,9 +66,9 @@ Execute a space's first tool with provided parameters.
 
 ## Workflow
 
-1. **Discover parameters** - Use \`view_parameters\` to see what a space accepts
-2. **Invoke the space** - Use \`invoke\` with the required parameters
-3. **Review results** - Get formatted output (text, images, resources)
+1. **Discover Spaces** - Use \`discover\` to find MCP-enabled spaces for your task
+2. **Inspect Parameters** - Use \`view_parameters\` to see what a space accepts
+3. **Invoke the Space** - Use \`invoke\` with the required parameters
 
 ## File Handling
 
@@ -72,6 +79,7 @@ For parameters that accept files (FileData types):
 
 ## Tips
 
+- Focus searches on specific tasks (e.g., "video generation", "object detection")
 - The tool automatically applies default values for optional parameters
 - Unknown parameters generate warnings but are still passed through (permissive inputs)
 - Enum parameters show all allowed values in view_parameters
@@ -84,8 +92,7 @@ For parameters that accept files (FileData types):
 export const DYNAMIC_SPACE_TOOL_CONFIG = {
 	name: 'dynamic_space',
 	description:
-		'Dynamically interact with Gradio MCP Spaces . View parameter schemas or invoke spaces with custom parameters. ' +
-		'Supports simple parameter types (strings, numbers, booleans, arrays, enums, shallow objects). ' +
+		'Discover (semantic/task search), inspect (view parameter schema) and dynamically invoke Gradio MCP Spaces to perform various ML Tasks. ' +
 		'Call with no operation for full usage instructions.',
 	schema: spaceArgsSchema,
 	annotations: {
@@ -142,6 +149,9 @@ Call this tool with no operation for full usage instructions.`,
 		// Execute operation
 		try {
 			switch (normalizedOperation) {
+				case 'discover':
+					return await this.handleDiscover(params);
+
 				case 'view_parameters':
 					return await this.handleViewParameters(params);
 
@@ -167,6 +177,13 @@ Call this tool with no operation for full usage instructions.`,
 		}
 	}
 
+	/**
+	 * Handle discover operation
+	 */
+	private async handleDiscover(params: SpaceArgs): Promise<ToolResult> {
+		return await discoverSpaces(params.search_query, params.limit, this.hfToken);
+	}
+
 	/**
 	 * Handle view_parameters operation
 	 */

package/src/space/types.ts

@@ -3,19 +3,28 @@ import { z } from 'zod';
 /**
  * Operations supported by the space tool
  */
-export const OPERATION_NAMES = ['view_parameters', 'invoke'] as const;
+export const OPERATION_NAMES = ['discover', 'view_parameters', 'invoke'] as const;
 export type OperationName = (typeof OPERATION_NAMES)[number];
 
 /**
  * Zod schema for operation arguments
  */
 export const spaceArgsSchema = z.object({
-	operation: z
-		.enum(OPERATION_NAMES)
+	operation: z.enum(OPERATION_NAMES).optional().describe('Operation to execute.'),
+	space_name: z
+		.string()
 		.optional()
-		.describe('Operation to execute. Valid values: "view_parameters", "invoke"'),
-	space_name: z.string().optional().describe('The Hugging Face space ID (format: "username/space-name")'),
+		.describe(
+			'The Hugging Face space ID (format: "username/space-name"). Required for view_parameters and invoke operations.'
+		),
 	parameters: z.string().optional().describe('For invoke operation: JSON object string of parameters'),
+	search_query: z
+		.string()
+		.optional()
+		.describe(
+			'For discover operation: Search query or task category (e.g. "Image Generation", "OCR", "FLUX image generation") to find MCP-enabled Spaces. Call with blank query to see task hints.'
+		),
+	limit: z.number().optional().describe('For discover operation: Maximum number of results to return (default: 10)'),
 });
 
 export type SpaceArgs = z.infer<typeof spaceArgsSchema>;
@@ -86,8 +95,8 @@ export interface JsonSchema {
  * File input help message constant
  */
 export const FILE_INPUT_HELP_MESSAGE =
-	'Provide a publicly accessible URL (http:// or https://) pointing to the file. ' +
-	'To upload local files, use the dedicated gr_* prefixed tool for this space, which supports file upload.';
+	'Provide a publicly accessible URL (http:// or https://) for the Gradio file input. ' +
+	"Content previuosly generated by 'invoke' is usable, as well as Hub Repository URLs. ";
 
 /**
  * Check if a property is a FileData type