@gala-chain/launchpad-mcp-server 1.5.0 → 1.5.1

package/dist/utils/tool-factory.js

@@ -0,0 +1,194 @@
+"use strict";
+/**
+ * Tool Factory Pattern Utilities
+ *
+ * DRY utilities for creating MCP tools with common patterns.
+ * Eliminates duplication across 47 tool definitions.
+ *
+ * @see Phase 2.1 of refactoring plan
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toolFactory = void 0;
+exports.createSimpleTokenFetchTool = createSimpleTokenFetchTool;
+exports.createBooleanCheckTool = createBooleanCheckTool;
+exports.createFetchTool = createFetchTool;
+exports.createResolutionTool = createResolutionTool;
+exports.createNoParamTool = createNoParamTool;
+const error_handler_js_1 = require("./error-handler.js");
+const response_formatter_js_1 = require("./response-formatter.js");
+const common_schemas_js_1 = require("../schemas/common-schemas.js");
+// =============================================================================
+// Factory Functions
+// =============================================================================
+/**
+ * Creates a simple fetch tool that takes tokenName and calls an SDK method
+ *
+ * @example
+ * ```typescript
+ * export const fetchPoolDetailsTool = createSimpleTokenFetchTool({
+ *   name: 'gala_launchpad_fetch_pool_details',
+ *   description: 'Get detailed pool state from GalaChain bonding curve',
+ *   handler: (sdk, tokenName) => sdk.fetchPoolDetails(tokenName),
+ * });
+ * ```
+ */
+function createSimpleTokenFetchTool(config) {
+    return {
+        name: config.name,
+        description: config.description,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                tokenName: common_schemas_js_1.TOKEN_NAME_SCHEMA,
+            },
+            required: ['tokenName'],
+        },
+        handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
+            const result = await config.handler(sdk, args.tokenName);
+            return (0, response_formatter_js_1.formatSuccess)(result);
+        }),
+    };
+}
+/**
+ * Creates a boolean check tool (e.g., isTokenNameAvailable, isTokenSymbolAvailable)
+ *
+ * @example
+ * ```typescript
+ * export const checkTokenNameTool = createBooleanCheckTool({
+ *   name: 'gala_launchpad_check_token_name',
+ *   description: 'Check if token name is available',
+ *   paramName: 'tokenName',
+ *   paramSchema: TOKEN_NAME_SCHEMA,
+ *   handler: (sdk, tokenName) => sdk.isTokenNameAvailable(tokenName),
+ *   messages: {
+ *     true: 'Token name is available',
+ *     false: 'Token name is already taken',
+ *   },
+ * });
+ * ```
+ */
+function createBooleanCheckTool(config) {
+    return {
+        name: config.name,
+        description: config.description,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                [config.paramName]: config.paramSchema,
+            },
+            required: [config.paramName],
+        },
+        handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
+            const value = args[config.paramName];
+            const available = await config.handler(sdk, value);
+            return (0, response_formatter_js_1.formatBoolean)(available, available ? config.messages.true : config.messages.false);
+        }),
+    };
+}
+/**
+ * Creates a generic fetch tool with custom input schema and handler
+ *
+ * @example
+ * ```typescript
+ * export const fetchPoolsTool = createFetchTool({
+ *   name: 'gala_launchpad_fetch_pools',
+ *   description: 'Fetch token pools from Gala Launchpad',
+ *   inputSchema: {
+ *     type: 'object',
+ *     properties: {
+ *       type: { type: 'string', enum: ['recent', 'popular'] },
+ *       page: PAGE_SCHEMA,
+ *       limit: createLimitSchema('pool', 20),
+ *     },
+ *   },
+ *   handler: (sdk, args) => sdk.fetchPools({
+ *     type: args.type || 'recent',
+ *     page: args.page || 1,
+ *     limit: args.limit || 20,
+ *   }),
+ * });
+ * ```
+ */
+function createFetchTool(config) {
+    return {
+        name: config.name,
+        description: config.description,
+        inputSchema: config.inputSchema,
+        handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
+            const result = await config.handler(sdk, args);
+            return (0, response_formatter_js_1.formatSuccess)(result);
+        }),
+    };
+}
+/**
+ * Creates a resolution tool that maps tokenName to some resolved value
+ *
+ * @example
+ * ```typescript
+ * export const resolveVaultAddressTool = createResolutionTool({
+ *   name: 'gala_launchpad_resolve_vault_address',
+ *   description: 'Get GalaChain vault address for a token',
+ *   resolver: (sdk, tokenName) => sdk.resolveVaultAddress(tokenName),
+ *   resultKey: 'vaultAddress',
+ * });
+ * ```
+ */
+function createResolutionTool(config) {
+    return {
+        name: config.name,
+        description: config.description,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                tokenName: common_schemas_js_1.TOKEN_NAME_SCHEMA,
+            },
+            required: ['tokenName'],
+        },
+        handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
+            const resolvedValue = await config.resolver(sdk, args.tokenName);
+            return (0, response_formatter_js_1.formatSuccess)({
+                tokenName: args.tokenName,
+                [config.resultKey]: resolvedValue,
+            });
+        }),
+    };
+}
+/**
+ * Creates a no-parameter tool that only needs SDK instance
+ *
+ * @example
+ * ```typescript
+ * export const getAddressTool = createNoParamTool({
+ *   name: 'gala_launchpad_get_address',
+ *   description: 'Get the GalaChain address format (eth|0x...) for the authenticated wallet.',
+ *   handler: (sdk) => sdk.getAddress(),
+ *   resultKey: 'address',
+ * });
+ * ```
+ */
+function createNoParamTool(config) {
+    return {
+        name: config.name,
+        description: config.description,
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+        handler: (0, error_handler_js_1.withErrorHandling)(async (sdk) => {
+            const result = await config.handler(sdk);
+            // If resultKey provided, wrap in object; otherwise return result directly
+            return (0, response_formatter_js_1.formatSuccess)(config.resultKey ? { [config.resultKey]: result } : result);
+        }),
+    };
+}
+// =============================================================================
+// Exports
+// =============================================================================
+exports.toolFactory = {
+    createSimpleTokenFetchTool,
+    createBooleanCheckTool,
+    createFetchTool,
+    createResolutionTool,
+    createNoParamTool,
+};
+//# sourceMappingURL=tool-factory.js.map

package/dist/utils/tool-factory.js.map

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

package/dist/utils/tool-registry.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Tool Registry System
+ *
+ * Enhanced tool registration with auto-validation, metadata, and search capabilities.
+ * Provides runtime validation and developer-friendly tool discovery.
+ *
+ * @see Phase 3.1 of refactoring plan
+ */
+import type { MCPTool } from '../types/mcp.js';
+/**
+ * Tool category metadata
+ */
+export interface ToolCategory {
+    name: string;
+    description: string;
+    tools: MCPTool[];
+    count: number;
+}
+/**
+ * Tool registry with metadata and search capabilities
+ */
+export interface ToolRegistry {
+    tools: MCPTool[];
+    categories: Map<string, ToolCategory>;
+    totalCount: number;
+    expectedCount: number;
+    isValid: boolean;
+    errors: string[];
+}
+/**
+ * Tool validation result
+ */
+export interface ToolValidationResult {
+    isValid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * Validates a single tool definition
+ */
+export declare function validateTool(tool: MCPTool): ToolValidationResult;
+/**
+ * Validates all tools in a registry
+ */
+export declare function validateTools(tools: MCPTool[]): ToolValidationResult;
+/**
+ * Creates a tool registry with metadata and validation
+ */
+export declare function createToolRegistry(categories: Array<{
+    name: string;
+    description: string;
+    tools: MCPTool[];
+}>, expectedCount?: number): ToolRegistry;
+/**
+ * Finds a tool by name
+ */
+export declare function findTool(registry: ToolRegistry, name: string): MCPTool | undefined;
+/**
+ * Finds tools by category
+ */
+export declare function findToolsByCategory(registry: ToolRegistry, categoryName: string): MCPTool[];
+/**
+ * Searches tools by name pattern
+ */
+export declare function searchTools(registry: ToolRegistry, pattern: string): MCPTool[];
+/**
+ * Gets tool statistics by category
+ */
+export declare function getToolStatistics(registry: ToolRegistry): {
+    total: number;
+    byCategory: Record<string, number>;
+};
+/**
+ * Logs tool registry statistics
+ */
+export declare function logToolRegistry(registry: ToolRegistry): void;
+/**
+ * Generates markdown documentation for tool registry
+ */
+export declare function generateToolDocumentation(registry: ToolRegistry): string;
+export declare const toolRegistry: {
+    createToolRegistry: typeof createToolRegistry;
+    validateTool: typeof validateTool;
+    validateTools: typeof validateTools;
+    findTool: typeof findTool;
+    findToolsByCategory: typeof findToolsByCategory;
+    searchTools: typeof searchTools;
+    getToolStatistics: typeof getToolStatistics;
+    logToolRegistry: typeof logToolRegistry;
+    generateToolDocumentation: typeof generateToolDocumentation;
+};
+//# sourceMappingURL=tool-registry.d.ts.map

package/dist/utils/tool-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../src/utils/tool-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAM/C;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAMD;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,oBAAoB,CA6ChE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,oBAAoB,CA+BpE;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,EAAE,CAAA;CAAE,CAAC,EAC1E,aAAa,CAAC,EAAE,MAAM,GACrB,YAAY,CAyCd;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAElF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,YAAY,EACtB,YAAY,EAAE,MAAM,GACnB,OAAO,EAAE,CAGX;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,EAAE,CAG9E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,YAAY,GAAG;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC,CAWA;AAMD;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAgB5D;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAiBxE;AAMD,eAAO,MAAM,YAAY;;;;;;;;;;CAUxB,CAAC"}

package/dist/utils/tool-registry.js

@@ -0,0 +1,227 @@
+"use strict";
+/**
+ * Tool Registry System
+ *
+ * Enhanced tool registration with auto-validation, metadata, and search capabilities.
+ * Provides runtime validation and developer-friendly tool discovery.
+ *
+ * @see Phase 3.1 of refactoring plan
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toolRegistry = void 0;
+exports.validateTool = validateTool;
+exports.validateTools = validateTools;
+exports.createToolRegistry = createToolRegistry;
+exports.findTool = findTool;
+exports.findToolsByCategory = findToolsByCategory;
+exports.searchTools = searchTools;
+exports.getToolStatistics = getToolStatistics;
+exports.logToolRegistry = logToolRegistry;
+exports.generateToolDocumentation = generateToolDocumentation;
+// =============================================================================
+// Validation Functions
+// =============================================================================
+/**
+ * Validates a single tool definition
+ */
+function validateTool(tool) {
+    const errors = [];
+    const warnings = [];
+    // Required fields
+    if (!tool.name) {
+        errors.push('Tool name is required');
+    }
+    else if (typeof tool.name !== 'string') {
+        errors.push('Tool name must be a string');
+    }
+    else if (!tool.name.startsWith('gala_launchpad_')) {
+        warnings.push(`Tool name "${tool.name}" should start with "gala_launchpad_"`);
+    }
+    if (!tool.description) {
+        errors.push('Tool description is required');
+    }
+    else if (typeof tool.description !== 'string') {
+        errors.push('Tool description must be a string');
+    }
+    if (!tool.inputSchema) {
+        errors.push('Tool inputSchema is required');
+    }
+    else {
+        // Validate input schema structure
+        if (tool.inputSchema.type !== 'object') {
+            errors.push('inputSchema.type must be "object"');
+        }
+        if (!tool.inputSchema.properties) {
+            warnings.push('inputSchema.properties is empty');
+        }
+        if (tool.inputSchema.required && !Array.isArray(tool.inputSchema.required)) {
+            errors.push('inputSchema.required must be an array');
+        }
+    }
+    if (!tool.handler) {
+        errors.push('Tool handler is required');
+    }
+    else if (typeof tool.handler !== 'function') {
+        errors.push('Tool handler must be a function');
+    }
+    return {
+        isValid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+/**
+ * Validates all tools in a registry
+ */
+function validateTools(tools) {
+    const allErrors = [];
+    const allWarnings = [];
+    const toolNames = new Set();
+    tools.forEach((tool, index) => {
+        const result = validateTool(tool);
+        // Collect errors with tool context
+        result.errors.forEach((error) => {
+            allErrors.push(`Tool #${index + 1} (${tool.name || 'unknown'}): ${error}`);
+        });
+        result.warnings.forEach((warning) => {
+            allWarnings.push(`Tool #${index + 1} (${tool.name || 'unknown'}): ${warning}`);
+        });
+        // Check for duplicate names
+        if (tool.name) {
+            if (toolNames.has(tool.name)) {
+                allErrors.push(`Duplicate tool name: ${tool.name}`);
+            }
+            toolNames.add(tool.name);
+        }
+    });
+    return {
+        isValid: allErrors.length === 0,
+        errors: allErrors,
+        warnings: allWarnings,
+    };
+}
+// =============================================================================
+// Registry Functions
+// =============================================================================
+/**
+ * Creates a tool registry with metadata and validation
+ */
+function createToolRegistry(categories, expectedCount) {
+    const allTools = [];
+    const categoryMap = new Map();
+    const registryErrors = [];
+    // Process each category
+    categories.forEach((category) => {
+        const toolCategory = {
+            name: category.name,
+            description: category.description,
+            tools: category.tools,
+            count: category.tools.length,
+        };
+        categoryMap.set(category.name, toolCategory);
+        allTools.push(...category.tools);
+    });
+    // Validate all tools
+    const validation = validateTools(allTools);
+    registryErrors.push(...validation.errors);
+    // Check expected count
+    const actualCount = allTools.length;
+    const hasExpectedCount = expectedCount !== undefined;
+    const countMatches = hasExpectedCount ? actualCount === expectedCount : true;
+    if (hasExpectedCount && !countMatches) {
+        registryErrors.push(`Tool count mismatch: expected ${expectedCount}, got ${actualCount}`);
+    }
+    return {
+        tools: allTools,
+        categories: categoryMap,
+        totalCount: actualCount,
+        expectedCount: expectedCount ?? actualCount,
+        isValid: registryErrors.length === 0,
+        errors: registryErrors,
+    };
+}
+/**
+ * Finds a tool by name
+ */
+function findTool(registry, name) {
+    return registry.tools.find((tool) => tool.name === name);
+}
+/**
+ * Finds tools by category
+ */
+function findToolsByCategory(registry, categoryName) {
+    const category = registry.categories.get(categoryName);
+    return category ? category.tools : [];
+}
+/**
+ * Searches tools by name pattern
+ */
+function searchTools(registry, pattern) {
+    const regex = new RegExp(pattern, 'i');
+    return registry.tools.filter((tool) => regex.test(tool.name));
+}
+/**
+ * Gets tool statistics by category
+ */
+function getToolStatistics(registry) {
+    const byCategory = {};
+    registry.categories.forEach((category, name) => {
+        byCategory[name] = category.count;
+    });
+    return {
+        total: registry.totalCount,
+        byCategory,
+    };
+}
+// =============================================================================
+// Logging and Reporting
+// =============================================================================
+/**
+ * Logs tool registry statistics
+ */
+function logToolRegistry(registry) {
+    console.log('\n📦 Tool Registry Statistics:');
+    console.log(`   Total Tools: ${registry.totalCount}/${registry.expectedCount}`);
+    console.log(`   Valid: ${registry.isValid ? '✅' : '❌'}`);
+    if (!registry.isValid && registry.errors.length > 0) {
+        console.log('\n❌ Validation Errors:');
+        registry.errors.forEach((error) => console.log(`   - ${error}`));
+    }
+    console.log('\n📂 Categories:');
+    registry.categories.forEach((category) => {
+        console.log(`   ${category.name}: ${category.count} tools`);
+    });
+    console.log('');
+}
+/**
+ * Generates markdown documentation for tool registry
+ */
+function generateToolDocumentation(registry) {
+    let doc = '# MCP Tool Registry\n\n';
+    doc += `**Total Tools**: ${registry.totalCount}\n\n`;
+    doc += '## Categories\n\n';
+    registry.categories.forEach((category) => {
+        doc += `### ${category.name} (${category.count} tools)\n\n`;
+        doc += `${category.description}\n\n`;
+        category.tools.forEach((tool) => {
+            doc += `- **${tool.name}**: ${tool.description}\n`;
+        });
+        doc += '\n';
+    });
+    return doc;
+}
+// =============================================================================
+// Export All
+// =============================================================================
+exports.toolRegistry = {
+    createToolRegistry,
+    validateTool,
+    validateTools,
+    findTool,
+    findToolsByCategory,
+    searchTools,
+    getToolStatistics,
+    logToolRegistry,
+    generateToolDocumentation,
+};
+//# sourceMappingURL=tool-registry.js.map

package/dist/utils/tool-registry.js.map

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

package/jest.integration.config.js

@@ -0,0 +1,70 @@
+/**
+ * Jest Configuration for Integration Tests
+ *
+ * Integration tests use real SDK instances and make actual API calls.
+ * Requires valid PRIVATE_KEY environment variable.
+ */
+
+module.exports = {
+  // Use ts-jest for TypeScript support
+  preset: 'ts-jest',
+
+  // Node.js environment (MCP server is server-side)
+  testEnvironment: 'node',
+
+  // Integration test file location patterns
+  roots: ['<rootDir>/src'],
+  testMatch: ['**/__tests__/integration/**/*.integration.test.ts'],
+
+  // Coverage collection
+  collectCoverageFrom: [
+    'src/tools/**/*.ts',
+    '!src/tools/**/__tests__/**',
+    '!src/**/*.d.ts',
+  ],
+
+  // Coverage reporters
+  coverageReporters: ['text', 'text-summary', 'html', 'lcov'],
+
+  // Module path aliases
+  moduleNameMapper: {
+    '^@/(.*}$': '<rootDir>/src/$1',
+    '^(\\.{1,2}/.*)\\.js$': '$1', // Map .js imports to .ts files
+  },
+
+  // Transform files with ts-jest
+  transform: {
+    '^.+\\.ts$': [
+      'ts-jest',
+      {
+        tsconfig: {
+          module: 'commonjs',
+          strict: true,
+          esModuleInterop: true,
+          skipLibCheck: true,
+        },
+      },
+    ],
+  },
+
+  // File extensions to consider
+  moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx', 'json'],
+
+  // Ignore patterns
+  testPathIgnorePatterns: ['/node_modules/', '/dist/', '/.history/'],
+
+  // Setup files (if needed for global test setup)
+  // setupFilesAfterEnv: ['<rootDir>/src/__tests__/setup.ts'],
+
+  // Clear mocks between tests
+  clearMocks: true,
+
+  // Verbose output
+  verbose: true,
+
+  // Integration tests may take longer
+  testTimeout: 60000, // 60 seconds
+
+  // Maximum worker threads (optimize for CI/CD)
+  maxWorkers: '50%',
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gala-chain/launchpad-mcp-server",
-  "version": "1.5.0",
+  "version": "1.5.1",
   "description": "MCP server for Gala Launchpad SDK with 47 tools + 14 slash commands - Production-grade AI agent integration with comprehensive validation, optimized performance, and 80%+ test coverage",
   "main": "dist/index.js",
   "bin": {
@@ -13,6 +13,10 @@
     "test": "jest --passWithNoTests",
     "test:watch": "jest --watch",
     "test:coverage": "jest --coverage",
+    "test:integration": "jest --config jest.integration.config.js",
+    "test:integration:coverage": "jest --config jest.integration.config.js --coverage",
+    "test:prompts": "npm run build && node src/scripts/test-all-prompts.ts",
+    "test:all": "npm run test && npm run test:integration && npm run test:prompts",
     "typecheck": "tsc --noEmit",
     "lint": "eslint src --ext .ts",
     "lint:fix": "eslint src --ext .ts --fix",
@@ -56,14 +60,14 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@gala-chain/launchpad-sdk": "^3.9.0",
-    "@modelcontextprotocol/sdk": "^0.5.0",
-    "ethers": "^6.15.0",
     "@gala-chain/api": "^2.4.3",
     "@gala-chain/connect": "^2.4.3",
-    "socket.io-client": "^4.8.1",
+    "@gala-chain/launchpad-sdk": "^3.9.1",
+    "@modelcontextprotocol/sdk": "^0.5.0",
     "axios": "^1.12.2",
     "bignumber.js": "^9.1.2",
+    "ethers": "^6.15.0",
+    "socket.io-client": "^4.8.1",
     "zod": "^3.25.76",
     "zod-to-json-schema": "^3.24.6"
   },