@lagoon-protocol/lagoon-mcp 0.1.0

package/dist/tools/predict-yield.js

@@ -0,0 +1,248 @@
+/**
+ * predict_yield Tool
+ *
+ * ML-based yield forecasting for vault APR prediction.
+ * Analyzes historical performance to predict future returns.
+ *
+ * Use cases:
+ * - Investment planning and return projections
+ * - Yield farming strategy optimization
+ * - Risk-adjusted return forecasting
+ * - Performance trend analysis
+ * - Performance: ~400-600 tokens per prediction
+ *
+ * Cache strategy:
+ * - 60-minute TTL (predictions valid for moderate duration)
+ * - Cache key: yield_prediction:{chainId}:{vaultAddress}:{timeRange}
+ * - Cache hit rate target: 75-85%
+ * - Cache tags: [CacheTag.VAULT, CacheTag.APR, CacheTag.ANALYTICS] for invalidation
+ */
+import { getToolDisclaimer } from '../utils/disclaimers.js';
+import * as PredictionQueries from '../graphql/queries/prediction.queries.js';
+import { predictYield } from '../utils/yield-prediction.js';
+import { executeToolWithCache } from '../utils/execute-tool-with-cache.js';
+import { CacheTag } from '../core/cache-invalidation.js';
+import { cacheTTL } from '../cache/index.js';
+import { transformPeriodSummariesToAPRData, calculateAPRFromPriceChange, } from '../sdk/apr-service.js';
+/**
+ * Time range constants (in seconds)
+ */
+const TIME_RANGES = {
+    '7d': 7 * 24 * 60 * 60,
+    '30d': 30 * 24 * 60 * 60,
+    '90d': 90 * 24 * 60 * 60,
+};
+/**
+ * Format yield prediction as markdown
+ */
+function formatYieldPrediction(prediction, vaultName, timeRange) {
+    const trendEmoji = {
+        increasing: '📈',
+        decreasing: '📉',
+        stable: '➡️',
+    }[prediction.trend];
+    const confidenceEmoji = prediction.confidence > 0.7 ? '🟢' : prediction.confidence > 0.4 ? '🟡' : '🔴';
+    const hasFeeData = prediction.feeAdjustedAPR !== undefined && prediction.feeImpact;
+    let output = `
+## Yield Prediction: ${vaultName}
+
+### Current Performance
+- **Current APR**: ${Number(prediction.currentAPR).toFixed(2)}%
+- **Predicted APR**: ${Number(prediction.predictedAPR).toFixed(2)}%${hasFeeData ? ` (Gross)` : ''}
+${hasFeeData ? `- **Predicted Net APR**: ${Number(prediction.feeAdjustedAPR).toFixed(2)}% (After Fees)` : ''}
+- **Trend**: ${trendEmoji} ${prediction.trend.charAt(0).toUpperCase() + prediction.trend.slice(1)}
+- **Confidence**: ${confidenceEmoji} ${(prediction.confidence * 100).toFixed(0)}%
+
+---
+`;
+    if (hasFeeData) {
+        output += `
+### Fee Impact
+
+- **Management Fee**: ${Number(prediction.feeImpact?.managementFee).toFixed(2)}% annually
+- **Performance Fee**: ${Number(prediction.feeImpact?.performanceFee).toFixed(2)}%${prediction.feeImpact?.performanceFeeActive ? ' (Currently Active - Above High Water Mark)' : ' (Inactive - Below High Water Mark)'}
+- **Total Annual Fee Drag**: ${Number(prediction.feeImpact?.totalAnnualFeeDrag).toFixed(2)}%
+- **Net Impact**: Reduces predicted returns from ${Number(prediction.predictedAPR).toFixed(2)}% to ${Number(prediction.feeAdjustedAPR).toFixed(2)}%
+
+---
+`;
+    }
+    output += `
+### Projected Returns
+
+Based on ${timeRange} historical data:
+
+`;
+    if (hasFeeData) {
+        output += `#### Gross Returns (Before Fees)
+
+| Timeframe | Expected Return | Range (Min-Max) |
+|-----------|----------------|-----------------|
+${prediction.projectedReturns
+            .map((p) => `| **${p.timeframe}** | ${p.expectedReturn.toFixed(2)}% | ${p.minReturn.toFixed(2)}% - ${p.maxReturn.toFixed(2)}% |`)
+            .join('\n')}
+
+#### Net Returns (After Fees)
+
+| Timeframe | Expected Return | Range (Min-Max) |
+|-----------|----------------|-----------------|
+${prediction
+            .feeAdjustedReturns.map((p) => `| **${p.timeframe}** | ${p.expectedReturn.toFixed(2)}% | ${p.minReturn.toFixed(2)}% - ${p.maxReturn.toFixed(2)}% |`)
+            .join('\n')}
+`;
+    }
+    else {
+        output += `| Timeframe | Expected Return | Range (Min-Max) |
+|-----------|----------------|-----------------|
+${prediction.projectedReturns
+            .map((p) => `| **${p.timeframe}** | ${p.expectedReturn.toFixed(2)}% | ${p.minReturn.toFixed(2)}% - ${p.maxReturn.toFixed(2)}% |`)
+            .join('\n')}
+`;
+    }
+    output += `
+---
+
+### Key Insights
+
+${prediction.insights.map((insight) => `- ${insight}`).join('\n')}
+
+---
+
+### Methodology
+
+This prediction uses:
+- **Linear Regression**: Long-term trend analysis
+- **Exponential Moving Averages**: Short-term momentum
+- **Volatility Analysis**: Confidence interval calculation
+- **Historical Data**: ${timeRange} performance window
+
+**Note**: Predictions are estimates based on historical performance. Actual returns may vary due to market conditions, protocol changes, and external factors.
+`;
+    return output;
+}
+/**
+ * Transform raw GraphQL response into yield prediction markdown output
+ * Uses closure to capture input values
+ */
+function createTransformYieldPredictionData(input, timestampThreshold) {
+    return (data) => {
+        // Prepare historical data points
+        const historicalData = [];
+        // Transform performance history to period summaries for SDK
+        if (data.performanceHistory && data.performanceHistory.items.length > 0) {
+            const periodSummaries = data.performanceHistory.items
+                .filter((item) => parseInt(item.timestamp, 10) >= timestampThreshold)
+                .map((item) => ({
+                timestamp: item.timestamp,
+                totalAssetsAtStart: item.data.totalAssetsAtStart,
+                totalSupplyAtStart: item.data.totalSupplyAtStart,
+            }));
+            // Use SDK to calculate APR from period summaries
+            const aprData = transformPeriodSummariesToAPRData(periodSummaries, data.vault);
+            // Calculate APR for each data point using SDK functions
+            for (const item of data.performanceHistory.items) {
+                const timestamp = parseInt(item.timestamp, 10);
+                if (timestamp >= timestampThreshold) {
+                    // Calculate price per share at this point
+                    const historicalPeriod = {
+                        timestamp: item.timestamp,
+                        totalAssetsAtStart: item.data.totalAssetsAtStart,
+                        totalSupplyAtStart: item.data.totalSupplyAtStart,
+                    };
+                    // Use inception point as baseline for historical APR calculation
+                    if (aprData.inception) {
+                        const daysElapsed = (timestamp - aprData.inception.timestamp) / (24 * 60 * 60);
+                        if (daysElapsed > 0) {
+                            // Calculate price per share for this period using SDK helper
+                            const historicalAPRData = transformPeriodSummariesToAPRData([historicalPeriod], data.vault);
+                            if (historicalAPRData.inception) {
+                                const apr = calculateAPRFromPriceChange(aprData.inception.pricePerShare, historicalAPRData.inception.pricePerShare, daysElapsed);
+                                historicalData.push({
+                                    timestamp,
+                                    apr: apr, // APR as percentage
+                                    tvl: Number(item.data.totalAssetsAtEnd),
+                                });
+                            }
+                        }
+                    }
+                }
+            }
+        }
+        // Extract fee data for fee-adjusted predictions
+        const managementFee = data.vault.state?.managementFee || 0;
+        const performanceFee = data.vault.state?.performanceFee || 0;
+        const pricePerShare = BigInt(data.vault.state?.pricePerShare || '0');
+        const highWaterMark = BigInt(data.vault.state?.highWaterMark || '0');
+        const performanceFeeActive = pricePerShare > highWaterMark;
+        // Only pass fee parameters if vault has meaningful fees
+        const hasFees = managementFee > 0 || performanceFee > 0;
+        // Perform yield prediction with optional fee parameters
+        const prediction = predictYield(historicalData, hasFees
+            ? {
+                managementFee,
+                performanceFee,
+                performanceFeeActive,
+            }
+            : undefined);
+        // Format prediction as markdown
+        const markdown = formatYieldPrediction(prediction, data.vault.name || 'Unknown Vault', input.timeRange);
+        return { markdown };
+    };
+}
+/**
+ * Create the executePredictYield function with DI container
+ *
+ * @param container - Service container with dependencies
+ * @returns Configured tool executor function
+ */
+export function createExecutePredictYield(container) {
+    return async (input) => {
+        // Calculate timestamp threshold for time range
+        const nowTimestamp = Math.floor(Date.now() / 1000);
+        const timeRangeSeconds = TIME_RANGES[input.timeRange];
+        const timestampThreshold = nowTimestamp - timeRangeSeconds;
+        // Determine response format (default to 'quick')
+        const responseFormat = input.responseFormat === 'detailed' ? 'detailed' : 'quick';
+        // Create dynamic query based on responseFormat
+        const query = PredictionQueries.createYieldPredictionQuery(responseFormat);
+        const executor = executeToolWithCache({
+            container,
+            cacheKey: (input) => `yield_prediction:${input.chainId}:${input.vaultAddress}:${input.timeRange}:${input.responseFormat || 'quick'}`,
+            cacheTTL: cacheTTL.yieldPrediction,
+            query,
+            variables: () => ({
+                vaultAddress: input.vaultAddress,
+                chainId: input.chainId,
+            }),
+            validateResult: (data) => ({
+                valid: !!data.vault,
+                message: data.vault
+                    ? undefined
+                    : `No vault found at address ${input.vaultAddress} on chain ${input.chainId}`,
+            }),
+            transformResult: createTransformYieldPredictionData(input, timestampThreshold),
+            toolName: 'predict_yield',
+        });
+        // Register cache tags for invalidation
+        const cacheKey = `yield_prediction:${input.chainId}:${input.vaultAddress}:${input.timeRange}:${input.responseFormat || 'quick'}`;
+        container.cacheInvalidator.register(cacheKey, [
+            CacheTag.VAULT,
+            CacheTag.APR,
+            CacheTag.ANALYTICS,
+        ]);
+        // Execute and get result
+        const result = await executor(input);
+        // Transform JSON output to markdown text format with legal disclaimer
+        if (!result.isError && result.content[0]?.type === 'text') {
+            try {
+                const output = JSON.parse(result.content[0].text);
+                result.content[0].text = output.markdown + getToolDisclaimer('predict_yield');
+            }
+            catch (error) {
+                console.error('Failed to parse yield prediction output:', error);
+            }
+        }
+        return result;
+    };
+}
+//# sourceMappingURL=predict-yield.js.map

package/dist/tools/predict-yield.js.map

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

package/dist/tools/query-graphql.d.ts

@@ -0,0 +1,35 @@
+/**
+ * query_graphql Tool
+ *
+ * Direct GraphQL query execution for power users and large datasets.
+ * No caching - designed for unpredictable, custom queries.
+ *
+ * Use cases:
+ * - Custom queries with specific field selection
+ * - Large dataset queries (20+ vaults)
+ * - One-time analysis queries
+ * - Advanced filtering and aggregation
+ *
+ * WHY NO CACHING?
+ * This tool is intentionally non-cached because:
+ * 1. Query content is unpredictable (user-controlled)
+ * 2. Results are typically one-time use
+ * 3. Large datasets would waste cache memory
+ * 4. Fresh data is required (no staleness tolerance)
+ */
+import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { QueryGraphQLInput } from '../utils/validators.js';
+import { ServiceContainer } from '../core/container.js';
+/**
+ * Create the executeQueryGraphQL function with DI container
+ *
+ * This factory function demonstrates the lightweight pattern for non-cached tools:
+ * 1. Dependency injection for testability
+ * 2. No caching overhead (inappropriate for unpredictable queries)
+ * 3. Simple, focused implementation
+ *
+ * @param container - Service container with dependencies
+ * @returns Configured tool executor function
+ */
+export declare function createExecuteQueryGraphQL(container: ServiceContainer): (input: QueryGraphQLInput) => Promise<CallToolResult>;
+//# sourceMappingURL=query-graphql.d.ts.map

package/dist/tools/query-graphql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-graphql.d.ts","sourceRoot":"","sources":["../../src/tools/query-graphql.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGxD;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,gBAAgB,GAC1B,CAAC,KAAK,EAAE,iBAAiB,KAAK,OAAO,CAAC,cAAc,CAAC,CAoBvD"}

package/dist/tools/query-graphql.js

@@ -0,0 +1,54 @@
+/**
+ * query_graphql Tool
+ *
+ * Direct GraphQL query execution for power users and large datasets.
+ * No caching - designed for unpredictable, custom queries.
+ *
+ * Use cases:
+ * - Custom queries with specific field selection
+ * - Large dataset queries (20+ vaults)
+ * - One-time analysis queries
+ * - Advanced filtering and aggregation
+ *
+ * WHY NO CACHING?
+ * This tool is intentionally non-cached because:
+ * 1. Query content is unpredictable (user-controlled)
+ * 2. Results are typically one-time use
+ * 3. Large datasets would waste cache memory
+ * 4. Fresh data is required (no staleness tolerance)
+ */
+import { getToolDisclaimer } from '../utils/disclaimers.js';
+import { handleToolError } from '../utils/tool-error-handler.js';
+/**
+ * Create the executeQueryGraphQL function with DI container
+ *
+ * This factory function demonstrates the lightweight pattern for non-cached tools:
+ * 1. Dependency injection for testability
+ * 2. No caching overhead (inappropriate for unpredictable queries)
+ * 3. Simple, focused implementation
+ *
+ * @param container - Service container with dependencies
+ * @returns Configured tool executor function
+ */
+export function createExecuteQueryGraphQL(container) {
+    return async (input) => {
+        try {
+            // Execute GraphQL query using injected client
+            const data = await container.graphqlClient.request(input.query, input.variables);
+            // Return successful response with pretty-printed JSON and legal disclaimer
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(data, null, 2) + getToolDisclaimer('query_graphql'),
+                    },
+                ],
+                isError: false,
+            };
+        }
+        catch (error) {
+            return handleToolError(error, 'query_graphql');
+        }
+    };
+}
+//# sourceMappingURL=query-graphql.js.map

package/dist/tools/query-graphql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-graphql.js","sourceRoot":"","sources":["../../src/tools/query-graphql.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG5D,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE;;;;;;;;;;GAUG;AACH,MAAM,UAAU,yBAAyB,CACvC,SAA2B;IAE3B,OAAO,KAAK,EAAE,KAAwB,EAA2B,EAAE;QACjE,IAAI,CAAC;YACH,8CAA8C;YAC9C,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;YAEjF,2EAA2E;YAC3E,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,iBAAiB,CAAC,eAAe,CAAC;qBACzE;iBACF;gBACD,OAAO,EAAE,KAAK;aACf,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,eAAe,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;QACjD,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/tools/registry.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Unified Tool Registry
+ *
+ * Single source of truth for all MCP tool definitions.
+ * Eliminates duplication between tools/index.ts and server.ts registration.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { ZodSchema } from 'zod';
+import { ServiceContainer } from '../core/container.js';
+/**
+ * Tool definition with type safety
+ * Now uses factory functions that accept ServiceContainer
+ */
+export interface ToolDefinition<TInput = unknown> {
+    name: string;
+    description: string;
+    schema: ZodSchema<TInput>;
+    executorFactory: (container: ServiceContainer) => (input: TInput) => Promise<CallToolResult>;
+}
+/**
+ * Complete tool registry
+ * Single source of truth for tool metadata and handlers
+ */
+export declare const TOOL_REGISTRY: ToolDefinition<any>[];
+/**
+ * Register all tools with the MCP server
+ * Converts registry entries to MCP tool registrations
+ *
+ * @param server - MCP server instance
+ * @param container - Service container with dependencies (GraphQL client, cache, config)
+ */
+export declare function registerTools(server: McpServer, container: ServiceContainer): void;
+/**
+ * Get tool names for listing
+ */
+export declare function getToolNames(): string[];
+/**
+ * Find tool by name
+ */
+export declare function findTool(name: string): ToolDefinition | undefined;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,SAAS,EAA0B,MAAM,KAAK,CAAC;AAkBxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAqBxD;;;GAGG;AACH,MAAM,WAAW,cAAc,CAAC,MAAM,GAAG,OAAO;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAC1B,eAAe,EAAE,CAAC,SAAS,EAAE,gBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;CAC9F;AAED;;;GAGG;AAEH,eAAO,MAAM,aAAa,EAAE,cAAc,CAAC,GAAG,CAAC,EA0K9C,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,gBAAgB,GAAG,IAAI,CA8BlF;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAEvC;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEjE"}

package/dist/tools/registry.js

@@ -0,0 +1,231 @@
+/**
+ * Unified Tool Registry
+ *
+ * Single source of truth for all MCP tool definitions.
+ * Eliminates duplication between tools/index.ts and server.ts registration.
+ */
+import { ZodObject } from 'zod';
+// Tool factory functions
+import { createExecuteQueryGraphQL } from './query-graphql.js';
+import { createExecuteGetVaultData } from './vault-data.js';
+import { createExecuteGetUserPortfolio } from './user-portfolio.js';
+import { createExecuteSearchVaults } from './search-vaults.js';
+import { createExecuteGetVaultPerformance } from './vault-performance.js';
+import { createExecuteGetTransactions } from './get-transactions.js';
+import { createExecuteCompareVaults } from './compare-vaults.js';
+import { createExecuteGetPriceHistory } from './get-price-history.js';
+import { createExecuteExportData } from './export-data.js';
+import { createExecuteAnalyzeRisk } from './analyze-risk.js';
+import { createExecutePredictYield } from './predict-yield.js';
+import { createExecuteOptimizePortfolio } from './optimize-portfolio.js';
+import { createExecuteSimulateVault, simulateVaultInputSchema } from './simulate-vault.js';
+// Input schemas
+import { queryGraphQLInputSchema, getVaultDataInputSchema, getUserPortfolioInputSchema, searchVaultsInputSchema, getVaultPerformanceInputSchema, getTransactionsInputSchema, compareVaultsInputSchema, priceHistoryInputSchema, exportDataInputSchema, analyzeRiskInputSchema, predictYieldInputSchema, optimizePortfolioInputSchema, } from '../utils/validators.js';
+// Tool utilities
+import { createToolHandler } from '../utils/tool-handler.js';
+/**
+ * Complete tool registry
+ * Single source of truth for tool metadata and handlers
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export const TOOL_REGISTRY = [
+    {
+        name: 'query_graphql',
+        description: 'Execute raw GraphQL queries against the Lagoon backend. ' +
+            'Use for custom queries with specific field selection, large datasets (20+ vaults), ' +
+            'or advanced filtering. No caching - results are always fresh. ' +
+            'Requires GraphQL query syntax knowledge.',
+        schema: queryGraphQLInputSchema,
+        executorFactory: createExecuteQueryGraphQL,
+    },
+    {
+        name: 'get_vault_data',
+        description: 'Fetch complete vault information with 15-minute caching. ' +
+            'Optimized for detailed analysis of 1-5 vaults. ' +
+            'Returns all vault fields including asset info, financial metrics, curator details, and metadata. ' +
+            'Best for: small vault sets, repeated queries, comprehensive analysis. ' +
+            'Performance: ~500 tokens per vault.',
+        schema: getVaultDataInputSchema,
+        executorFactory: createExecuteGetVaultData,
+    },
+    {
+        name: 'get_user_portfolio',
+        description: 'Fetch user portfolio with 5-minute caching. ' +
+            'Automatically queries all supported chains via the users API. ' +
+            'Returns sorted positions by USD value with complete vault data for each position. ' +
+            'Best for: multi-chain portfolio analysis, user position tracking, portfolio value aggregation. ' +
+            'Performance: ~300-800 tokens per user (varies with position count).',
+        schema: getUserPortfolioInputSchema,
+        executorFactory: createExecuteGetUserPortfolio,
+    },
+    {
+        name: 'search_vaults',
+        description: 'Search and filter vaults with advanced criteria and 10-minute caching. ' +
+            'Supports 20+ filter options including asset, chain, TVL, curator, visibility. ' +
+            'Returns paginated results (default 100, max 1000) with sort options. ' +
+            'Best for: vault discovery, filtering by criteria, TVL-sorted lists, multi-vault analysis. ' +
+            'Performance: ~300-500 tokens per page. ' +
+            'Cache key based on filter hash for efficient repeated searches.',
+        schema: searchVaultsInputSchema,
+        executorFactory: createExecuteSearchVaults,
+    },
+    {
+        name: 'get_vault_performance',
+        description: 'Historical metrics and trend analysis for vaults with 30-minute caching. ' +
+            'Aggregates transaction data (TotalAssetsUpdated, PeriodSummary) for time-series analysis. ' +
+            'Supports 4 time ranges: 7d, 30d, 90d, 1y. ' +
+            'Returns metrics array with timestamps and TVL, plus summary statistics (start/end value, % change, volume). ' +
+            'Best for: performance tracking, trend analysis, TVL history, inflection point identification. ' +
+            'Performance: ~400-600 tokens per vault per time range. ' +
+            'Fetches up to 1000 transactions per query.',
+        schema: getVaultPerformanceInputSchema,
+        executorFactory: createExecuteGetVaultPerformance,
+    },
+    {
+        name: 'get_transactions',
+        description: 'Query vault transaction history with flexible filtering, pagination, and ordering. ' +
+            'Supports all transaction types: deposits (SettleDeposit, DepositRequest, DepositSync), ' +
+            'redemptions (SettleRedeem, RedeemRequest, DepositRequestCanceled), ' +
+            'state changes (TotalAssetsUpdated, NewTotalAssetsUpdated, PeriodSummary), ' +
+            'and configuration updates (RatesUpdated, StateUpdated). ' +
+            'Returns detailed transaction data with timestamps, block numbers, hashes, and type-specific fields. ' +
+            'Best for: analyzing historical vault activity, tracking user deposits/withdrawals, monitoring state changes, generating transaction reports. ' +
+            'Performance: ~400-600 tokens per query (varies with transaction count). ' +
+            'Features 15-minute caching and pagination support (default 100, max 1000).',
+        schema: getTransactionsInputSchema,
+        executorFactory: createExecuteGetTransactions,
+    },
+    {
+        name: 'compare_vaults',
+        description: 'Compare multiple vaults side-by-side with normalized metrics and rankings (2-10 vaults). ' +
+            'Provides comprehensive comparison including TVL, APR, overall performance scores, and percentile rankings. ' +
+            'Calculates deltas from averages and identifies best/worst performers automatically. ' +
+            'Returns formatted comparison table with summary statistics and individual vault rankings. ' +
+            'Best for: evaluating investment opportunities, identifying top performers, risk-adjusted return analysis, portfolio construction. ' +
+            'Performance: ~300 tokens per vault. ' +
+            'Features 15-minute caching based on vault address combinations.',
+        schema: compareVaultsInputSchema,
+        executorFactory: createExecuteCompareVaults,
+    },
+    {
+        name: 'get_price_history',
+        description: 'Fetch historical price data for vault shares with OHLCV (Open, High, Low, Close, Volume) time-series analysis. ' +
+            'Aggregates price data by day for cleaner visualization and provides comprehensive price statistics. ' +
+            'Calculates volatility (standard deviation), percent changes, and identifies price trends over time. ' +
+            'Returns formatted price history table with daily OHLCV data and statistical summary. ' +
+            'Best for: price trend analysis, volatility assessment, historical price point identification, entry/exit decision support. ' +
+            'Performance: ~300-500 tokens per vault per time range. ' +
+            'Features 30-minute caching for historical data. ' +
+            'Time ranges: 7d (7 days), 30d (30 days), 90d (90 days), 1y (1 year), all (complete history).',
+        schema: priceHistoryInputSchema,
+        executorFactory: createExecuteGetPriceHistory,
+    },
+    {
+        name: 'export_data',
+        description: 'Export vault data, transactions, price history, or performance metrics in CSV or JSON format for external analysis. ' +
+            'Supports multiple data types: vaults (vault info with TVL/APR), transactions (deposit/redeem history), ' +
+            'price_history (OHLCV time-series), performance (TVL metrics over time). ' +
+            'Formats: CSV (RFC 4180 compliant with proper escaping) or JSON (structured objects). ' +
+            'Returns formatted data ready for import into spreadsheets, databases, or analytics tools. ' +
+            'Best for: spreadsheet analysis, reporting, custom analytics, data integration with external tools, accounting records. ' +
+            'Performance: ~200-400 tokens per export depending on data size. ' +
+            'No caching (exports generated on-demand with latest data). ' +
+            'Up to 1000 records per export.',
+        schema: exportDataInputSchema,
+        executorFactory: createExecuteExportData,
+    },
+    {
+        name: 'analyze_risk',
+        description: 'Analyze vault risk with multi-factor scoring across TVL, concentration, volatility, age, and curator reputation. ' +
+            'Provides comprehensive risk assessment with individual factor breakdowns and overall risk level (Low/Medium/High/Critical). ' +
+            'Evaluates: TVL risk (liquidity and market validation), concentration risk (protocol-wide exposure), ' +
+            'volatility risk (price stability), age risk (operational track record), curator risk (reputation and experience). ' +
+            'Returns detailed risk analysis with scores (0-1 scale), risk levels with emoji indicators, and factor explanations. ' +
+            'Best for: investment decision-making, due diligence, portfolio risk monitoring, comparative vault analysis. ' +
+            'Performance: ~400-600 tokens per analysis. ' +
+            'Features 15-minute caching for risk stability.',
+        schema: analyzeRiskInputSchema,
+        executorFactory: createExecuteAnalyzeRisk,
+    },
+    {
+        name: 'predict_yield',
+        description: 'Predict vault yield with ML-based forecasting using trend analysis and historical performance. ' +
+            'Analyzes APR trends using linear regression, exponential moving averages, and volatility analysis. ' +
+            'Provides projected returns for multiple timeframes (7d, 30d, 90d, 1y) with confidence intervals. ' +
+            'Returns current APR, predicted APR, trend direction, confidence score, and detailed insights. ' +
+            'Best for: investment planning, yield farming optimization, return projections, performance trend analysis. ' +
+            'Performance: ~400-600 tokens per prediction. ' +
+            'Features 60-minute caching for prediction stability.',
+        schema: predictYieldInputSchema,
+        executorFactory: createExecutePredictYield,
+    },
+    {
+        name: 'optimize_portfolio',
+        description: 'Optimize portfolio allocation with rebalancing recommendations using multiple strategies. ' +
+            'Analyzes current holdings and provides optimal allocation based on selected strategy: ' +
+            'equal_weight (maximum diversification), risk_parity (balanced risk contribution), ' +
+            'max_sharpe (risk-adjusted returns), min_variance (minimized volatility). ' +
+            'Returns target allocations, rebalancing actions, portfolio metrics (expected return, risk, Sharpe ratio, diversification). ' +
+            'Calculates exact buy/sell amounts and identifies positions requiring adjustment. ' +
+            'Best for: portfolio rebalancing, risk-adjusted allocation, diversification improvement, performance optimization. ' +
+            'Performance: ~600-800 tokens per optimization. ' +
+            'Features 30-minute caching for optimization stability.',
+        schema: optimizePortfolioInputSchema,
+        executorFactory: createExecuteOptimizePortfolio,
+    },
+    {
+        name: 'simulate_vault',
+        description: 'Simulate vault behavior with different parameters for scenario analysis and planning. ' +
+            'Tests various scenarios including deposit/redemption amounts, fee structures, and yield rates. ' +
+            'Provides projected outcomes for investment strategies and risk scenarios. ' +
+            'Returns detailed simulation results with before/after comparisons and key metrics. ' +
+            'Best for: strategy testing, investment planning, fee impact analysis, "what-if" scenarios. ' +
+            'Performance: ~300-500 tokens per simulation. ' +
+            'No caching (simulations are scenario-specific).',
+        schema: simulateVaultInputSchema,
+        executorFactory: createExecuteSimulateVault,
+    },
+];
+/**
+ * Register all tools with the MCP server
+ * Converts registry entries to MCP tool registrations
+ *
+ * @param server - MCP server instance
+ * @param container - Service container with dependencies (GraphQL client, cache, config)
+ */
+export function registerTools(server, container) {
+    for (const tool of TOOL_REGISTRY) {
+        // Create executor from factory with injected container
+        const executor = tool.executorFactory(container);
+        // Create wrapped handler with validation
+        const handler = createToolHandler(executor, tool.schema);
+        // Extract raw shape from Zod schema for MCP registration
+        // The MCP SDK expects a ZodRawShape, not a complete schema or JSON Schema
+        // The SDK will wrap this with z.object() internally
+        // We use type assertion here because ZodObject's shape property is typed as any in the library
+        // but we know it's safe because we're checking the instance type
+        const inputShape = tool.schema instanceof ZodObject
+            ? tool.schema.shape
+            : (() => {
+                throw new Error(`Tool ${tool.name} schema must be a ZodObject`);
+            })();
+        // Register with server
+        server.registerTool(tool.name, {
+            description: tool.description,
+            inputSchema: inputShape,
+        }, handler);
+    }
+}
+/**
+ * Get tool names for listing
+ */
+export function getToolNames() {
+    return TOOL_REGISTRY.map((tool) => tool.name);
+}
+/**
+ * Find tool by name
+ */
+export function findTool(name) {
+    return TOOL_REGISTRY.find((tool) => tool.name === name);
+}
+//# sourceMappingURL=registry.js.map

package/dist/tools/registry.js.map

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