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

package/src/prompts/social.ts

@@ -7,6 +7,8 @@
 import type { MCPPrompt } from '../types/mcp.js';
 import { MCP_TOOLS } from '../constants/mcpToolNames.js';
 import { validateTokenName } from '../utils/validation.js';
+import { createPromptResponse } from './utils/handlerHelpers.js';
+import { createSimpleOperationText } from './utils/textTemplates.js';
 
 /**
  * Post Comment - Post comment on token
@@ -29,22 +31,18 @@ export const postCommentPrompt: MCPPrompt = {
   handler: (args) => {
     validateTokenName(args.tokenName);
 
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Post comment on token pool.
-
-Token: ${args.tokenName}
-Message: ${args.message}
-
-Use ${MCP_TOOLS.POST_COMMENT} to post the comment.
-
-Display confirmation of successful comment posting.`,
+    return createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Post comment on token pool.',
+        parameters: {
+          token: `Token: ${args.tokenName}`,
+          message: `Message: ${args.message}`,
         },
-      },
-    ];
+        toolName: MCP_TOOLS.POST_COMMENT,
+        actionDescription: 'post the comment',
+        displayFormat: 'Display confirmation of successful comment posting.',
+      })
+    );
   },
 };
 
@@ -74,23 +72,19 @@ export const fetchCommentsPrompt: MCPPrompt = {
   handler: (args) => {
     validateTokenName(args.tokenName);
 
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Fetch comments for token pool.
-
-Token: ${args.tokenName}
-Page: ${args.page || 1}
-Limit: ${args.limit || 20}
-
-Use ${MCP_TOOLS.FETCH_COMMENTS} to retrieve comments.
-
-Display the comments with author information and timestamps.`,
+    return createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Fetch comments for token pool.',
+        parameters: {
+          token: `Token: ${args.tokenName}`,
+          page: `Page: ${args.page || 1}`,
+          limit: `Limit: ${args.limit || 20}`,
         },
-      },
-    ];
+        toolName: MCP_TOOLS.FETCH_COMMENTS,
+        actionDescription: 'retrieve comments',
+        displayFormat: 'Display the comments with author information and timestamps.',
+      })
+    );
   },
 };
 

package/src/prompts/trading-calculations.ts

@@ -6,7 +6,9 @@
 
 import type { MCPPrompt } from '../types/mcp.js';
 import { MCP_TOOLS } from '../constants/mcpToolNames.js';
-import { validateTokenName, validateNumericAmount } from '../utils/validation.js';
+import { validateTokenName, validateNumericAmount, validateOptional } from '../utils/validation.js';
+import { createPromptResponse } from './utils/handlerHelpers.js';
+import { createSimpleOperationText } from './utils/textTemplates.js';
 
 /**
  * Calculate Buy Amount - Buy cost calculation
@@ -35,12 +37,7 @@ export const calculateBuyAmountPrompt: MCPPrompt = {
     validateTokenName(args.tokenName, 'tokenName');
     validateNumericAmount(args.amount, 'amount');
 
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Calculate buy amount and fee breakdown.
+    return createPromptResponse(`Calculate buy amount and fee breakdown.
 
 Token: ${args.tokenName}
 Amount: ${args.amount}
@@ -52,10 +49,7 @@ Use ${MCP_TOOLS.CALCULATE_BUY_AMOUNT} to get:
 - Gas fee
 - Reverse bonding curve fee
 
-Display the complete cost breakdown.`,
-        },
-      },
-    ];
+Display the complete cost breakdown.`);
   },
 };
 
@@ -86,12 +80,7 @@ export const calculateSellAmountPrompt: MCPPrompt = {
     validateTokenName(args.tokenName, 'tokenName');
     validateNumericAmount(args.amount, 'amount');
 
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Calculate sell amount and fee breakdown.
+    return createPromptResponse(`Calculate sell amount and fee breakdown.
 
 Token: ${args.tokenName}
 Amount: ${args.amount}
@@ -103,10 +92,7 @@ Use ${MCP_TOOLS.CALCULATE_SELL_AMOUNT} to get:
 - Gas fee
 - Reverse bonding curve fee
 
-Display the complete proceeds breakdown.`,
-        },
-      },
-    ];
+Display the complete proceeds breakdown.`);
   },
 };
 
@@ -139,16 +125,9 @@ export const fetchTradesPrompt: MCPPrompt = {
     },
   ],
   handler: (args) => {
-    if (args.tokenName) {
-      validateTokenName(args.tokenName, 'tokenName');
-    }
+    validateOptional(args.tokenName, (val) => validateTokenName(val, 'tokenName'));
 
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Fetch trading history.
+    return createPromptResponse(`Fetch trading history.
 
 ${args.tokenName ? `Token: ${args.tokenName}` : ''}
 ${args.tradeType ? `Trade Type: ${args.tradeType}` : ''}
@@ -157,10 +136,7 @@ Limit: ${args.limit || 20}
 
 Use ${MCP_TOOLS.FETCH_TRADES} to retrieve your trades.
 
-Display trade details including amounts, prices, and timestamps.`,
-        },
-      },
-    ];
+Display trade details including amounts, prices, and timestamps.`);
   },
 };
 
@@ -180,12 +156,7 @@ export const calculateInitialBuyPrompt: MCPPrompt = {
   handler: (args) => {
     validateNumericAmount(args.amount, 'amount');
 
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Calculate pre-buy amounts for token creation.
+    return createPromptResponse(`Calculate pre-buy amounts for token creation.
 
 GALA Amount: ${args.amount}
 
@@ -193,10 +164,7 @@ Use ${MCP_TOOLS.CALCULATE_INITIAL_BUY} to calculate:
 - Token quantity from initial buy
 - Applied fees and costs
 
-Display the calculated results.`,
-        },
-      },
-    ];
+Display the calculated results.`);
   },
 };
 
@@ -214,12 +182,7 @@ export const getBundlerTransactionResultPrompt: MCPPrompt = {
     },
   ],
   handler: (args) => {
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Get bundler transaction result.
+    return createPromptResponse(`Get bundler transaction result.
 
 Transaction ID: ${args.transactionId}
 
@@ -228,10 +191,7 @@ Use ${MCP_TOOLS.GET_BUNDLER_TRANSACTION_RESULT} to check:
 - Transaction method
 - Metadata
 
-Display the transaction status clearly.`,
-        },
-      },
-    ];
+Display the transaction status clearly.`);
   },
 };
 
@@ -251,24 +211,17 @@ export const calculateBuyAmountForGraduationPrompt: MCPPrompt = {
   handler: (args) => {
     validateTokenName(args.tokenName, 'tokenName');
 
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Calculate graduation cost for token pool.
-
-Token: ${args.tokenName}
-
-Use ${MCP_TOOLS.CALCULATE_BUY_AMOUNT_FOR_GRADUATION} to determine:
-- GALA cost to buy all remaining tokens
-- Transaction and gas fees
-- Complete cost breakdown
-
-Display how much GALA is needed to graduate this token.`,
+    return createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Calculate graduation cost for token pool.',
+        parameters: {
+          token_name: `Token: ${args.tokenName}`,
         },
-      },
-    ];
+        toolName: MCP_TOOLS.CALCULATE_BUY_AMOUNT_FOR_GRADUATION,
+        actionDescription: 'determine GALA cost to buy all remaining tokens, transaction fees, and complete cost breakdown',
+        displayFormat: 'Display how much GALA is needed to graduate this token.',
+      })
+    );
   },
 };
 
@@ -294,12 +247,7 @@ export const calculateBuyAmountLocalPrompt: MCPPrompt = {
     validateTokenName(args.tokenName, 'tokenName');
     validateNumericAmount(args.amount, 'amount');
 
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Calculate buy amount using LOCAL bonding curve formula.
+    return createPromptResponse(`Calculate buy amount using LOCAL bonding curve formula.
 
 Token: ${args.tokenName}
 Amount: ${args.amount} GALA
@@ -309,10 +257,7 @@ Use ${MCP_TOOLS.CALCULATE_BUY_AMOUNT_LOCAL} for instant calculation:
 - No network call required
 - Results within <0.01% of external calculation
 
-Perfect for price discovery and UI updates.`,
-        },
-      },
-    ];
+Perfect for price discovery and UI updates.`);
   },
 };
 
@@ -338,12 +283,7 @@ export const calculateBuyAmountExternalPrompt: MCPPrompt = {
     validateTokenName(args.tokenName, 'tokenName');
     validateNumericAmount(args.amount, 'amount');
 
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Calculate buy amount using EXTERNAL GalaChain network call.
+    return createPromptResponse(`Calculate buy amount using EXTERNAL GalaChain network call.
 
 Token: ${args.tokenName}
 Amount: ${args.amount} GALA
@@ -353,10 +293,7 @@ Use ${MCP_TOOLS.CALCULATE_BUY_AMOUNT_EXTERNAL} for real-time calculation:
 - Most accurate pricing available
 - Includes reverse bonding curve fees
 
-Use this for precise trading decisions.`,
-        },
-      },
-    ];
+Use this for precise trading decisions.`);
   },
 };
 
@@ -382,12 +319,7 @@ export const calculateSellAmountLocalPrompt: MCPPrompt = {
     validateTokenName(args.tokenName, 'tokenName');
     validateNumericAmount(args.amount, 'amount');
 
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Calculate sell proceeds using LOCAL bonding curve formula.
+    return createPromptResponse(`Calculate sell proceeds using LOCAL bonding curve formula.
 
 Token: ${args.tokenName}
 Sell Amount: ${args.amount} tokens
@@ -397,10 +329,7 @@ Use ${MCP_TOOLS.CALCULATE_SELL_AMOUNT_LOCAL} for instant calculation:
 - Requires pool details (fetch separately)
 - No network call required
 
-Display the expected GALA proceeds.`,
-        },
-      },
-    ];
+Display the expected GALA proceeds.`);
   },
 };
 
@@ -426,12 +355,7 @@ export const calculateSellAmountExternalPrompt: MCPPrompt = {
     validateTokenName(args.tokenName, 'tokenName');
     validateNumericAmount(args.amount, 'amount');
 
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Calculate sell proceeds using EXTERNAL GalaChain network call.
+    return createPromptResponse(`Calculate sell proceeds using EXTERNAL GalaChain network call.
 
 Token: ${args.tokenName}
 Sell Amount: ${args.amount} tokens
@@ -441,10 +365,7 @@ Use ${MCP_TOOLS.CALCULATE_SELL_AMOUNT_EXTERNAL} for real-time calculation:
 - Most accurate pricing available
 - Includes reverse bonding curve fees
 
-Use this for precise selling decisions.`,
-        },
-      },
-    ];
+Use this for precise selling decisions.`);
   },
 };
 
@@ -464,23 +385,17 @@ export const isTokenGraduatedPrompt: MCPPrompt = {
   handler: (args) => {
     validateTokenName(args.tokenName, 'tokenName');
 
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Check token graduation status.
-
-Token: ${args.tokenName}
-
-Use ${MCP_TOOLS.IS_TOKEN_GRADUATED} to determine:
-- Whether token has completed bonding curve
-- Whether token is now trading on full DEX
-
-Display the graduation status clearly.`,
+    return createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Check token graduation status.',
+        parameters: {
+          token_name: `Token: ${args.tokenName}`,
         },
-      },
-    ];
+        toolName: MCP_TOOLS.IS_TOKEN_GRADUATED,
+        actionDescription: 'determine whether token has completed bonding curve and is trading on full DEX',
+        displayFormat: 'Display the graduation status clearly.',
+      })
+    );
   },
 };
 

package/src/prompts/trading.ts

@@ -9,7 +9,8 @@ import {
   createTradingWorkflow,
   createAnalysisWorkflow,
 } from './utils/workflowTemplates.js';
-import { validateTokenName, validateNumericAmount, validateSlippage } from '../utils/validation.js';
+import { validateTokenName, validateNumericAmount, validateOptionalSlippage } from '../utils/validation.js';
+import { createPromptResponse } from './utils/handlerHelpers.js';
 
 /**
  * Analyze Token - Complete token analysis workflow
@@ -29,15 +30,7 @@ export const analyzeTokenPrompt: MCPPrompt = {
     // Validate inputs
     validateTokenName(args.tokenName);
 
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: createAnalysisWorkflow(args.tokenName),
-        },
-      },
-    ];
+    return createPromptResponse(createAnalysisWorkflow(args.tokenName));
   },
 };
 
@@ -68,25 +61,17 @@ export const buyTokensPrompt: MCPPrompt = {
     // Validate inputs
     validateTokenName(args.tokenName);
     validateNumericAmount(args.galaAmount, 'galaAmount');
-    if (args.slippage) {
-      validateSlippage(args.slippage);
-    }
+    validateOptionalSlippage(args.slippage);
 
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: createTradingWorkflow({
-            operation: 'buy',
-            tokenName: args.tokenName,
-            amount: args.galaAmount,
-            amountType: 'gala',
-            slippage: args.slippage || '1',
-          }),
-        },
-      },
-    ];
+    return createPromptResponse(
+      createTradingWorkflow({
+        operation: 'buy',
+        tokenName: args.tokenName,
+        amount: args.galaAmount,
+        amountType: 'gala',
+        slippage: args.slippage || '1',
+      })
+    );
   },
 };
 
@@ -117,24 +102,16 @@ export const sellTokensPrompt: MCPPrompt = {
     // Validate inputs
     validateTokenName(args.tokenName);
     validateNumericAmount(args.tokenAmount, 'tokenAmount');
-    if (args.slippage) {
-      validateSlippage(args.slippage);
-    }
+    validateOptionalSlippage(args.slippage);
 
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: createTradingWorkflow({
-            operation: 'sell',
-            tokenName: args.tokenName,
-            amount: args.tokenAmount,
-            slippage: args.slippage || '1',
-          }),
-        },
-      },
-    ];
+    return createPromptResponse(
+      createTradingWorkflow({
+        operation: 'sell',
+        tokenName: args.tokenName,
+        amount: args.tokenAmount,
+        slippage: args.slippage || '1',
+      })
+    );
   },
 };
 
@@ -160,23 +137,15 @@ export const graduateTokenPrompt: MCPPrompt = {
   handler: (args) => {
     // Validate inputs
     validateTokenName(args.tokenName);
-    if (args.slippage) {
-      validateSlippage(args.slippage);
-    }
+    validateOptionalSlippage(args.slippage);
 
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: createTradingWorkflow({
-            operation: 'graduate',
-            tokenName: args.tokenName,
-            slippage: args.slippage || '1',
-          }),
-        },
-      },
-    ];
+    return createPromptResponse(
+      createTradingWorkflow({
+        operation: 'graduate',
+        tokenName: args.tokenName,
+        slippage: args.slippage || '1',
+      })
+    );
   },
 };
 

package/src/prompts/transfers.ts

@@ -7,6 +7,8 @@
 import type { MCPPrompt } from '../types/mcp.js';
 import { MCP_TOOLS } from '../constants/mcpToolNames.js';
 import { validateAddress, validateNumericAmount, validateTokenName } from '../utils/validation.js';
+import { createPromptResponse } from './utils/handlerHelpers.js';
+import { createSimpleOperationText } from './utils/textTemplates.js';
 
 /**
  * Transfer GALA - GALA token transfer
@@ -30,22 +32,18 @@ export const transferGalaPrompt: MCPPrompt = {
     validateAddress(args.recipientAddress, 'recipientAddress');
     validateNumericAmount(args.amount, 'amount');
 
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Transfer GALA tokens.
-
-Recipient: ${args.recipientAddress}
-Amount: ${args.amount} GALA
-
-Use ${MCP_TOOLS.TRANSFER_GALA} to execute the transfer.
-
-Display the transaction details and confirmation.`,
+    return createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Transfer GALA tokens.',
+        parameters: {
+          recipient: `Recipient: ${args.recipientAddress}`,
+          amount: `Amount: ${args.amount} GALA`,
         },
-      },
-    ];
+        toolName: MCP_TOOLS.TRANSFER_GALA,
+        actionDescription: 'execute the transfer',
+        displayFormat: 'Display the transaction details and confirmation.',
+      })
+    );
   },
 };
 
@@ -77,23 +75,19 @@ export const transferTokenPrompt: MCPPrompt = {
     validateTokenName(args.tokenName, 'tokenName');
     validateNumericAmount(args.amount, 'amount');
 
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Transfer launchpad tokens.
-
-Recipient: ${args.to}
-Token: ${args.tokenName}
-Amount: ${args.amount}
-
-Use ${MCP_TOOLS.TRANSFER_TOKEN} to execute the transfer.
-
-Display the transaction details and confirmation.`,
+    return createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Transfer launchpad tokens.',
+        parameters: {
+          recipient: `Recipient: ${args.to}`,
+          token: `Token: ${args.tokenName}`,
+          amount: `Amount: ${args.amount}`,
         },
-      },
-    ];
+        toolName: MCP_TOOLS.TRANSFER_TOKEN,
+        actionDescription: 'execute the transfer',
+        displayFormat: 'Display the transaction details and confirmation.',
+      })
+    );
   },
 };