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

package/src/prompts/creation-utils.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';
 
 /**
  * Upload Profile Image - Standalone profile image upload
@@ -26,24 +28,19 @@ export const uploadProfileImagePrompt: MCPPrompt = {
       required: false,
     },
   ],
-  handler: (args) => {
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Upload profile image.
-
-Image Path: ${args.imagePath}
-${args.address ? `Address: ${args.address}` : 'Using default wallet'}
-
-Use ${MCP_TOOLS.UPLOAD_PROFILE_IMAGE} to upload the image file.
-
-Display confirmation and the image URL.`,
+  handler: (args) =>
+    createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Upload profile image.',
+        parameters: {
+          imagePath: `Image Path: ${args.imagePath}`,
+          wallet: args.address ? `Address: ${args.address}` : 'Using default wallet',
         },
-      },
-    ];
-  },
+        toolName: MCP_TOOLS.UPLOAD_PROFILE_IMAGE,
+        actionDescription: 'upload the image file',
+        displayFormat: 'Display confirmation and the image URL.',
+      })
+    ),
 };
 
 /**
@@ -67,24 +64,18 @@ export const uploadTokenImagePrompt: MCPPrompt = {
   handler: (args) => {
     validateTokenName(args.tokenName);
 
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Upload token image.
-
-Token: ${args.tokenName}
-Image Path: ${args.imagePath}
-
-Use ${MCP_TOOLS.UPLOAD_TOKEN_IMAGE} to upload the token image file.
-
-This tool is Node.js only (not available in browser).
-
-Display confirmation and the uploaded image URL.`,
+    return createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Upload token image.',
+        parameters: {
+          token: `Token: ${args.tokenName}`,
+          imagePath: `Image Path: ${args.imagePath}`,
         },
-      },
-    ];
+        toolName: MCP_TOOLS.UPLOAD_TOKEN_IMAGE,
+        actionDescription: 'upload the token image file',
+        displayFormat: 'This tool is Node.js only (not available in browser).\n\nDisplay confirmation and the uploaded image URL.',
+      })
+    );
   },
 };
 
@@ -94,21 +85,15 @@ Display confirmation and the uploaded image URL.`,
 export const fetchLaunchTokenFeePrompt: MCPPrompt = {
   name: 'galachain-launchpad:fetch-launch-token-fee',
   description: 'Get the current GALA fee required to launch a new token',
-  handler: () => {
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Check the current token launch fee.
-
-Use ${MCP_TOOLS.FETCH_LAUNCH_TOKEN_FEE} to retrieve the current GALA fee.
-
-This is a dynamic value that may change. Display the current fee amount.`,
-        },
-      },
-    ];
-  },
+  handler: () =>
+    createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Check the current token launch fee.',
+        toolName: MCP_TOOLS.FETCH_LAUNCH_TOKEN_FEE,
+        actionDescription: 'retrieve the current GALA fee',
+        displayFormat: 'This is a dynamic value that may change. Display the current fee amount.',
+      })
+    ),
 };
 
 export const creationUtilityPrompts: MCPPrompt[] = [

package/src/prompts/explore-dex-pools.ts

@@ -0,0 +1,138 @@
+/**
+ * DEX Pool Exploration Prompts
+ *
+ * Slash commands for discovering and exploring GalaSwap DEX liquidity pools.
+ * These prompts guide users through finding trading pairs and analyzing pool metrics.
+ */
+
+import type { MCPPrompt } from '../types/mcp.js';
+import { MCP_TOOLS } from '../constants/mcpToolNames.js';
+import { validatePaginationLimit } from '../utils/validation.js';
+import { createPromptResponse } from './utils/handlerHelpers.js';
+import { createSimpleOperationText } from './utils/textTemplates.js';
+
+/**
+ * Fetch DEX Pools - Paginated pool discovery with filters
+ */
+export const fetchDexPoolsPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:fetch-dex-pools',
+  description: 'Discover DEX liquidity pools with pagination, sorting, and search filtering',
+  arguments: [
+    {
+      name: 'search',
+      description: 'Search filter for token symbols (e.g., GALA, GUSDC, GWETH)',
+      required: false,
+    },
+    {
+      name: 'sortBy',
+      description: 'Sort field: tvl (default), volume30d, or volume1d',
+      required: false,
+    },
+    {
+      name: 'sortOrder',
+      description: 'Sort order: desc (default) or asc',
+      required: false,
+    },
+    {
+      name: 'page',
+      description: 'Page number (default: 1)',
+      required: false,
+    },
+    {
+      name: 'limit',
+      description: 'Results per page (default: 10, max: 20)',
+      required: false,
+    },
+  ],
+  handler: (args) => {
+    if (args.limit) {
+      validatePaginationLimit(args.limit, 20);
+    }
+
+    const sortBy = args.sortBy || 'tvl';
+    const sortOrder = args.sortOrder || 'desc';
+    const page = args.page || 1;
+    const limit = args.limit || 10;
+
+    return createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Discover liquidity pools on GalaSwap DEX.',
+        parameters: {
+          search: args.search ? `Search: ${args.search}` : 'Search: (none)',
+          sort_by: `Sort by: ${sortBy}`,
+          sort_order: `Order: ${sortOrder}`,
+          page: `Page: ${page}`,
+          limit: `Limit: ${limit}`,
+        },
+        toolName: MCP_TOOLS.FETCH_DEX_POOLS,
+        actionDescription: 'retrieve liquidity pools with pagination and filtering',
+        displayFormat: 'Display results showing pool names, token pairs, TVL, volumes, and APR metrics.',
+      })
+    );
+  },
+};
+
+/**
+ * Fetch All DEX Pools - Complete pool discovery with auto-pagination
+ */
+export const fetchAllDexPoolsPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:fetch-all-dex-pools',
+  description: 'Discover ALL DEX liquidity pools with automatic pagination',
+  arguments: [
+    {
+      name: 'search',
+      description: 'Search filter for token symbols (e.g., GALA, GUSDC)',
+      required: false,
+    },
+    {
+      name: 'sortBy',
+      description: 'Sort field: tvl (default), volume30d, or volume1d',
+      required: false,
+    },
+    {
+      name: 'sortOrder',
+      description: 'Sort order: desc (default) or asc',
+      required: false,
+    },
+  ],
+  handler: (args) => {
+    const sortBy = args.sortBy || 'tvl';
+    const sortOrder = args.sortOrder || 'desc';
+
+    return [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `I want to discover all DEX liquidity pools on GalaSwap.
+
+**Discovery Parameters:**
+- Search Filter: ${args.search || '(none - get all pools)'}
+- Sort By: ${sortBy}
+- Sort Order: ${sortOrder}
+
+**Action:**
+Fetch all available DEX pools with automatic pagination. Show me comprehensive pool data including:
+- Pool identifiers (token pairs)
+- Total Value Locked (TVL) and TVL breakdown by token
+- 24-hour and 30-day trading volumes
+- Fee tiers and APR
+- Volume-to-TVL ratios
+
+Please use the following MCP tool:
+- gala_launchpad_fetch_all_dex_pools: Retrieve all pools with auto-pagination
+
+Display the results in a clear format showing the top pools and key metrics for analysis.`,
+        },
+      },
+    ];
+  },
+};
+
+/**
+ * Export all DEX pool exploration prompts
+ */
+export const exploreDexPoolsPrompts: MCPPrompt[] = [
+  fetchDexPoolsPrompt,
+  fetchAllDexPoolsPrompt,
+];

package/src/prompts/index.ts

@@ -11,6 +11,7 @@ import { utilityPrompts } from './utility.js';
 import { creationPrompts } from './create-token.js';
 import { discoveryPrompts } from './discover-tokens.js';
 import { dexTradingPrompts } from './dex-trading.js';
+import { exploreDexPoolsPrompts } from './explore-dex-pools.js';
 import { liquidityPositionPrompts } from './liquidity-positions.js';
 import { poolPrompts } from './pools.js';
 import { tradingCalculationPrompts } from './trading-calculations.js';
@@ -22,7 +23,7 @@ import { utilityToolPrompts } from './utility-tools.js';
 import type { MCPPrompt } from '../types/mcp.js';
 
 /**
- * All available prompts (72 total)
+ * All available prompts (74 total - 2 new DEX pool exploration prompts)
  */
 export const prompts: MCPPrompt[] = [
   ...tradingPrompts,
@@ -31,6 +32,7 @@ export const prompts: MCPPrompt[] = [
   ...creationPrompts,
   ...discoveryPrompts,
   ...dexTradingPrompts,
+  ...exploreDexPoolsPrompts,
   ...liquidityPositionPrompts,
   ...utilityPrompts,
   ...poolPrompts,
@@ -127,7 +129,7 @@ export function getPromptsByCategory(
     case 'creation':
       return creationPrompts;
     case 'discovery':
-      return discoveryPrompts;
+      return [...discoveryPrompts, ...exploreDexPoolsPrompts];
     case 'dex':
       return dexTradingPrompts;
     case 'liquidity':
@@ -163,6 +165,7 @@ export {
   creationPrompts,
   discoveryPrompts,
   dexTradingPrompts,
+  exploreDexPoolsPrompts,
   liquidityPositionPrompts,
   utilityPrompts,
   poolPrompts,

package/src/prompts/liquidity-positions.ts

@@ -6,6 +6,7 @@
 
 import type { MCPPrompt } from '../types/mcp.js';
 import { validateNumericAmount } from '../utils/validation.js';
+import { createPromptResponse } from './utils/handlerHelpers.js';
 
 /**
  * View My Liquidity Positions - List all open LP positions
@@ -17,13 +18,8 @@ export const myPositionsPrompt: MCPPrompt = {
   description:
     'View all your open liquidity positions on GalaSwap DEX with details about each position',
   arguments: [],
-  handler: () => {
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `I want to view all my open liquidity positions on GalaSwap DEX.
+  handler: () =>
+    createPromptResponse(`I want to view all my open liquidity positions on GalaSwap DEX.
 
 **Action:**
 Show me all my liquidity positions with the following information for each:
@@ -42,11 +38,7 @@ Show me all my liquidity positions with the following information for each:
 Please use the following MCP tools:
 - gala_launchpad_get_user_liquidity_positions: Retrieve all open positions for my wallet
 
-Proceed with fetching my positions.`,
-        },
-      },
-    ];
-  },
+Proceed with fetching my positions.`),
 };
 
 /**
@@ -104,12 +96,7 @@ export const addLiquidityPrompt: MCPPrompt = {
     const maxPrice = args.maxPrice || '1.05';
     const feeTier = args.feeTier || '3000';
 
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `I want to add liquidity to the ${args.token0}/${args.token1} pool on GalaSwap DEX.
+    return createPromptResponse(`I want to add liquidity to the ${args.token0}/${args.token1} pool on GalaSwap DEX.
 
 **Liquidity Details:**
 - Token Pair: ${args.token0} / ${args.token1}
@@ -134,10 +121,7 @@ Please use the following MCP tools:
 - gala_launchpad_get_swap_pool_info: Get ${args.token0}/${args.token1} pool details
 - gala_launchpad_add_liquidity_by_price: Add liquidity with price range
 
-Proceed with adding liquidity.`,
-        },
-      },
-    ];
+Proceed with adding liquidity.`);
   },
 };
 
@@ -165,12 +149,7 @@ export const removeLiquidityPrompt: MCPPrompt = {
   handler: (args) => {
     const percentage = args.percentage || '100';
 
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `I want to remove ${percentage}% of liquidity from position ${args.positionId}.
+    return createPromptResponse(`I want to remove ${percentage}% of liquidity from position ${args.positionId}.
 
 **Removal Details:**
 - Position ID: ${args.positionId}
@@ -195,10 +174,7 @@ Please use the following MCP tools:
 - gala_launchpad_estimate_remove_liquidity: Preview what I'll receive
 - gala_launchpad_remove_liquidity: Execute the removal
 
-Proceed with removing liquidity.`,
-        },
-      },
-    ];
+Proceed with removing liquidity.`);
   },
 };
 
@@ -218,13 +194,8 @@ export const collectFeesPrompt: MCPPrompt = {
       required: true,
     },
   ],
-  handler: (args) => {
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `I want to collect accumulated trading fees from position ${args.positionId}.
+  handler: (args) =>
+    createPromptResponse(`I want to collect accumulated trading fees from position ${args.positionId}.
 
 **Fee Collection Details:**
 - Position ID: ${args.positionId}
@@ -252,11 +223,7 @@ Please use the following MCP tools:
 - gala_launchpad_get_liquidity_position_by_id: Get position details and fee amounts
 - gala_launchpad_collect_position_fees: Collect the accumulated fees
 
-Proceed with collecting fees.`,
-        },
-      },
-    ];
-  },
+Proceed with collecting fees.`),
 };
 
 /**