@qverisai/mcp 0.6.0 → 0.7.0

package/README.md

@@ -21,18 +21,35 @@ This SDK provides a [Model Context Protocol (MCP)](https://modelcontextprotocol.
 
 Visit [QVeris](https://qveris.ai) (Global) or [QVeris](https://qveris.cn) (China) to get your API key.
 
-### 2. Configure Your MCP Client
-
-Add the QVeris server to your MCP client configuration:
-
-**Claude Desktop** (`claude_desktop_config.json`):
+### 2. Configure Your MCP Client
+
+Use the QVeris CLI to generate config without hand-editing JSON. Placeholder output intentionally fails API key validation until you replace it or use `--include-key`:
+
+```bash
+# Print safe config with YOUR_QVERIS_API_KEY placeholder
+qveris mcp configure --target cursor
+
+# Write a working config using your resolved API key
+qveris mcp configure --target cursor --write --include-key
+qveris mcp configure --target claude-desktop --write --include-key
+qveris mcp configure --target opencode --write --include-key
+qveris mcp configure --target openclaw --write --include-key
+
+# Validate config, or live-probe visible tools for stdio clients
+qveris mcp validate --target cursor
+qveris mcp validate --target cursor --probe
+```
+
+Add the QVeris server to your MCP client configuration:
+
+**Claude Desktop** (`claude_desktop_config.json`):
 
 ```json
 {
   "mcpServers": {
     "qveris": {
       "command": "npx",
-      "args": ["@qverisai/mcp"],
+      "args": ["-y", "@qverisai/mcp"],
       "env": {
         "QVERIS_API_KEY": "your-api-key-here"
       }
@@ -48,7 +65,7 @@ Add the QVeris server to your MCP client configuration:
   "mcpServers": {
     "qveris": {
       "command": "npx",
-      "args": ["@qverisai/mcp"],
+      "args": ["-y", "@qverisai/mcp"],
       "env": {
         "QVERIS_API_KEY": "your-api-key-here"
       }
@@ -298,8 +315,8 @@ To override manually, set environment variables in your MCP client config:
 
 ```bash
 # Clone the repository
-git clone https://github.com/QVerisAI/QVerisAI.git
-cd QVerisAI/packages/mcp
+git clone https://github.com/QVerisAI/qveris-agent-toolkit.git
+cd qveris-agent-toolkit/packages/mcp
 
 # Install dependencies
 npm install
@@ -317,6 +334,6 @@ MIT © [QVerisAI](https://github.com/QVerisAI)
 
 ## Support
 
-- 🐛 [Issue Tracker](https://github.com/QVerisAI/QVerisAI/issues)
+- 🐛 [Issue Tracker](https://github.com/QVerisAI/qveris-agent-toolkit/issues)
 - 💬 Contact: contact@qveris.ai
 

package/dist/index.d.ts

@@ -16,12 +16,224 @@
  *   "mcpServers": {
  *     "qveris": {
  *       "command": "npx",
- *       "args": ["@qverisai/mcp"],
+ *       "args": ["-y", "@qverisai/mcp"],
  *       "env": { "QVERIS_API_KEY": "your-api-key" }
  *     }
  *   }
  * }
  * ```
  */
-export {};
+import { type CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { QverisClient } from './api/client.js';
+/**
+ * List the MCP tools exposed by this server.
+ *
+ * Kept as a pure export so the public MCP interface can be tested without
+ * starting stdio transport.
+ */
+export declare function listQverisMcpTools(): ({
+    name: string;
+    description: string;
+    inputSchema: {
+        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[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        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[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        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[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            mode: {
+                type: string;
+                enum: string[];
+                description: string;
+                default: string;
+            };
+            start_date: {
+                type: string;
+                description: string;
+            };
+            end_date: {
+                type: string;
+                description: string;
+            };
+            bucket: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            execution_id: {
+                type: string;
+                description: string;
+            };
+            search_id: {
+                type: string;
+                description: string;
+            };
+            event_type: {
+                type: string;
+                description: string;
+            };
+            kind: {
+                type: string;
+                description: string;
+            };
+            success: {
+                type: string;
+                description: string;
+            };
+            charge_outcome: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            min_credits: {
+                type: string;
+                description: string;
+            };
+            max_credits: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            mode: {
+                type: string;
+                enum: string[];
+                description: string;
+                default: string;
+            };
+            start_date: {
+                type: string;
+                description: string;
+            };
+            end_date: {
+                type: string;
+                description: string;
+            };
+            bucket: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            entry_type: {
+                type: string;
+                description: string;
+            };
+            direction: {
+                type: string;
+                enum: string[];
+                description: string;
+                default: string;
+            };
+            min_credits: {
+                type: string;
+                description: string;
+            };
+            max_credits: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+})[];
+export declare const DEPRECATED_ALIASES: Record<string, string>;
+/**
+ * Route one MCP tool call to the matching Qveris operation.
+ */
+export declare function executeQverisMcpTool(client: QverisClient, defaultSessionId: string, rawName: string, args: unknown, warn?: (message: string) => void): Promise<CallToolResult>;
+/**
+ * Main entry point for the Qveris MCP Server.
+ *
+ * Sets up the MCP server with stdio transport, registers the discover,
+ * inspect, and call handlers, and starts listening for requests.
+ */
+export declare function main(): Promise<void>;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;GAuBG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,oCAAoC,CAAC;AAI5C,OAAO,EAAuB,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAsCpE;;;;;GAKG;AACH,wBAAgB,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA0DjC;AAGD,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAIrD,CAAC;AAEF;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,YAAY,EACpB,gBAAgB,EAAE,MAAM,EACxB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,OAAO,EACb,IAAI,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAiD,GAC3E,OAAO,CAAC,cAAc,CAAC,CAyLzB;AAED;;;;;GAKG;AACH,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CA8D1C"}

package/dist/index.js

@@ -16,7 +16,7 @@
  *   "mcpServers": {
  *     "qveris": {
  *       "command": "npx",
- *       "args": ["@qverisai/mcp"],
+ *       "args": ["-y", "@qverisai/mcp"],
  *       "env": { "QVERIS_API_KEY": "your-api-key" }
  *     }
  *   }
@@ -26,6 +26,7 @@
 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 { pathToFileURL } from 'node:url';
 import { v4 as uuidv4 } from 'uuid';
 import { createClientFromEnv } from './api/client.js';
 import { searchToolsSchema, executeSearchTools, } from './tools/search.js';
@@ -41,276 +42,291 @@ const SERVER_NAME = 'qveris';
 const require = createRequire(import.meta.url);
 const { version: SERVER_VERSION } = require('../package.json');
 /**
- * Main entry point for the Qveris MCP Server.
+ * List the MCP tools exposed by this server.
  *
- * Sets up the MCP server with stdio transport, registers the discover,
- * inspect, and call handlers, and starts listening for requests.
+ * Kept as a pure export so the public MCP interface can be tested without
+ * starting stdio transport.
  */
-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: {},
+export function listQverisMcpTools() {
+    return [
+        // Primary tools (aligned with CLI naming)
+        {
+            name: 'discover',
+            description: 'Discover available tools based on natural language queries. ' +
+                'Returns relevant tools that can help accomplish tasks. ' +
+                'Use this to find tools before inspecting or calling them. ' +
+                'Results may include billing_rule metadata for rule-level pricing.',
+            inputSchema: searchToolsSchema,
         },
-    });
-    // =========================================================================
-    // Tool Handlers
-    // =========================================================================
-    /**
-     * Lists available tools.
-     * Returns the discover, inspect, and call definitions (plus deprecated aliases).
-     */
-    server.setRequestHandler(ListToolsRequestSchema, async () => {
-        return {
-            tools: [
-                // Primary tools (aligned with CLI naming)
-                {
-                    name: 'discover',
-                    description: 'Discover available tools based on natural language queries. ' +
-                        'Returns relevant tools that can help accomplish tasks. ' +
-                        'Use this to find tools before inspecting or calling them. ' +
-                        'Results may include billing_rule metadata for rule-level pricing.',
-                    inputSchema: searchToolsSchema,
-                },
-                {
-                    name: 'inspect',
-                    description: 'Inspect tools by their IDs to get detailed information. ' +
-                        'Returns parameters, success rate, latency, examples, and billing_rule when available. ' +
-                        'Use tool_ids from a previous discover call.',
-                    inputSchema: getToolsByIdsSchema,
-                },
-                {
-                    name: 'call',
-                    description: 'Call a specific remote tool with provided parameters. ' +
-                        'The tool_id and search_id must come from a previous discover call. ' +
-                        'Pass parameters to the tool through params_to_tool. ' +
-                        'The response may include pre-settlement billing; use usage_history or credits_ledger for final charge status.',
-                    inputSchema: executeToolSchema,
-                },
-                {
-                    name: 'usage_history',
-                    description: 'Context-safe usage audit query. Defaults to aggregated summary, supports precise search by execution_id/search_id/charge_outcome/credit range, and writes large exports to a local JSONL file instead of returning all rows.',
-                    inputSchema: usageHistorySchema,
-                },
-                {
-                    name: 'credits_ledger',
-                    description: 'Context-safe final credits ledger query. Defaults to aggregated summary, supports precise search by entry type/direction/credit range, and writes large exports to a local JSONL file instead of returning all rows.',
-                    inputSchema: creditsLedgerSchema,
-                },
-                // Deprecated aliases (backward compatibility)
-                {
-                    name: 'search_tools',
-                    description: '[Deprecated: use "discover" instead] Search for available tools based on natural language queries.',
-                    inputSchema: searchToolsSchema,
-                },
-                {
-                    name: 'get_tools_by_ids',
-                    description: '[Deprecated: use "inspect" instead] Get descriptions of tools based on their tool IDs.',
-                    inputSchema: getToolsByIdsSchema,
-                },
-                {
-                    name: 'execute_tool',
-                    description: '[Deprecated: use "call" instead] Execute a specific remote tool with provided parameters.',
-                    inputSchema: executeToolSchema,
-                },
-            ],
-        };
-    });
-    // Deprecated tool name aliases → canonical names
-    const DEPRECATED_ALIASES = {
-        search_tools: 'discover',
-        get_tools_by_ids: 'inspect',
-        execute_tool: 'call',
-    };
-    /**
-     * Handles tool execution requests.
-     * Routes to the appropriate handler based on tool name.
-     * Deprecated aliases emit a warning to stderr.
-     */
-    server.setRequestHandler(CallToolRequestSchema, async (request) => {
-        const { name: rawName, arguments: args } = request.params;
-        // Resolve deprecated aliases
-        let name = rawName;
-        if (DEPRECATED_ALIASES[rawName]) {
-            name = DEPRECATED_ALIASES[rawName];
-            process.stderr.write(`[qveris] Deprecated: "${rawName}" → use "${name}" instead\n`);
-        }
-        try {
-            if (name === 'discover') {
-                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 === 'inspect') {
-                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 === 'call') {
-                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 discover call',
-                                }),
-                            },
-                        ],
-                        isError: true,
-                    };
-                }
-                const result = await executeExecuteTool(client, input, defaultSessionId);
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: JSON.stringify(result, null, 2),
-                        },
-                    ],
-                };
-            }
-            if (name === 'usage_history') {
-                const input = (args ?? {});
-                const result = await executeUsageHistory(client, input);
+        {
+            name: 'inspect',
+            description: 'Inspect tools by their IDs to get detailed information. ' +
+                'Returns parameters, success rate, latency, examples, and billing_rule when available. ' +
+                'Use tool_ids from a previous discover call.',
+            inputSchema: getToolsByIdsSchema,
+        },
+        {
+            name: 'call',
+            description: 'Call a specific remote tool with provided parameters. ' +
+                'The tool_id and search_id must come from a previous discover call. ' +
+                'Pass parameters to the tool through params_to_tool. ' +
+                'The response may include pre-settlement billing; use usage_history or credits_ledger for final charge status.',
+            inputSchema: executeToolSchema,
+        },
+        {
+            name: 'usage_history',
+            description: 'Context-safe usage audit query. Defaults to aggregated summary, supports precise search by execution_id/search_id/charge_outcome/credit range, and writes large exports to a local JSONL file instead of returning all rows.',
+            inputSchema: usageHistorySchema,
+        },
+        {
+            name: 'credits_ledger',
+            description: 'Context-safe final credits ledger query. Defaults to aggregated summary, supports precise search by entry type/direction/credit range, and writes large exports to a local JSONL file instead of returning all rows.',
+            inputSchema: creditsLedgerSchema,
+        },
+        // Deprecated aliases (backward compatibility)
+        {
+            name: 'search_tools',
+            description: '[Deprecated: use "discover" instead] Search for available tools based on natural language queries.',
+            inputSchema: searchToolsSchema,
+        },
+        {
+            name: 'get_tools_by_ids',
+            description: '[Deprecated: use "inspect" instead] Get descriptions of tools based on their tool IDs.',
+            inputSchema: getToolsByIdsSchema,
+        },
+        {
+            name: 'execute_tool',
+            description: '[Deprecated: use "call" instead] Execute a specific remote tool with provided parameters.',
+            inputSchema: executeToolSchema,
+        },
+    ];
+}
+// Deprecated tool name aliases -> canonical names.
+export const DEPRECATED_ALIASES = {
+    search_tools: 'discover',
+    get_tools_by_ids: 'inspect',
+    execute_tool: 'call',
+};
+/**
+ * Route one MCP tool call to the matching Qveris operation.
+ */
+export async function executeQverisMcpTool(client, defaultSessionId, rawName, args, warn = (message) => process.stderr.write(message)) {
+    // Resolve deprecated aliases.
+    let name = rawName;
+    if (DEPRECATED_ALIASES[rawName]) {
+        name = DEPRECATED_ALIASES[rawName];
+        warn(`[qveris] Deprecated: "${rawName}" -> use "${name}" instead\n`);
+    }
+    try {
+        if (name === 'discover') {
+            const input = (args ?? {});
+            // Validate required fields.
+            if (!input.query || typeof input.query !== 'string') {
                 return {
                     content: [
                         {
                             type: 'text',
-                            text: JSON.stringify(result, null, 2),
+                            text: JSON.stringify({
+                                error: 'Missing required parameter: query',
+                                hint: 'Provide a natural language query describing the tool capability you need',
+                            }),
                         },
                     ],
+                    isError: true,
                 };
             }
-            if (name === 'credits_ledger') {
-                const input = (args ?? {});
-                const result = await executeCreditsLedger(client, input);
+            const result = await executeSearchTools(client, input, defaultSessionId);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        if (name === 'inspect') {
+            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(result, null, 2),
+                            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,
                 };
             }
-            // Unknown tool
+            const result = await executeGetToolsByIds(client, input, defaultSessionId);
             return {
                 content: [
                     {
                         type: 'text',
-                        text: JSON.stringify({
-                            error: `Unknown tool: ${rawName}`,
-                            available_tools: ['discover', 'inspect', 'call', 'usage_history', 'credits_ledger'],
-                        }),
+                        text: JSON.stringify(result, null, 2),
                     },
                 ],
-                isError: true,
             };
         }
-        catch (error) {
-            // Handle API errors
-            if (isApiError(error)) {
+        if (name === 'call') {
+            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: error.message,
-                                status: error.status,
-                                details: error.details,
+                                error: `Missing required parameters: ${missingFields.join(', ')}`,
+                                hint: 'tool_id and search_id must come from a previous discover call',
                             }),
                         },
                     ],
                     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;
+            const result = await executeExecuteTool(client, input, defaultSessionId);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        if (name === 'usage_history') {
+            const input = (args ?? {});
+            const result = await executeUsageHistory(client, input);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        if (name === 'credits_ledger') {
+            const input = (args ?? {});
+            const result = await executeCreditsLedger(client, input);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        // Unknown tool.
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        error: `Unknown tool: ${rawName}`,
+                        available_tools: ['discover', 'inspect', 'call', 'usage_history', 'credits_ledger'],
+                    }),
+                },
+            ],
+            isError: true,
+        };
+    }
+    catch (error) {
+        // Handle API errors.
+        if (isApiError(error)) {
             return {
                 content: [
                     {
                         type: 'text',
                         text: JSON.stringify({
-                            error: errorMessage,
-                            ...(errorCause && { cause: errorCause }),
+                            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,
+        };
+    }
+}
+/**
+ * Main entry point for the Qveris MCP Server.
+ *
+ * Sets up the MCP server with stdio transport, registers the discover,
+ * inspect, and call handlers, and starts listening for requests.
+ */
+export 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 discover, inspect, and call definitions (plus deprecated aliases).
+     */
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        return {
+            tools: listQverisMcpTools(),
+        };
+    });
+    /**
+     * Handles tool execution requests.
+     * Routes to the appropriate handler based on tool name.
+     * Deprecated aliases emit a warning to stderr.
+     */
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        return executeQverisMcpTool(client, defaultSessionId, name, args);
     });
     // =========================================================================
     // Start Server
@@ -330,9 +346,12 @@ function isApiError(error) {
         'status' in error &&
         'message' in error);
 }
-// Run the server
-main().catch((error) => {
-    console.error('Fatal error:', error);
-    process.exit(1);
-});
+// Run the server only when this file is the process entrypoint.
+const entrypoint = process.argv[1] ? pathToFileURL(process.argv[1]).href : undefined;
+if (entrypoint === import.meta.url) {
+    main().catch((error) => {
+        console.error('Fatal error:', error);
+        process.exit(1);
+    });
+}
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/tools/execute.d.ts

@@ -47,7 +47,7 @@ export interface ExecuteToolInput {
     max_response_size?: number;
 }
 /**
- * JSON Schema for the execute_tool tool input.
+ * JSON Schema for the call tool input.
  * Used by MCP to validate and document the tool parameters.
  */
 export declare const executeToolSchema: {
@@ -78,7 +78,7 @@ export declare const executeToolSchema: {
     required: string[];
 };
 /**
- * Executes the execute_tool operation.
+ * Executes the call operation.
  *
  * @param client - Initialized Qveris API client
  * @param input - Execution parameters

package/dist/tools/execute.js

@@ -7,7 +7,7 @@
  * @module tools/execute
  */
 /**
- * JSON Schema for the execute_tool tool input.
+ * JSON Schema for the call tool input.
  * Used by MCP to validate and document the tool parameters.
  */
 export const executeToolSchema = {
@@ -44,7 +44,7 @@ export const executeToolSchema = {
     required: ['tool_id', 'search_id', 'params_to_tool'],
 };
 /**
- * Executes the execute_tool operation.
+ * Executes the call operation.
  *
  * @param client - Initialized Qveris API client
  * @param input - Execution parameters

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

@@ -32,7 +32,7 @@ export interface GetToolsByIdsInput {
     session_id?: string;
 }
 /**
- * JSON Schema for the get_tools_by_ids tool input.
+ * JSON Schema for the inspect tool input.
  * Used by MCP to validate and document the tool parameters.
  */
 export declare const getToolsByIdsSchema: {
@@ -58,7 +58,7 @@ export declare const getToolsByIdsSchema: {
     required: string[];
 };
 /**
- * Executes the get_tools_by_ids operation.
+ * Executes the inspect operation.
  *
  * @param client - Initialized Qveris API client
  * @param input - Request parameters with tool IDs

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

@@ -8,7 +8,7 @@
  * @module tools/get-by-ids
  */
 /**
- * JSON Schema for the get_tools_by_ids tool input.
+ * JSON Schema for the inspect tool input.
  * Used by MCP to validate and document the tool parameters.
  */
 export const getToolsByIdsSchema = {
@@ -37,7 +37,7 @@ export const getToolsByIdsSchema = {
     required: ['tool_ids'],
 };
 /**
- * Executes the get_tools_by_ids operation.
+ * Executes the inspect operation.
  *
  * @param client - Initialized Qveris API client
  * @param input - Request parameters with tool IDs

package/dist/tools/search.d.ts

@@ -35,7 +35,7 @@ export interface SearchToolsInput {
     session_id?: string;
 }
 /**
- * JSON Schema for the search_tools tool input.
+ * JSON Schema for the discover tool input.
  * Used by MCP to validate and document the tool parameters.
  */
 export declare const searchToolsSchema: {
@@ -60,7 +60,7 @@ export declare const searchToolsSchema: {
     required: string[];
 };
 /**
- * Executes the search_tools operation.
+ * Executes the discover operation.
  *
  * @param client - Initialized Qveris API client
  * @param input - Search parameters

package/dist/tools/search.js

@@ -7,7 +7,7 @@
  * @module tools/search
  */
 /**
- * JSON Schema for the search_tools tool input.
+ * JSON Schema for the discover tool input.
  * Used by MCP to validate and document the tool parameters.
  */
 export const searchToolsSchema = {
@@ -35,7 +35,7 @@ export const searchToolsSchema = {
     required: ['query'],
 };
 /**
- * Executes the search_tools operation.
+ * Executes the discover operation.
  *
  * @param client - Initialized Qveris API client
  * @param input - Search parameters

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@qverisai/mcp",
-  "version": "0.6.0",
-  "description": "Official QVeris AI MCP Server SDK - Search and execute tools via natural language",
+  "version": "0.7.0",
+  "description": "QVeris MCP server for agent tool discovery, inspection, and calling",
   "keywords": [
     "qveris",
     "mcp",
@@ -14,12 +14,12 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/QVerisAI/QVerisAI",
+    "url": "https://github.com/QVerisAI/qveris-agent-toolkit",
     "directory": "packages/mcp"
   },
   "homepage": "https://qveris.ai",
   "bugs": {
-    "url": "https://github.com/QVerisAI/QVerisAI/issues"
+    "url": "https://github.com/QVerisAI/qveris-agent-toolkit/issues"
   },
   "type": "module",
   "main": "dist/index.js",
@@ -38,7 +38,8 @@
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
     "prepublishOnly": "npm run build",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "gen:openapi": "openapi-typescript ../../docs/openapi/qveris-public-api.openapi.json -o src/generated/openapi.d.ts && npx prettier --write src/generated/openapi.d.ts"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
@@ -47,6 +48,7 @@
   "devDependencies": {
     "@types/node": "^22.10.1",
     "@types/uuid": "^10.0.0",
+    "openapi-typescript": "7.4.4",
     "typescript": "^5.7.2",
     "vitest": "^2.1.0"
   },