@gala-chain/launchpad-mcp-server 1.23.0 → 1.24.0

package/src/prompts/pools.ts

@@ -6,7 +6,9 @@
 
 import type { MCPPrompt } from '../types/mcp.js';
 import { MCP_TOOLS } from '../constants/mcpToolNames.js';
-import { validateTokenName, validatePaginationLimit } from '../utils/validation.js';
+import { validateTokenName, validateOptionalLimit } from '../utils/validation.js';
+import { createPromptResponse } from './utils/handlerHelpers.js';
+import { createSimpleOperationText } from './utils/textTemplates.js';
 
 /**
  * Fetch Pools - Paginated pool fetching with filters
@@ -32,26 +34,21 @@ export const fetchPoolsPrompt: MCPPrompt = {
     },
   ],
   handler: (args) => {
-    if (args.limit) {
-      validatePaginationLimit(args.limit, 100);
-    }
-
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Fetch token pools from Gala Launchpad.
-
-Use ${MCP_TOOLS.FETCH_POOLS} with parameters:
-- type: ${args.type || 'recent'}
-- page: ${args.page || 1}
-- limit: ${args.limit || 20}
-
-Display the results showing token names, symbols, and key metrics.`,
+    validateOptionalLimit(args.limit, 100);
+
+    return createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Fetch token pools from Gala Launchpad.',
+        parameters: {
+          type: `Type: ${args.type || 'recent'}`,
+          page: `Page: ${args.page || 1}`,
+          limit: `Limit: ${args.limit || 20}`,
         },
-      },
-    ];
+        toolName: MCP_TOOLS.FETCH_POOLS,
+        actionDescription: 'retrieve pools with pagination',
+        displayFormat: 'Display results showing token names, symbols, and key metrics.',
+      })
+    );
   },
 };
 
@@ -71,26 +68,17 @@ export const fetchPoolDetailsForCalculationPrompt: MCPPrompt = {
   handler: (args) => {
     validateTokenName(args.tokenName);
 
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Fetch optimized pool details for bonding curve calculations.
-
-Token: ${args.tokenName}
-
-Use ${MCP_TOOLS.FETCH_POOL_DETAILS_FOR_CALCULATION} to get:
-- currentSupply (computed with full precision)
-- remainingTokens
-- maxSupply
-- reverseBondingCurveMaxFeeFactor
-- reverseBondingCurveMinFeeFactor
-
-This data is optimized for use with local calculation tools.`,
+    return createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Fetch optimized pool details for bonding curve calculations.',
+        parameters: {
+          token_name: `Token: ${args.tokenName}`,
         },
-      },
-    ];
+        toolName: MCP_TOOLS.FETCH_POOL_DETAILS_FOR_CALCULATION,
+        actionDescription: 'get currentSupply (computed with full precision), remainingTokens, maxSupply, reverseBondingCurveMaxFeeFactor, and reverseBondingCurveMinFeeFactor',
+        displayFormat: 'This data is optimized for use with local calculation tools.',
+      })
+    );
   },
 };
 
@@ -108,25 +96,17 @@ export const fetchTokenDetailsPrompt: MCPPrompt = {
     },
   ],
   handler: (args) => {
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Fetch complete token metadata from the DEX API.
-
-Token ID: ${args.tokenId}
-
-Use ${MCP_TOOLS.FETCH_TOKEN_DETAILS} to retrieve:
-- Symbol, decimals, name, image
-- Description and verification status
-- Network information (chainId, contractAddress)
-- Trading enabled status
-
-Display the complete token information.`,
+    return createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Fetch complete token metadata from the DEX API.',
+        parameters: {
+          token_id: `Token ID: ${args.tokenId}`,
         },
-      },
-    ];
+        toolName: MCP_TOOLS.FETCH_TOKEN_DETAILS,
+        actionDescription: 'retrieve symbol, decimals, name, image, description, verification status, network information (chainId, contractAddress), and trading enabled status',
+        displayFormat: 'Display the complete token information.',
+      })
+    );
   },
 };
 
@@ -146,25 +126,17 @@ export const fetchTokenDistributionPrompt: MCPPrompt = {
   handler: (args) => {
     validateTokenName(args.tokenName);
 
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Analyze token holder distribution.
-
-Token: ${args.tokenName}
-
-Use ${MCP_TOOLS.FETCH_TOKEN_DISTRIBUTION} to get:
-- Complete holder list with addresses, balances, and ownership percentages
-- Total supply (computed from holder balances)
-- Total holder count
-- Last updated timestamp
-
-Identify top holders and concentration risk.`,
+    return createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Analyze token holder distribution.',
+        parameters: {
+          token_name: `Token: ${args.tokenName}`,
         },
-      },
-    ];
+        toolName: MCP_TOOLS.FETCH_TOKEN_DISTRIBUTION,
+        actionDescription: 'get complete holder list with addresses, balances, ownership percentages, total supply, total holder count, and last updated timestamp',
+        displayFormat: 'Identify top holders and concentration risk.',
+      })
+    );
   },
 };
 
@@ -184,24 +156,17 @@ export const fetchTokenBadgesPrompt: MCPPrompt = {
   handler: (args) => {
     validateTokenName(args.tokenName);
 
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Fetch achievement badges for token.
-
-Token: ${args.tokenName}
-
-Use ${MCP_TOOLS.FETCH_TOKEN_BADGES} to retrieve badges for:
-- Trading volume milestones
-- Community engagement
-- Other achievements
-
-Display all earned badges.`,
+    return createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Fetch achievement badges for token.',
+        parameters: {
+          token_name: `Token: ${args.tokenName}`,
         },
-      },
-    ];
+        toolName: MCP_TOOLS.FETCH_TOKEN_BADGES,
+        actionDescription: 'retrieve badges for trading volume milestones, community engagement, and other achievements',
+        displayFormat: 'Display all earned badges.',
+      })
+    );
   },
 };
 
@@ -236,22 +201,20 @@ export const fetchVolumeDataPrompt: MCPPrompt = {
   handler: (args) => {
     validateTokenName(args.tokenName);
 
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Fetch OHLCV candlestick data for charting.
-
-Token: ${args.tokenName}
-${args.from ? `From: ${args.from}` : ''}
-${args.to ? `To: ${args.to}` : ''}
-Resolution: ${args.resolution || '1h'}
-
-Use ${MCP_TOOLS.FETCH_VOLUME_DATA} to get candlestick data suitable for price charts.`,
+    return createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Fetch OHLCV candlestick data for charting.',
+        parameters: {
+          token_name: `Token: ${args.tokenName}`,
+          ...(args.from && { from: `From: ${args.from}` }),
+          ...(args.to && { to: `To: ${args.to}` }),
+          resolution: `Resolution: ${args.resolution || '1h'}`,
         },
-      },
-    ];
+        toolName: MCP_TOOLS.FETCH_VOLUME_DATA,
+        actionDescription: 'retrieve candlestick data',
+        displayFormat: 'Display data suitable for price charts.',
+      })
+    );
   },
 };
 
@@ -262,19 +225,14 @@ export const fetchGalaSpotPricePrompt: MCPPrompt = {
   name: 'galachain-launchpad:fetch-gala-spot-price',
   description: 'Fetch current GALA USD spot price',
   handler: () => {
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Fetch the current GALA USD spot price.
-
-Use ${MCP_TOOLS.FETCH_GALA_SPOT_PRICE} to get the latest GALA price in USD.
-
-Display the price in a clear format.`,
-        },
-      },
-    ];
+    return createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Fetch the current GALA USD spot price.',
+        toolName: MCP_TOOLS.FETCH_GALA_SPOT_PRICE,
+        actionDescription: 'get the latest GALA price in USD',
+        displayFormat: 'Display the price in a clear format.',
+      })
+    );
   },
 };
 
@@ -294,24 +252,17 @@ export const fetchTokenSpotPricePrompt: MCPPrompt = {
   handler: (args) => {
     validateTokenName(args.tokenName);
 
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Fetch current USD spot price for token.
-
-Token: ${args.tokenName}
-
-Use ${MCP_TOOLS.FETCH_TOKEN_SPOT_PRICE} to get:
-- Current USD price with smart routing (launchpad or DEX)
-- Real-time pricing data
-- Unified interface for all token types
-
-Display the current price clearly.`,
+    return createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Fetch current USD spot price for token.',
+        parameters: {
+          token_name: `Token: ${args.tokenName}`,
         },
-      },
-    ];
+        toolName: MCP_TOOLS.FETCH_TOKEN_SPOT_PRICE,
+        actionDescription: 'get current USD price with smart routing (launchpad or DEX), real-time pricing data, and unified interface for all token types',
+        displayFormat: 'Display the current price clearly.',
+      })
+    );
   },
 };
 
@@ -349,29 +300,23 @@ export const fetchPriceHistoryPrompt: MCPPrompt = {
     },
   ],
   handler: (args) => {
-    if (args.limit) {
-      validatePaginationLimit(args.limit, 50);
-    }
-
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Fetch historical price snapshots for token.
-
-Token: ${args.tokenId}
-${args.from ? `From: ${args.from}` : ''}
-${args.to ? `To: ${args.to}` : ''}
-Page: ${args.page || 1}
-Limit: ${args.limit || 10}
-
-Use ${MCP_TOOLS.FETCH_PRICE_HISTORY} to retrieve historical price data from the DEX Backend API.
-
-Display price snapshots with timestamps.`,
+    validateOptionalLimit(args.limit, 50);
+
+    return createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Fetch historical price snapshots for token.',
+        parameters: {
+          token_id: `Token: ${args.tokenId}`,
+          ...(args.from && { from: `From: ${args.from}` }),
+          ...(args.to && { to: `To: ${args.to}` }),
+          page: `Page: ${args.page || 1}`,
+          limit: `Limit: ${args.limit || 10}`,
         },
-      },
-    ];
+        toolName: MCP_TOOLS.FETCH_PRICE_HISTORY,
+        actionDescription: 'retrieve historical price data from DEX Backend API',
+        displayFormat: 'Display price snapshots with timestamps.',
+      })
+    );
   },
 };
 
@@ -399,23 +344,19 @@ export const fetchAllPriceHistoryPrompt: MCPPrompt = {
     },
   ],
   handler: (args) => {
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Fetch ALL historical price snapshots for token (automatic pagination).
-
-Token: ${args.tokenId}
-${args.from ? `From: ${args.from}` : ''}
-${args.to ? `To: ${args.to}` : ''}
-
-Use ${MCP_TOOLS.FETCH_ALL_PRICE_HISTORY} to retrieve complete historical data.
-
-This automatically handles pagination and returns all available snapshots.`,
+    return createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Fetch ALL historical price snapshots for token (automatic pagination).',
+        parameters: {
+          token_id: `Token: ${args.tokenId}`,
+          from: args.from ? `From: ${args.from}` : undefined,
+          to: args.to ? `To: ${args.to}` : undefined,
         },
-      },
-    ];
+        toolName: MCP_TOOLS.FETCH_ALL_PRICE_HISTORY,
+        actionDescription: 'retrieve complete historical data',
+        displayFormat: 'This automatically handles pagination and returns all available snapshots.',
+      })
+    );
   },
 };
 
@@ -435,21 +376,17 @@ export const checkTokenNamePrompt: MCPPrompt = {
   handler: (args) => {
     validateTokenName(args.tokenName);
 
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Check if token name is available.
-
-Token Name: ${args.tokenName}
-
-Use ${MCP_TOOLS.CHECK_TOKEN_NAME} to verify availability.
-
-Display whether the name is available or already taken.`,
+    return createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Check if token name is available.',
+        parameters: {
+          token_name: `Token Name: ${args.tokenName}`,
         },
-      },
-    ];
+        toolName: MCP_TOOLS.CHECK_TOKEN_NAME,
+        actionDescription: 'verify availability',
+        displayFormat: 'Display whether the name is available or already taken.',
+      })
+    );
   },
 };
 
@@ -467,21 +404,17 @@ export const checkTokenSymbolPrompt: MCPPrompt = {
     },
   ],
   handler: (args) => {
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Check if token symbol is available.
-
-Token Symbol: ${args.symbol}
-
-Use ${MCP_TOOLS.CHECK_TOKEN_SYMBOL} to verify availability.
-
-Display whether the symbol is available or already taken.`,
+    return createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Check if token symbol is available.',
+        parameters: {
+          token_symbol: `Token Symbol: ${args.symbol}`,
         },
-      },
-    ];
+        toolName: MCP_TOOLS.CHECK_TOKEN_SYMBOL,
+        actionDescription: 'verify availability',
+        displayFormat: 'Display whether the symbol is available or already taken.',
+      })
+    );
   },
 };
 
@@ -501,21 +434,17 @@ export const resolveVaultAddressPrompt: MCPPrompt = {
   handler: (args) => {
     validateTokenName(args.tokenName);
 
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Resolve GalaChain vault address for token.
-
-Token: ${args.tokenName}
-
-Use ${MCP_TOOLS.RESOLVE_VAULT_ADDRESS} to get the vault address.
-
-This is useful for debugging and direct GalaChain operations.`,
+    return createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Resolve GalaChain vault address for token.',
+        parameters: {
+          token_name: `Token: ${args.tokenName}`,
         },
-      },
-    ];
+        toolName: MCP_TOOLS.RESOLVE_VAULT_ADDRESS,
+        actionDescription: 'get the vault address',
+        displayFormat: 'This is useful for debugging and direct GalaChain operations.',
+      })
+    );
   },
 };
 
@@ -535,21 +464,17 @@ export const resolveTokenClassKeyPrompt: MCPPrompt = {
   handler: (args) => {
     validateTokenName(args.tokenName);
 
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Resolve GalaChain TokenClassKey for launchpad token.
-
-Token: ${args.tokenName}
-
-Use ${MCP_TOOLS.RESOLVE_TOKEN_CLASS_KEY} to get the TokenClassKey.
-
-This is useful for direct GalaChain operations.`,
+    return createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Resolve GalaChain TokenClassKey for launchpad token.',
+        parameters: {
+          token_name: `Token: ${args.tokenName}`,
         },
-      },
-    ];
+        toolName: MCP_TOOLS.RESOLVE_TOKEN_CLASS_KEY,
+        actionDescription: 'get the TokenClassKey',
+        displayFormat: 'This is useful for direct GalaChain operations.',
+      })
+    );
   },
 };
 

package/src/prompts/portfolio.ts

@@ -7,7 +7,8 @@
 import type { MCPPrompt } from '../types/mcp.js';
 import { MCP_TOOLS } from '../constants/mcpToolNames.js';
 import { createPortfolioWorkflow } from './utils/workflowTemplates.js';
-import { validateTokenName, validatePaginationLimit } from '../utils/validation.js';
+import { validateTokenName, validateOptionalLimit } from '../utils/validation.js';
+import { createPromptResponse } from './utils/handlerHelpers.js';
 
 /**
  * Portfolio - Complete portfolio analysis
@@ -46,21 +47,14 @@ export const tokensHeldPrompt: MCPPrompt = {
   ],
   handler: (args) => {
     // Validate inputs
-    if (args.limit) {
-      validatePaginationLimit(args.limit, 100);
-    }
+    validateOptionalLimit(args.limit, 100);
 
     const limit = args.limit || '20';
     const searchFilter = args.search
       ? `- search: "${args.search}" (fuzzy match filter)`
       : '- No search filter (show all tokens)';
 
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Show me all Launchpad tokens I'm currently holding:
+    return createPromptResponse(`Show me all Launchpad tokens I'm currently holding:
 
 Use ${MCP_TOOLS.FETCH_TOKENS_HELD} with:
 ${searchFilter}
@@ -73,10 +67,7 @@ For each token, display:
 
 Sort by balance (highest to lowest).
 
-If I have more tokens than the limit, show pagination info and offer to fetch more.`,
-        },
-      },
-    ];
+If I have more tokens than the limit, show pagination info and offer to fetch more.`);
   },
 };
 
@@ -100,21 +91,14 @@ export const tokensCreatedPrompt: MCPPrompt = {
   ],
   handler: (args) => {
     // Validate inputs
-    if (args.limit) {
-      validatePaginationLimit(args.limit, 100);
-    }
+    validateOptionalLimit(args.limit, 100);
 
     const limit = args.limit || '20';
     const searchFilter = args.search
       ? `- search: "${args.search}" (fuzzy match filter)`
       : '- No search filter (show all tokens)';
 
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Show me all Launchpad tokens I've created:
+    return createPromptResponse(`Show me all Launchpad tokens I've created:
 
 Use ${MCP_TOOLS.FETCH_TOKENS_CREATED} with:
 ${searchFilter}
@@ -133,10 +117,7 @@ For each token, display:
 Provide a summary:
 - Total tokens created
 - How many are graduated
-- How many are still in bonding curve phase`,
-        },
-      },
-    ];
+- How many are still in bonding curve phase`);
   },
 };
 
@@ -159,12 +140,7 @@ export const balancePrompt: MCPPrompt = {
       validateTokenName(args.tokenName);
     }
 
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: args.tokenName
+    return createPromptResponse(args.tokenName
             ? `Check my balances:
 
 1. GALA balance using ${MCP_TOOLS.FETCH_GALA_BALANCE}
@@ -186,10 +162,7 @@ Display:
 - GALA: [amount]
 - USD value: $[calculated value]
 
-Tip: Add tokenName argument to check a specific token balance.`,
-        },
-      },
-    ];
+Tip: Add tokenName argument to check a specific token balance.`);
   },
 };
 
@@ -199,12 +172,8 @@ Tip: Add tokenName argument to check a specific token balance.`,
 export const profilePrompt: MCPPrompt = {
   name: 'galachain-launchpad:profile',
   description: 'Show user profile information and activity summary',
-  handler: () => [
-    {
-      role: 'user',
-      content: {
-        type: 'text',
-        text: `Show my Gala Launchpad profile:
+  handler: () =>
+    createPromptResponse(`Show my Gala Launchpad profile:
 
 1. Get profile info using ${MCP_TOOLS.FETCH_PROFILE}
    - Full name
@@ -224,10 +193,7 @@ Display:
 - Profile details
 - Activity metrics
 - Wallet addresses
-- Current balance`,
-      },
-    },
-  ],
+- Current balance`),
 };
 
 /**