@convertcom/mcp-server 0.0.1-beta.3

package/README.md

@@ -0,0 +1,301 @@
+# Convert MCP Server
+
+Connect your Convert optimization data directly to Claude Desktop, Cursor, or any Model Context Protocol-compatible AI assistant. No middleware, no complex setup—just plug and play.
+
+**What is MCP?**
+
+MCP (Model Context Protocol) is an emerging standard that allows AI models to interact with applications through a consistent interface. It acts as an abstraction layer, letting AI agents access your Convert data without needing to understand specific API protocols.
+
+---
+
+## 🚀 Quick Start
+
+### Prerequisites
+
+**Get your Convert API credentials:**
+
+- Log into your Convert account
+- Go to Settings → Integrations → API
+- Generate or copy your Application ID and Secret Key
+- _Consider starting with read-only access (`TOOLS_FOR_CLIENT=reporting` or `TOOLS_FOR_CLIENT=readOnly` mod - see below)_
+
+### Installation & Setup
+
+#### Option 1: NPX (Recommended)
+
+```bash
+# No installation needed - run directly
+npx @convertcom/mcp-server
+```
+
+#### Option 2: Global Installation
+
+```bash
+# Install globally
+npm install -g @convertcom/mcp-server
+
+# Run the server
+mcp-server-convert
+```
+
+---
+
+## 🔧 Client Configuration
+
+### Claude Desktop
+
+1. **Download Claude Desktop** from [claude.ai](https://claude.ai/download)
+
+2. **Add server configuration** to your Claude Desktop config file:
+   - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+   - **Windows**: `%APPDATA%/Claude/claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "convert": {
+      "command": "npx",
+      "args": ["-y", "@convertcom/mcp-server"],
+      "env": {
+        "CONVERT_API_KEY": "your_convert_application_id",
+        "CONVERT_API_SECRET": "your_convert_secret_key",
+        "TOOLS_FOR_CLIENT": "reporting"
+      }
+    }
+  }
+}
+```
+
+1. **Save the file and restart Claude Desktop**. You should now see Convert tools available!
+
+2. **Visit the [troubleshooting section](#-troubleshooting)** if you encounter any issues.
+
+### Cursor
+
+1. **Create a `.cursor/mcp.json` file** in your project:
+
+```bash
+mkdir -p .cursor && touch .cursor/mcp.json
+```
+
+2. **Add the following configuration**:
+
+```json
+{
+  "mcpServers": {
+    "convert": {
+      "command": "npx",
+      "args": ["-y", "@convertcom/mcp-server"],
+      "env": {
+        "CONVERT_API_KEY": "your_convert_application_id",
+        "CONVERT_API_SECRET": "your_convert_secret_key",
+        "TOOLS_FOR_CLIENT": "reporting"
+      }
+    }
+  }
+}
+```
+
+3. **Save the file and restart Cursor**. Convert tools will now be available!
+
+---
+
+## 💬 Example Usage
+
+Once set up, try these example prompts with your AI assistant:
+
+### Get Insights from Your Convert Data
+
+```
+Show me the performance of all active experiments in my account
+```
+
+```
+How many experiences do I have running right now?
+```
+
+```
+Summarize all A/B tests with conversion rates above 5% from the last 30 days
+```
+
+### Analyze Experiment Performance
+
+```
+Get me the latest conversion data for my homepage experiment
+```
+
+```
+Compare the performance of mobile vs desktop experiments this month
+```
+
+```
+Show me which audience segments are performing best across all active tests
+```
+
+### Create and Manage Tests (Full Access Mode)
+
+```
+Create a new A/B test for the pricing page targeting returning visitors with a 70/30 traffic split
+```
+
+```
+Pause any experiences that have been running for more than 30 days with negative lift
+```
+
+```
+Update the traffic allocation for experiment ID 12345 to 50/50
+```
+
+---
+
+## ⚙️ Configuration
+
+All configuration is handled through environment variables for maximum compatibility across different MCP clients.
+
+| Variable             | Required | Description                                     | Default     |
+| -------------------- | -------- | ----------------------------------------------- | ----------- |
+| `CONVERT_API_KEY`    | ✅       | Your Convert **Application ID**                 | -           |
+| `CONVERT_API_SECRET` | ✅       | Your Convert **Secret Key**                     | -           |
+| `TOOLS_FOR_CLIENT`   |          | Access level: `reporting`, `readOnly`, or `all` | `reporting` |
+
+### Access Levels
+
+Choose the appropriate access level based on your needs:
+
+#### 🔍 `reporting` (Default - Recommended)
+
+**Perfect for analytics and insights**
+
+- Account data and project information
+- Real-time experiment tracking and performance reports
+- Goals, audiences, and conversion analytics
+- Live visitor data and traffic allocation
+
+#### 📖 `readOnly`
+
+**All reporting tools plus detailed configuration access**
+
+- Everything in `reporting` mode
+- Detailed project and experience configurations
+- Historical data and change logs
+- Advanced analytics and forecasting data
+
+#### 🔧 `all` (Use with caution)
+
+**Complete access including write operations**
+
+- Everything in `readOnly` mode
+- Create, edit, and delete experiments
+- Manage audiences, goals, and project settings
+- Full account administration capabilities
+
+> **⚠️ Security Note**: Start with `reporting` mode and only escalate permissions as needed. The `all` access level can modify your Convert account.
+
+---
+
+## 🛠️ Available Tools
+
+The server provides **100+ tools** covering the complete Convert REST API v2. Here's a quick overview:
+
+### Core Analytics Tools (All Access Levels)
+
+| Category                | Tools                                                                  | Description                              |
+| ----------------------- | ---------------------------------------------------------------------- | ---------------------------------------- |
+| **Account Management**  | `getaccountslist`, `getaccountlivedata`                                | Account overview and real-time tracking  |
+| **Project Operations**  | `getprojectslist`, `getproject`, `getprojectlivedata`                  | Project configuration and live data      |
+| **Experience Tracking** | `getexperienceslist`, `getexperience`, `getexperienceaggregatedreport` | A/B test performance and analytics       |
+| **Goal Analytics**      | `getgoal`, `getgoalbykey`                                              | Conversion goal tracking and performance |
+| **Audience Insights**   | `getaudienceslist`, `getaudience`                                      | Audience segment analysis                |
+| **Location Targeting**  | `getlocationslist`, `getlocation`                                      | URL targeting and location rules         |
+
+### Advanced Tools (ReadOnly & All Access)
+
+| Category            | Tools                                                            | Description                      |
+| ------------------- | ---------------------------------------------------------------- | -------------------------------- |
+| **Historical Data** | `getaccounthistory`, `getprojecthistory`, `getexperiencehistory` | Change logs and audit trails     |
+| **Screenshots**     | `getexperiencevariationscreenshot`                               | Visual variation previews        |
+| **Knowledge Base**  | `getknowledgebaseslist`, `getknowledgebase`                      | Test insights and learnings      |
+| **Observations**    | `getobservationslist`                                            | Recorded insights and hypotheses |
+
+### Management Tools (All Access Only)
+
+| Category                   | Tools                                                      | Description                    |
+| -------------------------- | ---------------------------------------------------------- | ------------------------------ |
+| **Experience Management**  | `createexperience`, `updateexperience`, `deleteexperience` | Full A/B test lifecycle        |
+| **Goal Management**        | `creategoal`, `updategoal`, `deletegoal`, `clonegoal`      | Conversion goal administration |
+| **Audience Management**    | `createaudience`, `updateaudience`, `deleteaudience`       | Audience segment management    |
+| **Project Administration** | `createproject`, `updateproject`                           | Project-level configuration    |
+
+---
+
+## 🔒 Security & Authentication
+
+### API Security
+
+- **HMAC-SHA256 signing**: Every request is cryptographically signed
+- **Automatic expiration**: Requests expire after 60 seconds
+- **No credential exposure**: API keys never leave your local environment
+
+---
+
+## 🔧 Troubleshooting
+
+### Common Issues
+
+| Symptom                      | Likely Cause                        | Solution                                        |
+| ---------------------------- | ----------------------------------- | ----------------------------------------------- |
+| `401 Unauthorized` responses | Wrong API credentials or clock skew | Verify credentials, sync system clock           |
+| "Server not found" in Claude | JSON config syntax error            | Check `command` and `args` fields               |
+| Missing expected tools       | `TOOLS_FOR_CLIENT` too restrictive  | Switch to `readOnly` or `all` and restart       |
+| Connection timeouts          | Network/firewall issues             | Check connectivity to Convert's API endpoints   |
+| "No data returned"           | Empty account or wrong permissions  | Verify account has data and API key permissions |
+
+### Getting Help
+
+1. **Check the logs**: Development mode provides detailed error information
+2. **Verify credentials**: Ensure your API key and secret are correct and have proper permissions
+3. **Test connectivity**: Confirm you can reach Convert's API endpoints
+4. **Review permissions**: Make sure your Convert account has access to the data you're requesting
+
+---
+
+## 📊 What You Can Do
+
+### Real-time Analytics
+
+- Monitor live experiment performance
+- Track visitor behavior and conversions
+- Analyze traffic allocation and statistical significance
+- Get instant insights on goal performance
+
+### Experiment Management
+
+- Create and configure A/B tests
+- Set up multivariate experiments
+- Manage audience targeting and segmentation
+- Control traffic allocation and experiment lifecycle
+
+### Data-Driven Insights
+
+- Historical performance analysis
+- Conversion funnel optimization
+- Audience behavior patterns
+- ROI and revenue impact assessment
+
+### AI-Powered Optimization
+
+- Let AI analyze your experiment data
+- Get recommendations for test improvements
+- Automate routine optimization tasks
+- Generate insights from complex data patterns
+
+---
+
+## 🆘 Support
+
+- **Documentation**: [Convert API Documentation](https://api.convert.com/doc/)
+- **Convert Support**: [Convert Help Center](https://support.convert.com/)
+
+---
+
+_© 2025 Convert Insights, Inc. • Built with ❤️ for the optimization community_

package/build/api-config.d.ts

@@ -0,0 +1 @@
+export {};

package/build/api-config.js

@@ -0,0 +1,40 @@
+import axios from 'axios';
+import crypto from 'crypto';
+axios.defaults.headers.post['Content-Type'] = 'application/json';
+axios.defaults.headers.put['Content-Type'] = 'application/json';
+//axios.defaults.headers.get['Content-Type'] = 'application/json';
+axios.defaults.transformRequest = [
+    function (data, headers) {
+        //console.warn('data', data);
+        if (!data) {
+            data = {};
+        }
+        return JSON.stringify(data);
+    },
+];
+// Add a request interceptor to set the 'x-convert-nonce' header
+axios.interceptors.request.use((config) => {
+    let applicationID = process.env.CONVERT_API_KEY;
+    let applicationSecretKey = process.env.CONVERT_API_SECRET;
+    let expires = 60; // In seconds. Request lifetime. If your requests take much time, try to increase this value
+    let requestURL = config.url;
+    // It's already stringified in raw body in Postman but make sure it stringified correctly without whitespaces etc
+    let requestBody = config.data ? JSON.stringify(config.data) : '{}';
+    //let expiresTimestamp = '1747916037.342'; //Date.now() / 1000 + expires;
+    let expiresTimestamp = Date.now() / 1000 + expires;
+    let signString = applicationID + '\n' + expiresTimestamp + '\n' + requestURL + '\n' + requestBody;
+    let hash = crypto.createHmac('sha256', applicationSecretKey).update(signString).digest('hex');
+    let authorization = 'Convert-HMAC-SHA256 Signature=' + hash;
+    // console.warn('Debug data:', data); // Or console.warn
+    // console.warn(`Debug RequestBody: ${requestBody}`);
+    // console.warn(`Debug SigningString: ${signString}`);
+    // console.warn(`Debug Api Secret: ${applicationSecretKey ? 'SET' : 'NOT SET'}`); // Avoid logging secrets
+    config.headers['Convert-Application-ID'] = applicationID;
+    config.headers['Expires'] = expiresTimestamp;
+    config.headers['Authorization'] = authorization;
+    // console.warn('config.headers:', config.headers);
+    return config;
+}, (error) => {
+    return Promise.reject(error);
+});
+//# sourceMappingURL=api-config.js.map

package/build/api-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-config.js","sourceRoot":"","sources":["../src/api-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;AACjE,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;AAChE,kEAAkE;AAClE,KAAK,CAAC,QAAQ,CAAC,gBAAgB,GAAG;IAChC,UAAU,IAAS,EAAE,OAAY;QAC/B,6BAA6B;QAC7B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,GAAG,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;CACF,CAAC;AAEF,gEAAgE;AAChE,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAC5B,CAAC,MAAM,EAAE,EAAE;IACT,IAAI,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAChD,IAAI,oBAAoB,GAAG,OAAO,CAAC,GAAG,CAAC,kBAA4B,CAAC;IACpE,IAAI,OAAO,GAAG,EAAE,CAAC,CAAC,4FAA4F;IAC9G,IAAI,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC;IAE5B,iHAAiH;IACjH,IAAI,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACnE,yEAAyE;IACzE,IAAI,gBAAgB,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,GAAG,OAAO,CAAC;IAEnD,IAAI,UAAU,GACZ,aAAa,GAAG,IAAI,GAAG,gBAAgB,GAAG,IAAI,GAAG,UAAU,GAAG,IAAI,GAAG,WAAW,CAAC;IAEnF,IAAI,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,oBAAoB,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9F,IAAI,aAAa,GAAG,gCAAgC,GAAG,IAAI,CAAC;IAE5D,wDAAwD;IACxD,qDAAqD;IACrD,sDAAsD;IACtD,0GAA0G;IAE1G,MAAM,CAAC,OAAO,CAAC,wBAAwB,CAAC,GAAG,aAAa,CAAC;IACzD,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,gBAAgB,CAAC;IAC7C,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,GAAG,aAAa,CAAC;IAEhD,mDAAmD;IAEnD,OAAO,MAAM,CAAC;AAChB,CAAC,EACD,CAAC,KAAK,EAAE,EAAE;IACR,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC,CACF,CAAC"}

package/build/index.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * MCP Server generated from OpenAPI spec for convert-api v2.0.0
+ * Generated on: 2025-06-05T16:52:41.275Z
+ */
+import './api-config.js';
+/**
+ * Server configuration
+ */
+export declare const SERVER_NAME = "convert-api";
+export declare const SERVER_VERSION = "2.0.0";
+export declare const API_BASE_URL = "https://api.convert.com/api/v2";

package/build/index.js

@@ -0,0 +1,312 @@
+#!/usr/bin/env node
+/**
+ * MCP Server generated from OpenAPI spec for convert-api v2.0.0
+ * Generated on: 2025-06-05T16:52:41.275Z
+ */
+// Load environment variables from .env file
+import dotenv from 'dotenv';
+dotenv.config();
+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 { z, ZodError } from 'zod';
+import { jsonSchemaToZod } from 'json-schema-to-zod';
+import axios from 'axios';
+if (process.env.NODE_ENV === 'development') {
+    import('mcps-logger/console');
+}
+import './api-config.js';
+import { toolDefinitionMap } from './tools.js';
+function getToolsForClient() {
+    const reportingTools = [
+        'getaccountslist',
+        'getaccountlivedata',
+        'getaccountactivecompletedexperienceslist',
+        'getprojectslist',
+        'getproject',
+        'getprojectlivedata',
+        'getexperienceslist',
+        'getexperience',
+        'getexperiencebykey',
+        'getexperiencelivedata',
+        'getexperienceaggregatedreport',
+        'getexperiencedailyreport',
+        'getexperiencedailytrafficallocation',
+        'getgoal',
+        'getgoalbykey',
+        'getlocation',
+        'getlocationslist',
+        'getaudienceslist',
+        'getaudience',
+        'getfeatureslist',
+        'getfeature',
+        'getfeaturebykey',
+    ];
+    const toolSet = process.env.TOOLS_FOR_CLIENT ?? 'reporting';
+    return Array.from(toolDefinitionMap.values())
+        .filter((def) => {
+        if (toolSet === 'readOnly') {
+            if (def.name.match(/^get/)) {
+                return true;
+            }
+            return false;
+        }
+        else if (toolSet === 'reporting') {
+            return reportingTools.indexOf(def.name) !== -1;
+        }
+        return true;
+    })
+        .map((def) => {
+        return {
+            name: def.name,
+            description: def.description,
+            inputSchema: def.inputSchema,
+        };
+    })
+        .filter((tool) => tool !== null);
+}
+/**
+ * Server configuration
+ */
+export const SERVER_NAME = "convert-api";
+export const SERVER_VERSION = "2.0.0";
+export const API_BASE_URL = "https://api.convert.com/api/v2";
+/**
+ * MCP Server instance
+ */
+const server = new Server({ name: SERVER_NAME, version: SERVER_VERSION }, { capabilities: { tools: {} } });
+/**
+ * Security schemes from the OpenAPI spec
+ */
+const securitySchemes = {};
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return { tools: getToolsForClient() };
+});
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name: toolName, arguments: toolArgs } = request.params;
+    const toolDefinition = toolDefinitionMap.get(toolName);
+    if (!toolDefinition) {
+        console.error(`Error: Unknown tool requested: ${toolName}`);
+        return { content: [{ type: "text", text: `Error: Unknown tool requested: ${toolName}` }] };
+    }
+    return await executeApiTool(toolName, toolDefinition, toolArgs ?? {}, securitySchemes);
+});
+/**
+ * Executes an API tool with the provided arguments
+ *
+ * @param toolName Name of the tool to execute
+ * @param definition Tool definition
+ * @param toolArgs Arguments provided by the user
+ * @param allSecuritySchemes Security schemes from the OpenAPI spec
+ * @returns Call tool result
+ */
+async function executeApiTool(toolName, definition, toolArgs, allSecuritySchemes) {
+    try {
+        // Validate arguments against the input schema
+        let validatedArgs;
+        try {
+            const zodSchema = getZodSchemaFromJsonSchema(definition.inputSchema, toolName);
+            const argsToParse = (typeof toolArgs === 'object' && toolArgs !== null) ? toolArgs : {};
+            validatedArgs = zodSchema.parse(argsToParse);
+        }
+        catch (error) {
+            if (error instanceof ZodError) {
+                const validationErrorMessage = `Invalid arguments for tool '${toolName}': ${error.errors.map(e => `${e.path.join('.')} (${e.code}): ${e.message}`).join(', ')}`;
+                return { content: [{ type: 'text', text: validationErrorMessage }] };
+            }
+            else {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                return { content: [{ type: 'text', text: `Internal error during validation setup: ${errorMessage}` }] };
+            }
+        }
+        // Prepare URL, query parameters, headers, and request body
+        let urlPath = definition.pathTemplate;
+        const queryParams = {};
+        const headers = { 'Accept': 'application/json' };
+        let requestBodyData = undefined;
+        // Apply parameters to the URL path, query, or headers
+        definition.executionParameters.forEach((param) => {
+            const value = validatedArgs[param.name];
+            if (typeof value !== 'undefined' && value !== null) {
+                if (param.in === 'path') {
+                    urlPath = urlPath.replace(`{${param.name}}`, encodeURIComponent(String(value)));
+                }
+                else if (param.in === 'query') {
+                    queryParams[param.name] = value;
+                }
+                else if (param.in === 'header') {
+                    headers[param.name.toLowerCase()] = String(value);
+                }
+            }
+        });
+        // Ensure all path parameters are resolved
+        if (urlPath.includes('{')) {
+            throw new Error(`Failed to resolve path parameters: ${urlPath}`);
+        }
+        // Construct the full URL
+        const requestUrl = API_BASE_URL ? `${API_BASE_URL}${urlPath}` : urlPath;
+        // Handle request body if needed
+        if (definition.requestBodyContentType && typeof validatedArgs['requestBody'] !== 'undefined') {
+            requestBodyData = validatedArgs['requestBody'];
+            headers['content-type'] = definition.requestBodyContentType;
+        }
+        // Prepare the axios request configuration
+        const config = {
+            method: definition.method.toUpperCase(),
+            url: requestUrl,
+            params: queryParams,
+            headers: headers,
+            ...(requestBodyData !== undefined && { data: requestBodyData }),
+        };
+        // Log request info to stderr (doesn't affect MCP output)
+        console.error(`Executing tool "${toolName}": ${config.method} ${config.url}`);
+        // Execute the request
+        const response = await axios(config);
+        // Process and format the response
+        let responseText = '';
+        const contentType = response.headers['content-type']?.toLowerCase() || '';
+        // Handle JSON responses
+        if (contentType.includes('application/json') && typeof response.data === 'object' && response.data !== null) {
+            try {
+                responseText = JSON.stringify(response.data, null, 2);
+            }
+            catch (e) {
+                responseText = "[Stringify Error]";
+            }
+        }
+        // Handle string responses
+        else if (typeof response.data === 'string') {
+            responseText = response.data;
+        }
+        // Handle other response types
+        else if (response.data !== undefined && response.data !== null) {
+            responseText = String(response.data);
+        }
+        // Handle empty responses
+        else {
+            responseText = `(Status: ${response.status} - No body content)`;
+        }
+        // Return formatted response
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `API Response (Status: ${response.status}):\n${responseText}`
+                }
+            ],
+        };
+    }
+    catch (error) {
+        // Handle errors during execution
+        let errorMessage;
+        // Format Axios errors specially
+        if (axios.isAxiosError(error)) {
+            errorMessage = formatApiError(error);
+        }
+        // Handle standard errors
+        else if (error instanceof Error) {
+            errorMessage = error.message;
+        }
+        // Handle unexpected error types
+        else {
+            errorMessage = 'Unexpected error: ' + String(error);
+        }
+        // Log error to stderr
+        console.error(`Error during execution of tool '${toolName}':`, errorMessage);
+        // Return error message to client
+        return { content: [{ type: "text", text: errorMessage }] };
+    }
+}
+/**
+ * Main function to start the server
+ */
+async function main() {
+    // Set up stdio transport
+    try {
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+        console.error(`${SERVER_NAME} MCP Server (v${SERVER_VERSION}) running on stdio${API_BASE_URL ? `, proxying API at ${API_BASE_URL}` : ''}`);
+    }
+    catch (error) {
+        console.error("Error during server startup:", error);
+        process.exit(1);
+    }
+}
+/**
+ * Cleanup function for graceful shutdown
+ */
+async function cleanup() {
+    console.error("Shutting down MCP server...");
+    process.exit(0);
+}
+// Register signal handlers
+process.on('SIGINT', cleanup);
+process.on('SIGTERM', cleanup);
+// Start the server
+main().catch((error) => {
+    console.error("Fatal error in main execution:", error);
+    process.exit(1);
+});
+/**
+ * Formats API errors for better readability
+ *
+ * @param error Axios error
+ * @returns Formatted error message
+ */
+function formatApiError(error) {
+    let message = 'API request failed.';
+    if (error.response) {
+        message = `API Error: Status ${error.response.status} (${error.response.statusText || 'Status text not available'}). `;
+        const responseData = error.response.data;
+        const MAX_LEN = 200;
+        if (typeof responseData === 'string') {
+            message += `Response: ${responseData.substring(0, MAX_LEN)}${responseData.length > MAX_LEN ? '...' : ''}`;
+        }
+        else if (responseData) {
+            try {
+                const jsonString = JSON.stringify(responseData);
+                message += `Response: ${jsonString.substring(0, MAX_LEN)}${jsonString.length > MAX_LEN ? '...' : ''}`;
+            }
+            catch {
+                message += 'Response: [Could not serialize data]';
+            }
+        }
+        else {
+            message += 'No response body received.';
+        }
+    }
+    else if (error.request) {
+        message = 'API Network Error: No response received from server.';
+        if (error.code)
+            message += ` (Code: ${error.code})`;
+    }
+    else {
+        message += `API Request Setup Error: ${error.message}`;
+    }
+    return message;
+}
+/**
+ * Converts a JSON Schema to a Zod schema for runtime validation
+ *
+ * @param jsonSchema JSON Schema
+ * @param toolName Tool name for error reporting
+ * @returns Zod schema
+ */
+function getZodSchemaFromJsonSchema(jsonSchema, toolName) {
+    if (typeof jsonSchema !== 'object' || jsonSchema === null) {
+        return z.object({}).passthrough();
+    }
+    try {
+        const zodSchemaString = jsonSchemaToZod(jsonSchema);
+        const zodSchema = eval(zodSchemaString);
+        if (typeof zodSchema?.parse !== 'function') {
+            throw new Error('Eval did not produce a valid Zod schema.');
+        }
+        return zodSchema;
+    }
+    catch (err) {
+        console.error(`Failed to generate/evaluate Zod schema for '${toolName}':`, err);
+        return z.object({}).passthrough();
+    }
+}
+//# sourceMappingURL=index.js.map