@qverisai/mcp 0.1.2

package/dist/index.js

@@ -0,0 +1,268 @@
+#!/usr/bin/env node
+/**
+ * Qveris MCP Server
+ *
+ * A Model Context Protocol (MCP) server that provides access to the Qveris
+ * tool discovery and execution API. Enables LLMs to dynamically search for
+ * and execute third-party tools via natural language.
+ *
+ * @module @qverisai/mcp
+ * @version 0.1.0
+ *
+ * @example
+ * Configure in Claude Desktop or Cursor:
+ * ```json
+ * {
+ *   "mcpServers": {
+ *     "qveris": {
+ *       "command": "npx",
+ *       "args": ["@qverisai/mcp"],
+ *       "env": { "QVERIS_API_KEY": "your-api-key" }
+ *     }
+ *   }
+ * }
+ * ```
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { v4 as uuidv4 } from 'uuid';
+import { createClientFromEnv } from './api/client.js';
+import { searchToolsSchema, executeSearchTools, } from './tools/search.js';
+import { executeToolSchema, executeExecuteTool, } from './tools/execute.js';
+import { getToolsByIdsSchema, executeGetToolsByIds, } from './tools/get-by-ids.js';
+// ============================================================================
+// Server Configuration
+// ============================================================================
+const SERVER_NAME = 'qveris';
+const SERVER_VERSION = '0.1.0';
+/**
+ * Main entry point for the Qveris MCP Server.
+ *
+ * Sets up the MCP server with stdio transport, registers the search_tools
+ * and execute_tool handlers, and starts listening for requests.
+ */
+async function main() {
+    // Initialize API client (validates QVERIS_API_KEY)
+    let client;
+    try {
+        client = createClientFromEnv();
+    }
+    catch (error) {
+        console.error(error instanceof Error ? error.message : 'Failed to initialize Qveris client');
+        process.exit(1);
+    }
+    // Generate a default session ID for this server instance
+    const defaultSessionId = uuidv4();
+    // Create MCP server
+    const server = new Server({
+        name: SERVER_NAME,
+        version: SERVER_VERSION,
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    // =========================================================================
+    // Tool Handlers
+    // =========================================================================
+    /**
+     * Lists available tools.
+     * Returns the search_tools, get_tools_by_ids, and execute_tool definitions.
+     */
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        return {
+            tools: [
+                {
+                    name: 'search_tools',
+                    description: 'Search for available tools based on natural language queries. ' +
+                        'Returns relevant tools that can help accomplish tasks. ' +
+                        'Use this to discover tools before executing them.',
+                    inputSchema: searchToolsSchema,
+                },
+                {
+                    name: 'get_tools_by_ids',
+                    description: 'Get descriptions of tools based on their tool IDs. ' +
+                        'Useful for retrieving detailed information about specific tools ' +
+                        'when you already know their tool_ids from previous searches.',
+                    inputSchema: getToolsByIdsSchema,
+                },
+                {
+                    name: 'execute_tool',
+                    description: 'Execute a specific remote tool with provided parameters. ' +
+                        'The tool_id and search_id must come from a previous search_tools call. ' +
+                        'Pass parameters to the tool through params_to_tool as a JSON string.',
+                    inputSchema: executeToolSchema,
+                },
+            ],
+        };
+    });
+    /**
+     * Handles tool execution requests.
+     * Routes to the appropriate handler based on tool name.
+     */
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        try {
+            if (name === 'search_tools') {
+                const input = args;
+                // Validate required fields
+                if (!input.query || typeof input.query !== 'string') {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify({
+                                    error: 'Missing required parameter: query',
+                                    hint: 'Provide a natural language query describing the tool capability you need',
+                                }),
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                const result = await executeSearchTools(client, input, defaultSessionId);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            if (name === 'get_tools_by_ids') {
+                const input = args;
+                // Validate required fields
+                if (!input.tool_ids || !Array.isArray(input.tool_ids) || input.tool_ids.length === 0) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify({
+                                    error: 'Missing or invalid required parameter: tool_ids',
+                                    hint: 'Provide an array of tool IDs (at least one) to retrieve tool information',
+                                }),
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                const result = await executeGetToolsByIds(client, input, defaultSessionId);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            if (name === 'execute_tool') {
+                const input = args;
+                // Validate required fields
+                const missingFields = [];
+                if (!input.tool_id)
+                    missingFields.push('tool_id');
+                if (!input.search_id)
+                    missingFields.push('search_id');
+                if (!input.params_to_tool)
+                    missingFields.push('params_to_tool');
+                if (missingFields.length > 0) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify({
+                                    error: `Missing required parameters: ${missingFields.join(', ')}`,
+                                    hint: 'tool_id and search_id must come from a previous search_tools call',
+                                }),
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                const result = await executeExecuteTool(client, input, defaultSessionId);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            // Unknown tool
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: `Unknown tool: ${name}`,
+                            available_tools: ['search_tools', 'get_tools_by_ids', 'execute_tool'],
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        catch (error) {
+            // Handle API errors
+            if (isApiError(error)) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                error: error.message,
+                                status: error.status,
+                                details: error.details,
+                            }),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            // Handle other errors (including fetch network errors)
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
+            const errorCause = error instanceof Error && error.cause instanceof Error
+                ? error.cause.message
+                : undefined;
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: errorMessage,
+                            ...(errorCause && { cause: errorCause }),
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // =========================================================================
+    // Start Server
+    // =========================================================================
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Log startup to stderr (stdout is reserved for MCP protocol)
+    console.error(`Qveris MCP Server v${SERVER_VERSION} started`);
+    console.error(`Session ID: ${defaultSessionId}`);
+}
+/**
+ * Type guard for API errors.
+ */
+function isApiError(error) {
+    return (typeof error === 'object' &&
+        error !== null &&
+        'status' in error &&
+        'message' in error);
+}
+// Run the server
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/tools/execute.d.ts

@@ -0,0 +1,89 @@
+/**
+ * execute_tool MCP Tool Implementation
+ *
+ * Executes a specific remote tool with provided parameters.
+ * The tool_id must come from a previous search_tools call.
+ *
+ * @module tools/execute
+ */
+import type { QverisClient } from '../api/client.js';
+import type { ExecuteResponse } from '../types.js';
+/**
+ * Input parameters for the execute_tool tool.
+ */
+export interface ExecuteToolInput {
+    /**
+     * The ID of the remote tool to execute.
+     * Must be obtained from search_tools results.
+     */
+    tool_id: string;
+    /**
+     * The search_id from the search_tools response that returned this tool.
+     * Links the execution to the original search for analytics and billing.
+     */
+    search_id: string;
+    /**
+     * JSON stringified dictionary of parameters to pass to the remote tool.
+     * Keys are parameter names, values can be of any type.
+     *
+     * @example '{"city": "London", "units": "metric"}'
+     * @example '{"query": "AI news", "limit": 10}'
+     */
+    params_to_tool: string;
+    /**
+     * Session identifier for tracking user sessions.
+     * If not provided, the server will use an auto-generated session ID.
+     */
+    session_id?: string;
+    /**
+     * Maximum size of response data in bytes.
+     * If the tool generates data longer than this limit, the response
+     * will be truncated and a download URL provided for the full content.
+     *
+     * @default 20480 (20KB)
+     * @minimum -1 (-1 means no limit)
+     */
+    max_response_size?: number;
+}
+/**
+ * JSON Schema for the execute_tool tool input.
+ * Used by MCP to validate and document the tool parameters.
+ */
+export declare const executeToolSchema: {
+    type: "object";
+    properties: {
+        tool_id: {
+            type: string;
+            description: string;
+        };
+        search_id: {
+            type: string;
+            description: string;
+        };
+        params_to_tool: {
+            type: string;
+            description: string;
+        };
+        session_id: {
+            type: string;
+            description: string;
+        };
+        max_response_size: {
+            type: string;
+            description: string;
+            default: number;
+        };
+    };
+    required: string[];
+};
+/**
+ * Executes the execute_tool operation.
+ *
+ * @param client - Initialized Qveris API client
+ * @param input - Execution parameters
+ * @param defaultSessionId - Fallback session ID if not provided in input
+ * @returns Execution result from the tool
+ * @throws {Error} If params_to_tool is not valid JSON
+ */
+export declare function executeExecuteTool(client: QverisClient, input: ExecuteToolInput, defaultSessionId: string): Promise<ExecuteResponse>;
+//# sourceMappingURL=execute.d.ts.map

package/dist/tools/execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../src/tools/execute.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;;;;OAMG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;;;;OAOG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;CAqC7B,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,gBAAgB,EACvB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,eAAe,CAAC,CAoB1B"}

package/dist/tools/execute.js

@@ -0,0 +1,73 @@
+/**
+ * execute_tool MCP Tool Implementation
+ *
+ * Executes a specific remote tool with provided parameters.
+ * The tool_id must come from a previous search_tools call.
+ *
+ * @module tools/execute
+ */
+/**
+ * JSON Schema for the execute_tool tool input.
+ * Used by MCP to validate and document the tool parameters.
+ */
+export const executeToolSchema = {
+    type: 'object',
+    properties: {
+        tool_id: {
+            type: 'string',
+            description: 'The ID of the remote tool to execute. Must come from a previous search_tools call.',
+        },
+        search_id: {
+            type: 'string',
+            description: 'The search_id from the search_tools response that returned this tool. ' +
+                'Required for linking execution to the original search.',
+        },
+        params_to_tool: {
+            type: 'string',
+            description: 'A JSON stringified dictionary of parameters to pass to the remote tool. ' +
+                'Keys are param names and values can be of any type. ' +
+                'Example: \'{"city": "London", "units": "metric"}\'',
+        },
+        session_id: {
+            type: 'string',
+            description: 'Session identifier for tracking user sessions. ' +
+                'If not provided, an auto-generated session ID will be used.',
+        },
+        max_response_size: {
+            type: 'number',
+            description: 'Maximum size of response data in bytes. ' +
+                'If tool generates data longer than this, it will be truncated and a download URL provided. ' +
+                'Use -1 for no limit. Default is 20480 (20KB).',
+            default: 20480,
+        },
+    },
+    required: ['tool_id', 'search_id', 'params_to_tool'],
+};
+/**
+ * Executes the execute_tool operation.
+ *
+ * @param client - Initialized Qveris API client
+ * @param input - Execution parameters
+ * @param defaultSessionId - Fallback session ID if not provided in input
+ * @returns Execution result from the tool
+ * @throws {Error} If params_to_tool is not valid JSON
+ */
+export async function executeExecuteTool(client, input, defaultSessionId) {
+    // Parse the JSON parameters
+    let parameters;
+    try {
+        parameters = JSON.parse(input.params_to_tool);
+    }
+    catch (error) {
+        throw new Error(`Invalid JSON in params_to_tool: ${error instanceof Error ? error.message : 'Unknown parse error'}. ` +
+            `Received: ${input.params_to_tool}`);
+    }
+    const response = await client.executeTool(input.tool_id, {
+        search_id: input.search_id,
+        session_id: input.session_id ?? defaultSessionId,
+        parameters,
+        max_response_size: input.max_response_size,
+    });
+    return response;
+}
+//# sourceMappingURL=execute.js.map

package/dist/tools/execute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../src/tools/execute.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA+CH;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,QAAiB;IACvB,UAAU,EAAE;QACV,OAAO,EAAE;YACP,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,oFAAoF;SACvF;QACD,SAAS,EAAE;YACT,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,wEAAwE;gBACxE,wDAAwD;SAC3D;QACD,cAAc,EAAE;YACd,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,0EAA0E;gBAC1E,sDAAsD;gBACtD,oDAAoD;SACvD;QACD,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,iDAAiD;gBACjD,6DAA6D;SAChE;QACD,iBAAiB,EAAE;YACjB,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,0CAA0C;gBAC1C,6FAA6F;gBAC7F,+CAA+C;YACjD,OAAO,EAAE,KAAK;SACf;KACF;IACD,QAAQ,EAAE,CAAC,SAAS,EAAE,WAAW,EAAE,gBAAgB,CAAC;CACrD,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAoB,EACpB,KAAuB,EACvB,gBAAwB;IAExB,4BAA4B;IAC5B,IAAI,UAAmC,CAAC;IACxC,IAAI,CAAC;QACH,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,cAAc,CAA4B,CAAC;IAC3E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,mCAAmC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,qBAAqB,IAAI;YACrG,aAAa,KAAK,CAAC,cAAc,EAAE,CACpC,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,OAAO,EAAE;QACvD,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,gBAAgB;QAChD,UAAU;QACV,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;KAC3C,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/tools/get-by-ids.d.ts

@@ -0,0 +1,69 @@
+/**
+ * get_tools_by_ids MCP Tool Implementation
+ *
+ * Retrieves tool descriptions based on tool IDs.
+ * Useful for getting detailed information about specific tools
+ * when you already know their tool_ids.
+ *
+ * @module tools/get-by-ids
+ */
+import type { QverisClient } from '../api/client.js';
+import type { SearchResponse } from '../types.js';
+/**
+ * Input parameters for the get_tools_by_ids tool.
+ */
+export interface GetToolsByIdsInput {
+    /**
+     * Array of tool IDs to retrieve information for.
+     * Must be obtained from previous search_tools results.
+     *
+     * @example ["weather-tool-1", "email-tool-2"]
+     */
+    tool_ids: string[];
+    /**
+     * The search_id from the search_tools response that returned the tool(s).
+     * Optional but recommended for analytics and billing.
+     */
+    search_id?: string;
+    /**
+     * Session identifier for tracking user sessions.
+     * If not provided, the server will use an auto-generated session ID.
+     */
+    session_id?: string;
+}
+/**
+ * JSON Schema for the get_tools_by_ids tool input.
+ * Used by MCP to validate and document the tool parameters.
+ */
+export declare const getToolsByIdsSchema: {
+    type: "object";
+    properties: {
+        tool_ids: {
+            type: string;
+            items: {
+                type: string;
+            };
+            description: string;
+            minItems: number;
+        };
+        search_id: {
+            type: string;
+            description: string;
+        };
+        session_id: {
+            type: string;
+            description: string;
+        };
+    };
+    required: string[];
+};
+/**
+ * Executes the get_tools_by_ids operation.
+ *
+ * @param client - Initialized Qveris API client
+ * @param input - Request parameters with tool IDs
+ * @param defaultSessionId - Fallback session ID if not provided in input
+ * @returns Tool information for the requested IDs
+ */
+export declare function executeGetToolsByIds(client: QverisClient, input: GetToolsByIdsInput, defaultSessionId: string): Promise<SearchResponse>;
+//# sourceMappingURL=get-by-ids.d.ts.map

package/dist/tools/get-by-ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-by-ids.d.ts","sourceRoot":"","sources":["../../src/tools/get-by-ids.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;OAKG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;CA2B/B,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,kBAAkB,EACzB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,cAAc,CAAC,CAQzB"}

package/dist/tools/get-by-ids.js

@@ -0,0 +1,55 @@
+/**
+ * get_tools_by_ids MCP Tool Implementation
+ *
+ * Retrieves tool descriptions based on tool IDs.
+ * Useful for getting detailed information about specific tools
+ * when you already know their tool_ids.
+ *
+ * @module tools/get-by-ids
+ */
+/**
+ * JSON Schema for the get_tools_by_ids tool input.
+ * Used by MCP to validate and document the tool parameters.
+ */
+export const getToolsByIdsSchema = {
+    type: 'object',
+    properties: {
+        tool_ids: {
+            type: 'array',
+            items: {
+                type: 'string',
+            },
+            description: 'Array of tool IDs to retrieve information for. ' +
+                'These IDs should come from previous search_tools results.',
+            minItems: 1,
+        },
+        search_id: {
+            type: 'string',
+            description: 'The search_id from the search_tools response that returned the tool(s). ' +
+                'Optional but recommended for linking to the original search.',
+        },
+        session_id: {
+            type: 'string',
+            description: 'Session identifier for tracking user sessions. ' +
+                'If not provided, an auto-generated session ID will be used.',
+        },
+    },
+    required: ['tool_ids'],
+};
+/**
+ * Executes the get_tools_by_ids operation.
+ *
+ * @param client - Initialized Qveris API client
+ * @param input - Request parameters with tool IDs
+ * @param defaultSessionId - Fallback session ID if not provided in input
+ * @returns Tool information for the requested IDs
+ */
+export async function executeGetToolsByIds(client, input, defaultSessionId) {
+    const response = await client.getToolsByIds({
+        tool_ids: input.tool_ids,
+        search_id: input.search_id,
+        session_id: input.session_id ?? defaultSessionId,
+    });
+    return response;
+}
+//# sourceMappingURL=get-by-ids.js.map

package/dist/tools/get-by-ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-by-ids.js","sourceRoot":"","sources":["../../src/tools/get-by-ids.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA8BH;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,QAAiB;IACvB,UAAU,EAAE;QACV,QAAQ,EAAE;YACR,IAAI,EAAE,OAAO;YACb,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;aACf;YACD,WAAW,EACT,iDAAiD;gBACjD,2DAA2D;YAC7D,QAAQ,EAAE,CAAC;SACZ;QACD,SAAS,EAAE;YACT,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,0EAA0E;gBAC1E,8DAA8D;SACjE;QACD,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,iDAAiD;gBACjD,6DAA6D;SAChE;KACF;IACD,QAAQ,EAAE,CAAC,UAAU,CAAC;CACvB,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAAoB,EACpB,KAAyB,EACzB,gBAAwB;IAExB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC;QAC1C,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,gBAAgB;KACjD,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/tools/search.d.ts

@@ -0,0 +1,71 @@
+/**
+ * search_tools MCP Tool Implementation
+ *
+ * Searches for available tools based on natural language queries.
+ * Returns relevant tools that can help accomplish tasks.
+ *
+ * @module tools/search
+ */
+import type { QverisClient } from '../api/client.js';
+import type { SearchResponse } from '../types.js';
+/**
+ * Input parameters for the search_tools tool.
+ */
+export interface SearchToolsInput {
+    /**
+     * The search query describing the general capability of the tool.
+     * Should describe what you want to accomplish, not specific parameters.
+     *
+     * @example "weather forecast API"
+     * @example "send email notification"
+     * @example "stock price lookup"
+     */
+    query: string;
+    /**
+     * Maximum number of results to return.
+     * @default 20
+     * @minimum 1
+     * @maximum 100
+     */
+    limit?: number;
+    /**
+     * Session identifier for tracking user sessions.
+     * If not provided, the server will use an auto-generated session ID.
+     */
+    session_id?: string;
+}
+/**
+ * JSON Schema for the search_tools tool input.
+ * Used by MCP to validate and document the tool parameters.
+ */
+export declare const searchToolsSchema: {
+    type: "object";
+    properties: {
+        query: {
+            type: string;
+            description: string;
+        };
+        limit: {
+            type: string;
+            description: string;
+            default: number;
+            minimum: number;
+            maximum: number;
+        };
+        session_id: {
+            type: string;
+            description: string;
+        };
+    };
+    required: string[];
+};
+/**
+ * Executes the search_tools operation.
+ *
+ * @param client - Initialized Qveris API client
+ * @param input - Search parameters
+ * @param defaultSessionId - Fallback session ID if not provided in input
+ * @returns Search results with matching tools
+ */
+export declare function executeSearchTools(client: QverisClient, input: SearchToolsInput, defaultSessionId: string): Promise<SearchResponse>;
+//# sourceMappingURL=search.d.ts.map

package/dist/tools/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;OAOG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;CAyB7B,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,gBAAgB,EACvB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,cAAc,CAAC,CAQzB"}