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

package/src/prompts/utility-tools.ts

@@ -6,6 +6,8 @@
 
 import type { MCPPrompt } from '../types/mcp.js';
 import { MCP_TOOLS } from '../constants/mcpToolNames.js';
+import { createPromptResponse } from './utils/handlerHelpers.js';
+import { createSimpleOperationText } from './utils/textTemplates.js';
 
 /**
  * Create Wallet - Generate new wallet
@@ -13,24 +15,15 @@ import { MCP_TOOLS } from '../constants/mcpToolNames.js';
 export const createWalletPrompt: MCPPrompt = {
   name: 'galachain-launchpad:create-wallet',
   description: 'Generate a new wallet with random private key',
-  handler: () => {
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Create a new wallet with random private key.
-
-Use ${MCP_TOOLS.CREATE_WALLET} to generate:
-- New wallet address
-- Random private key
-- Wallet credentials for authentication
-
-Display the wallet details with a security warning about private key storage.`,
-        },
-      },
-    ];
-  },
+  handler: () =>
+    createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Create a new wallet with random private key.',
+        toolName: MCP_TOOLS.CREATE_WALLET,
+        actionDescription: 'generate new wallet address, random private key, and wallet credentials for authentication',
+        displayFormat: 'Display the wallet details with a security warning about private key storage.',
+      })
+    ),
 };
 
 /**
@@ -39,21 +32,15 @@ Display the wallet details with a security warning about private key storage.`,
 export const getAddressPrompt: MCPPrompt = {
   name: 'galachain-launchpad:get-address',
   description: 'Get the GalaChain address format of authenticated wallet',
-  handler: () => {
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Get the GalaChain format address of the authenticated wallet.
-
-Use ${MCP_TOOLS.GET_ADDRESS} to retrieve the address in GalaChain format (eth|0x...).
-
-Display the wallet address.`,
-        },
-      },
-    ];
-  },
+  handler: () =>
+    createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Get the GalaChain format address of the authenticated wallet.',
+        toolName: MCP_TOOLS.GET_ADDRESS,
+        actionDescription: 'retrieve the address in GalaChain format (eth|0x...)',
+        displayFormat: 'Display the wallet address.',
+      })
+    ),
 };
 
 /**
@@ -62,21 +49,15 @@ Display the wallet address.`,
 export const getEthereumAddressPrompt: MCPPrompt = {
   name: 'galachain-launchpad:get-ethereum-address',
   description: 'Get the standard Ethereum address format of authenticated wallet',
-  handler: () => {
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Get the standard Ethereum format address of the authenticated wallet.
-
-Use ${MCP_TOOLS.GET_ETHEREUM_ADDRESS} to retrieve the address in Ethereum format (0x...).
-
-Display the wallet address.`,
-        },
-      },
-    ];
-  },
+  handler: () =>
+    createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Get the standard Ethereum format address of the authenticated wallet.',
+        toolName: MCP_TOOLS.GET_ETHEREUM_ADDRESS,
+        actionDescription: 'retrieve the address in Ethereum format (0x...)',
+        displayFormat: 'Display the wallet address.',
+      })
+    ),
 };
 
 /**
@@ -85,27 +66,15 @@ Display the wallet address.`,
 export const getConfigPrompt: MCPPrompt = {
   name: 'galachain-launchpad:get-config',
   description: 'View current SDK and MCP server configuration',
-  handler: () => {
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Get the current SDK and MCP server configuration.
-
-Use ${MCP_TOOLS.GET_CONFIG} to retrieve:
-- Environment (production, development, testing)
-- Base URLs
-- Timeout settings
-- Feature flags
-- Effective slippage tolerance factors
-- Current MCP server environment state
-
-Display the configuration in a readable format.`,
-        },
-      },
-    ];
-  },
+  handler: () =>
+    createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Get the current SDK and MCP server configuration.',
+        toolName: MCP_TOOLS.GET_CONFIG,
+        actionDescription: 'retrieve environment, base URLs, timeout settings, feature flags, effective slippage tolerance factors, and current MCP server state',
+        displayFormat: 'Display the configuration in a readable format.',
+      })
+    ),
 };
 
 /**
@@ -121,23 +90,18 @@ export const getUrlByTokenNamePrompt: MCPPrompt = {
       required: true,
     },
   ],
-  handler: (args) => {
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Get the launchpad frontend URL for a token.
-
-Token: ${args.tokenName}
-
-Use ${MCP_TOOLS.GET_URL_BY_TOKEN_NAME} to generate the URL.
-
-Display the complete launchpad URL for viewing/trading the token.`,
+  handler: (args) =>
+    createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Get the launchpad frontend URL for a token.',
+        parameters: {
+          token_name: `Token: ${args.tokenName}`,
         },
-      },
-    ];
-  },
+        toolName: MCP_TOOLS.GET_URL_BY_TOKEN_NAME,
+        actionDescription: 'generate the URL',
+        displayFormat: 'Display the complete launchpad URL for viewing/trading the token.',
+      })
+    ),
 };
 
 /**
@@ -153,21 +117,15 @@ export const explainSdkUsagePrompt: MCPPrompt = {
       required: true,
     },
   ],
-  handler: (args) => {
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Get detailed SDK usage examples for topic: ${args.topic}
-
-Use ${MCP_TOOLS.EXPLAIN_SDK_USAGE} to retrieve complete runnable code examples.
-
-Display the examples with explanations for integrating the SDK directly.`,
-        },
-      },
-    ];
-  },
+  handler: (args) =>
+    createPromptResponse(
+      createSimpleOperationText({
+        operation: `Get detailed SDK usage examples for topic: ${args.topic}.`,
+        toolName: MCP_TOOLS.EXPLAIN_SDK_USAGE,
+        actionDescription: 'retrieve complete runnable code examples',
+        displayFormat: 'Display the examples with explanations for integrating the SDK directly.',
+      })
+    ),
 };
 
 /**
@@ -176,24 +134,15 @@ Display the examples with explanations for integrating the SDK directly.`,
 export const getCacheInfoPrompt: MCPPrompt = {
   name: 'galachain-launchpad:get-cache-info',
   description: 'Get token metadata cache statistics',
-  handler: () => {
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Get token metadata cache statistics.
-
-Use ${MCP_TOOLS.GET_CACHE_INFO} to retrieve:
-- Total tokens cached
-- Cache size in bytes
-- Timestamp of oldest entry
-
-Display the cache information.`,
-        },
-      },
-    ];
-  },
+  handler: () =>
+    createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Get token metadata cache statistics.',
+        toolName: MCP_TOOLS.GET_CACHE_INFO,
+        actionDescription: 'retrieve total tokens cached, cache size in bytes, and timestamp of oldest entry',
+        displayFormat: 'Display the cache information.',
+      })
+    ),
 };
 
 /**
@@ -209,23 +158,18 @@ export const clearCachePrompt: MCPPrompt = {
       required: false,
     },
   ],
-  handler: (args) => {
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Clear token metadata cache.
-
-${args.tokenName ? `Token: ${args.tokenName}` : 'Clearing entire cache'}
-
-Use ${MCP_TOOLS.CLEAR_CACHE} to clear the cache.
-
-Display confirmation of cache clearing.`,
+  handler: (args) =>
+    createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Clear token metadata cache.',
+        parameters: {
+          token_name: args.tokenName ? `Token: ${args.tokenName}` : 'Clearing entire cache',
         },
-      },
-    ];
-  },
+        toolName: MCP_TOOLS.CLEAR_CACHE,
+        actionDescription: 'clear the cache',
+        displayFormat: 'Display confirmation of cache clearing.',
+      })
+    ),
 };
 
 /**
@@ -234,23 +178,15 @@ Display confirmation of cache clearing.`,
 export const hasWalletPrompt: MCPPrompt = {
   name: 'galachain-launchpad:has-wallet',
   description: 'Check if a wallet is configured in the MCP server',
-  handler: () => {
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Check wallet configuration status.
-
-Use ${MCP_TOOLS.HAS_WALLET} to determine:
-- Whether a wallet is configured
-- Whether MCP server is in full-access or read-only mode
-
-Display the wallet status clearly.`,
-        },
-      },
-    ];
-  },
+  handler: () =>
+    createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Check wallet configuration status.',
+        toolName: MCP_TOOLS.HAS_WALLET,
+        actionDescription: 'determine whether a wallet is configured and whether MCP server is in full-access or read-only mode',
+        displayFormat: 'Display the wallet status clearly.',
+      })
+    ),
 };
 
 /**
@@ -259,23 +195,15 @@ Display the wallet status clearly.`,
 export const getWalletPrompt: MCPPrompt = {
   name: 'galachain-launchpad:get-wallet',
   description: 'Get the currently configured wallet instance',
-  handler: () => {
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Get the currently configured wallet instance.
-
-Use ${MCP_TOOLS.GET_WALLET} to retrieve:
-- Wallet object if available
-- Null if in read-only mode
-
-Display the wallet information.`,
-        },
-      },
-    ];
-  },
+  handler: () =>
+    createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Get the currently configured wallet instance.',
+        toolName: MCP_TOOLS.GET_WALLET,
+        actionDescription: 'retrieve wallet object if available (null if in read-only mode)',
+        displayFormat: 'Display the wallet information.',
+      })
+    ),
 };
 
 /**
@@ -291,23 +219,18 @@ export const setWalletPrompt: MCPPrompt = {
       required: true,
     },
   ],
-  handler: (args) => {
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Configure wallet for signing operations.
-
-Private Key: ${args.privateKey.substring(0, 10)}...${args.privateKey.substring(60)}
-
-Use ${MCP_TOOLS.SET_WALLET} to configure the wallet.
-
-Display confirmation that wallet is configured for full-access mode.`,
+  handler: (args) =>
+    createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Configure wallet for signing operations.',
+        parameters: {
+          private_key: `Private Key: ${args.privateKey.substring(0, 10)}...${args.privateKey.substring(60)}`,
         },
-      },
-    ];
-  },
+        toolName: MCP_TOOLS.SET_WALLET,
+        actionDescription: 'configure the wallet',
+        displayFormat: 'Display confirmation that wallet is configured for full-access mode.',
+      })
+    ),
 };
 
 /**
@@ -316,21 +239,15 @@ Display confirmation that wallet is configured for full-access mode.`,
 export const getEnvironmentPrompt: MCPPrompt = {
   name: 'galachain-launchpad:get-environment',
   description: 'Get the current MCP server environment',
-  handler: () => {
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Get the current MCP server environment.
-
-Use ${MCP_TOOLS.GET_ENVIRONMENT} to retrieve the active environment.
-
-Display the current environment (production, development, or testing).`,
-        },
-      },
-    ];
-  },
+  handler: () =>
+    createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Get the current MCP server environment.',
+        toolName: MCP_TOOLS.GET_ENVIRONMENT,
+        actionDescription: 'retrieve the active environment',
+        displayFormat: 'Display the current environment (production, development, or testing).',
+      })
+    ),
 };
 
 export const utilityToolPrompts: MCPPrompt[] = [

package/src/prompts/utility.ts

@@ -5,6 +5,7 @@
  */
 
 import type { MCPPrompt } from '../types/mcp.js';
+import { createPromptResponse } from './utils/handlerHelpers.js';
 
 /**
  * Get Version - Display SDK and MCP server version information
@@ -16,12 +17,7 @@ export const getVersionPrompt: MCPPrompt = {
   name: 'galachain-launchpad:version',
   description: 'Get SDK and MCP server version information',
   handler: () => {
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Get version information for the Gala Launchpad SDK and MCP server.
+    return createPromptResponse(`Get version information for the Gala Launchpad SDK and MCP server.
 
 Use the gala_launchpad_get_version tool to fetch the version details.
 
@@ -30,10 +26,7 @@ Display the results in a clear, formatted response showing:
 2. MCP Server Version
 3. Timestamp
 
-This is helpful for debugging version compatibility issues or confirming installed versions.`,
-        },
-      },
-    ];
+This is helpful for debugging version compatibility issues or confirming installed versions.`);
   },
 };
 
@@ -59,12 +52,7 @@ export const switchEnvironmentPrompt: MCPPrompt = {
     const validEnvs = ['production', 'development', 'testing'];
     const isValidEnv = validEnvs.includes(targetEnv);
 
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Switch the Gala Launchpad MCP server to a different environment.
+    return createPromptResponse(`Switch the Gala Launchpad MCP server to a different environment.
 
 Current task: Switch to the ${isValidEnv ? targetEnv : 'specified'} environment
 
@@ -79,10 +67,7 @@ Available environments:
 - development: Development environment for testing features
 - testing: Testing environment for local/staging tests
 
-Wallet Preservation: The wallet configuration will be preserved during the switch, maintaining your current signing capabilities if configured.`,
-        },
-      },
-    ];
+Wallet Preservation: The wallet configuration will be preserved during the switch, maintaining your current signing capabilities if configured.`);
   },
 };
 

package/src/prompts/utils/handlerHelpers.ts

@@ -0,0 +1,55 @@
+/**
+ * Handler Helper Utilities
+ *
+ * Provides reusable utilities for creating MCP prompt handlers with
+ * standardized response formatting and validation patterns.
+ */
+
+import type { PromptMessage } from '../../types/mcp.js';
+
+/**
+ * Create a standard MCP prompt response with user role
+ *
+ * @param text - The prompt text to send to the user
+ * @returns Array containing formatted MCP message
+ *
+ * @example
+ * handler: (args) => {
+ *   validateTokenName(args.tokenName);
+ *   return createPromptResponse(`Fetch token ${args.tokenName}...`);
+ * }
+ */
+export function createPromptResponse(text: string): PromptMessage[] {
+  return [
+    {
+      role: 'user',
+      content: {
+        type: 'text',
+        text,
+      },
+    },
+  ];
+}
+
+/**
+ * Create a handler function that validates arguments and returns a prompt response
+ *
+ * @param validator - Function to validate the arguments
+ * @param textGenerator - Function that generates the prompt text from arguments
+ * @returns A handler function ready to use in a prompt definition
+ *
+ * @example
+ * handler: createValidatedHandler(
+ *   (args) => validateTokenName(args.tokenName),
+ *   (args) => `Fetch token ${args.tokenName}...`
+ * )
+ */
+export function createValidatedHandler<T>(
+  validator: (args: T) => void,
+  textGenerator: (args: T) => string
+): (args: T) => PromptMessage[] {
+  return (args: T) => {
+    validator(args);
+    return createPromptResponse(textGenerator(args));
+  };
+}

package/src/prompts/utils/textTemplates.ts

@@ -0,0 +1,73 @@
+/**
+ * Prompt Text Templates
+ *
+ * Provides reusable template generators for common MCP prompt patterns.
+ */
+
+/**
+ * Configuration for simple operation prompts
+ */
+export interface SimpleOperationConfig {
+  /** Operation description (e.g., "Fetch GALA balance for wallet.") */
+  operation: string;
+
+  /** Parameter descriptions as key-value pairs (optional) */
+  parameters?: Record<string, string | undefined>;
+
+  /** MCP tool name (e.g., MCP_TOOLS.FETCH_GALA_BALANCE) */
+  toolName: string;
+
+  /** Description of what the tool does (e.g., "retrieve the GALA balance") */
+  actionDescription: string;
+
+  /** Optional display format instructions */
+  displayFormat?: string;
+}
+
+/**
+ * Generate text for simple operation prompts
+ *
+ * Creates a standardized prompt text with operation, parameters, tool usage,
+ * and optional display format instructions.
+ *
+ * @param config - Configuration for the operation
+ * @returns Formatted prompt text
+ *
+ * @example
+ * text: createSimpleOperationText({
+ *   operation: 'Get GALA balance for wallet.',
+ *   parameters: {
+ *     address: args.address ? `Address: ${args.address}` : 'Using default wallet'
+ *   },
+ *   toolName: MCP_TOOLS.FETCH_GALA_BALANCE,
+ *   actionDescription: 'retrieve the GALA balance',
+ *   displayFormat: 'Display the balance in a clear format.'
+ * })
+ */
+export function createSimpleOperationText(config: SimpleOperationConfig): string {
+  const { operation, parameters, toolName, actionDescription, displayFormat } = config;
+
+  const parts: string[] = [operation];
+
+  // Add parameters section
+  if (parameters && Object.values(parameters).some((v) => v !== undefined)) {
+    parts.push('');
+    Object.entries(parameters).forEach(([, value]) => {
+      if (value !== undefined && value !== null && value !== '') {
+        parts.push(value);
+      }
+    });
+  }
+
+  // Add tool usage instruction
+  parts.push('');
+  parts.push(`Use ${toolName} to ${actionDescription}.`);
+
+  // Add display format if provided
+  if (displayFormat) {
+    parts.push('');
+    parts.push(displayFormat);
+  }
+
+  return parts.join('\n');
+}

package/src/tools/dex/fetchAllDexPools.ts

@@ -0,0 +1,45 @@
+/**
+ * Fetch All DEX Pools Tool
+ *
+ * Convenience tool that fetches all available DEX pools with automatic pagination.
+ * No page/limit parameters needed - returns ALL pools matching filters.
+ */
+
+import type { MCPTool } from '../../types/mcp.js';
+import { formatSuccess } from '../../utils/response-formatter.js';
+import { withErrorHandling } from '../../utils/error-handler.js';
+
+export const fetchAllDexPoolsTool: MCPTool = {
+  name: 'gala_launchpad_fetch_all_dex_pools',
+  description: 'Fetch all DEX pools with automatic pagination. No page/limit parameters needed - returns ALL pools matching filters.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      search: {
+        type: 'string',
+        minLength: 1,
+        maxLength: 100,
+        description: 'Search filter for token symbols in pool pair (e.g., "GALA", "GUSDC")',
+      },
+      sortBy: {
+        type: 'string',
+        enum: ['tvl', 'volume30d', 'volume1d'],
+        description: 'Field to sort results by (default: tvl)',
+      },
+      sortOrder: {
+        type: 'string',
+        enum: ['asc', 'desc'],
+        description: 'Sort order direction (default: desc)',
+      },
+    },
+  },
+  handler: withErrorHandling(async (sdk, args) => {
+    const result = await sdk.fetchAllDexPools({
+      ...(args.search && { search: args.search }),
+      ...(args.sortBy && { sortBy: args.sortBy }),
+      ...(args.sortOrder && { sortOrder: args.sortOrder }),
+    });
+
+    return formatSuccess(result);
+  }),
+};