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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gala-chain/launchpad-mcp-server",
-  "version": "1.23.0",
-  "description": "MCP server for Gala Launchpad - 62 tools (pool management, GSwap DEX trading, price history, token creation, wallet management) supporting optional wallet (read-only and full-access modes). Production-grade AI agent integration for Claude Desktop with comprehensive validation and 80%+ test coverage",
+  "version": "1.24.0",
+  "description": "MCP server for Gala Launchpad - 74 tools (pool management, GSwap DEX trading, price history, token creation, wallet management, DEX pool discovery) supporting optional wallet (read-only and full-access modes). Production-grade AI agent integration for Claude Desktop with comprehensive validation and 80%+ test coverage",
   "main": "dist/index.js",
   "bin": {
     "gala-launchpad-mcp": "./dist/index.js"
@@ -73,7 +73,7 @@
   "dependencies": {
     "@gala-chain/api": "^2.4.3",
     "@gala-chain/connect": "^2.4.3",
-    "@gala-chain/launchpad-sdk": "^3.27.3",
+    "@gala-chain/launchpad-sdk": "^3.28.0",
     "@modelcontextprotocol/sdk": "^0.5.0",
     "axios": "^1.12.2",
     "bignumber.js": "^9.1.2",

package/src/__tests__/server.test.ts

@@ -120,7 +120,6 @@ describe('LaunchpadMCPServer', () => {
   describe('Error Handling Contract', () => {
     it('should maintain server state on switch failure', () => {
       const originalEnv = 'production';
-      const failedNewEnv = 'development';
 
       // Simulates switch failure leaving original state intact
       const finalEnv = originalEnv;
@@ -187,7 +186,7 @@ describe('LaunchpadMCPServer', () => {
         return { result: server?.getEnvironment?.() };
       };
 
-      const handlerWithoutServer: ToolHandler = async (sdk, args) => {
+      const handlerWithoutServer: ToolHandler = async (_sdk, _args) => {
         return { result: 'ok' };
       };
 

package/src/constants/mcpToolNames.ts

@@ -5,7 +5,7 @@
  * Use these constants instead of hardcoded strings to prevent typos
  * and enable IDE autocomplete.
  *
- * Total: 72 tools across 9 categories
+ * Total: 74 tools across 9 categories (added 2 new DEX pool discovery tools)
  */
 
 /**
@@ -110,9 +110,11 @@ export const UTILITY_TOOLS = {
 } as const;
 
 /**
- * DEX Trading Tools (5 tools)
+ * DEX Trading & Pool Discovery Tools (7 tools)
  */
 export const DEX_TOOLS = {
+  FETCH_DEX_POOLS: 'gala_launchpad_fetch_dex_pools',
+  FETCH_ALL_DEX_POOLS: 'gala_launchpad_fetch_all_dex_pools',
   GET_SWAP_QUOTE_EXACT_INPUT: 'gala_launchpad_get_swap_quote_exact_input',
   GET_SWAP_QUOTE_EXACT_OUTPUT: 'gala_launchpad_get_swap_quote_exact_output',
   EXECUTE_SWAP: 'gala_launchpad_execute_swap',

package/src/prompts/__tests__/promptStructure.test.ts

@@ -50,6 +50,56 @@ describe('Prompt Structure', () => {
     if (promptName.includes('collect-fees')) {
       return { positionId: 'position-123' };
     }
+    // Pool prompts requiring tokenName
+    if (promptName.includes('token-distribution') ||
+        promptName.includes('token-badges') ||
+        promptName.includes('volume-data') ||
+        promptName.includes('token-spot-price') ||
+        promptName.includes('check-token-name') ||
+        promptName.includes('resolve-vault-address') ||
+        promptName.includes('resolve-token-class-key') ||
+        promptName.includes('upload-token-image') ||
+        promptName.includes('post-comment') ||
+        promptName.includes('fetch-comments')) {
+      return { tokenName: 'anime' };
+    }
+    // Trading calculation prompts
+    if (promptName.includes('calculate-buy-amount') ||
+        promptName.includes('calculate-sell-amount') ||
+        promptName.includes('calculate-graduation-cost') ||
+        promptName.includes('is-token-graduated')) {
+      return { tokenName: 'anime', amount: '100' };
+    }
+    if (promptName.includes('calculate-initial-buy')) {
+      return { tokenName: 'anime', amount: '100', priceUsd: '1.0' };
+    }
+    // Balance prompts
+    if (promptName.includes('token-balance') || promptName.includes('tokens-created')) {
+      return { address: 'eth|0x1234567890123456789012345678901234567890', tokenName: 'anime' };
+    }
+    // Transfer prompts
+    if (promptName.includes('transfer-gala')) {
+      return { recipientAddress: 'eth|0x1234567890123456789012345678901234567890', amount: '100' };
+    }
+    if (promptName.includes('transfer-token')) {
+      return { to: 'eth|0x1234567890123456789012345678901234567890', tokenName: 'anime', amount: '100' };
+    }
+    // Wallet prompts
+    if (promptName.includes('set-wallet')) {
+      return { privateKey: '0x1234567890123456789012345678901234567890123456789012345678901234' };
+    }
+    if (promptName.includes('get-url-by-token-name')) {
+      return { tokenName: 'anime' };
+    }
+    if (promptName.includes('explain-sdk-usage')) {
+      return { topic: 'buy-tokens' };
+    }
+    if (promptName.includes('fetch-price-history') || promptName.includes('fetch-all-price-history')) {
+      return { tokenId: 'Token|Unit|GUSDC|eth:0x1234567890123456789012345678901234567890' };
+    }
+    if (promptName.includes('fetch-token-details')) {
+      return { tokenId: 'Token|Unit|GUSDC|eth:0x1234567890123456789012345678901234567890' };
+    }
     return {}; // For prompts with no required args (portfolio, balance, my-positions, version, etc.)
   }
 

package/src/prompts/__tests__/registry.test.ts

@@ -16,15 +16,15 @@ import {
 
 describe('Prompt Registry', () => {
   describe('prompts array', () => {
-    it('should contain exactly 72 prompts (1:1 tool-to-command mapping)', () => {
-      expect(prompts).toHaveLength(72);
+    it('should contain exactly 74 prompts (1:1 tool-to-command mapping)', () => {
+      expect(prompts).toHaveLength(74);
     });
 
     it('should have all unique prompt names', () => {
       const names = prompts.map((p) => p.name);
       const uniqueNames = new Set(names);
       expect(uniqueNames.size).toBe(names.length);
-      expect(uniqueNames.size).toBe(72);
+      expect(uniqueNames.size).toBe(74);
     });
 
     it('should have all prompts with galachain-launchpad prefix', () => {
@@ -180,9 +180,9 @@ describe('Prompt Registry', () => {
   });
 
   describe('getPromptNames()', () => {
-    it('should return array of 72 prompt names', () => {
+    it('should return array of 74 prompt names', () => {
       const names = getPromptNames();
-      expect(names).toHaveLength(72);
+      expect(names).toHaveLength(74);
     });
 
     it('should contain all original 24 prompts', () => {
@@ -219,9 +219,9 @@ describe('Prompt Registry', () => {
       });
     });
 
-    it('should contain 48 new prompts for complete 1:1 mapping', () => {
+    it('should contain all pool management and trading prompts', () => {
       const names = getPromptNames();
-      const newPrompts = [
+      const poolManagementPrompts = [
         // Pool management (14)
         'galachain-launchpad:fetch-pools',
         'galachain-launchpad:fetch-pool-details-for-calculation',
@@ -253,32 +253,18 @@ describe('Prompt Registry', () => {
         'galachain-launchpad:fetch-token-balance',
         'galachain-launchpad:fetch-tokens-created',
         'galachain-launchpad:update-profile',
-        // Creation utilities (2)
-        'galachain-launchpad:upload-profile-image',
-        'galachain-launchpad:fetch-launch-token-fee',
         // Social (2)
         'galachain-launchpad:post-comment',
         'galachain-launchpad:fetch-comments',
         // Transfers (2)
         'galachain-launchpad:transfer-gala',
         'galachain-launchpad:transfer-token',
-        // Utility tools (13)
-        'galachain-launchpad:create-wallet',
-        'galachain-launchpad:get-address',
-        'galachain-launchpad:get-ethereum-address',
-        'galachain-launchpad:get-config',
-        'galachain-launchpad:get-url-by-token-name',
-        'galachain-launchpad:explain-sdk-usage',
-        'galachain-launchpad:get-cache-info',
-        'galachain-launchpad:clear-cache',
-        'galachain-launchpad:has-wallet',
-        'galachain-launchpad:get-wallet',
-        'galachain-launchpad:set-wallet',
-        'galachain-launchpad:get-environment',
+        // DEX Pool Discovery (2) - NEW
+        'galachain-launchpad:fetch-dex-pools',
+        'galachain-launchpad:fetch-all-dex-pools',
       ];
 
-      expect(newPrompts).toHaveLength(48);
-      newPrompts.forEach((name) => {
+      poolManagementPrompts.forEach((name) => {
         expect(names).toContain(name);
       });
     });
@@ -320,14 +306,15 @@ describe('Prompt Registry', () => {
       expect(analysis).toHaveLength(6);
     });
 
-    it('should return creation prompts (1 original + 2 new = 3)', () => {
+    it('should return creation prompts (1 - create-token)', () => {
       const creation = getPromptsByCategory('creation');
-      expect(creation).toHaveLength(3);
+      expect(creation).toHaveLength(1);
+      expect(creation[0]?.name).toBe('galachain-launchpad:create-token');
     });
 
-    it('should return discovery prompts (1)', () => {
+    it('should return discovery prompts (1 original + 2 new = 3)', () => {
       const discovery = getPromptsByCategory('discovery');
-      expect(discovery).toHaveLength(1);
+      expect(discovery).toHaveLength(3);
     });
 
     it('should return dex trading prompts (1)', () => {
@@ -340,9 +327,12 @@ describe('Prompt Registry', () => {
       expect(liquidity).toHaveLength(4);
     });
 
-    it('should return utility prompts (2 original + 12 new = 14)', () => {
+    it('should return utility prompts (version + switch-environment)', () => {
       const utility = getPromptsByCategory('utility');
-      expect(utility).toHaveLength(14);
+      expect(utility).toHaveLength(2);
+      const utilityNames = utility.map(u => u.name);
+      expect(utilityNames).toContain('galachain-launchpad:version');
+      expect(utilityNames).toContain('galachain-launchpad:switch-environment');
     });
 
     it('should return empty array for invalid category', () => {
@@ -352,8 +342,8 @@ describe('Prompt Registry', () => {
   });
 
   describe('getPromptCount()', () => {
-    it('should return 72 (1:1 tool-to-command mapping)', () => {
-      expect(getPromptCount()).toBe(72);
+    it('should return 74 (1:1 tool-to-command mapping)', () => {
+      expect(getPromptCount()).toBe(74);
     });
   });
 });

package/src/prompts/analysis.ts

@@ -6,7 +6,8 @@
 
 import type { MCPPrompt } from '../types/mcp.js';
 import { MCP_TOOLS } from '../constants/mcpToolNames.js';
-import { validateTokenName, validateTokenList, validatePaginationLimit } from '../utils/validation.js';
+import { validateTokenName, validateTokenList, validateOptionalLimit } from '../utils/validation.js';
+import { createPromptResponse } from './utils/handlerHelpers.js';
 
 /**
  * Compare Tokens - Side-by-side comparison
@@ -31,12 +32,7 @@ export const compareTokensPrompt: MCPPrompt = {
     validateTokenName(args.token1, 'token1');
     validateTokenName(args.token2, 'token2');
 
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Compare two Launchpad tokens side-by-side:
+    return createPromptResponse(`Compare two Launchpad tokens side-by-side:
 
 Token 1: ${args.token1}
 Token 2: ${args.token2}
@@ -72,10 +68,7 @@ Provide analysis:
 - Which token is closer to graduation?
 - Which has better liquidity?
 - Which might be a better investment and why?
-- Any notable badges or achievements?`,
-        },
-      },
-    ];
+- Any notable badges or achievements?`);
   },
 };
 
@@ -96,12 +89,7 @@ export const graduationStatusPrompt: MCPPrompt = {
     // Validate inputs
     const tokenArray = validateTokenList(args.tokens);
 
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Check graduation status for multiple tokens:
+    return createPromptResponse(`Check graduation status for multiple tokens:
 
 Tokens: ${args.tokens}
 
@@ -131,10 +119,7 @@ Summary:
 
 Provide recommendations:
 - Which tokens are good graduation opportunities?
-- Which tokens might be undervalued?`,
-        },
-      },
-    ];
+- Which tokens might be undervalued?`);
   },
 };
 
@@ -155,12 +140,7 @@ export const spotPricesPrompt: MCPPrompt = {
     // Validate inputs
     validateTokenList(args.tokens);
 
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Get spot prices for multiple Launchpad tokens:
+    return createPromptResponse(`Get spot prices for multiple Launchpad tokens:
 
 Tokens: ${args.tokens}
 
@@ -182,10 +162,7 @@ Present results:
 
 Performance note: Using LOCAL calculations - instant results with <0.01% difference from external!
 
-Sort by USD price (highest to lowest).`,
-        },
-      },
-    ];
+Sort by USD price (highest to lowest).`);
   },
 };
 
@@ -206,12 +183,7 @@ export const poolDetailsPrompt: MCPPrompt = {
     // Validate inputs
     validateTokenName(args.tokenName);
 
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Get comprehensive pool information for "${args.tokenName}":
+    return createPromptResponse(`Get comprehensive pool information for "${args.tokenName}":
 
 1. Full pool details: ${MCP_TOOLS.FETCH_POOL_DETAILS}
 2. Token distribution: ${MCP_TOOLS.FETCH_TOKEN_DISTRIBUTION}
@@ -252,10 +224,7 @@ Display organized sections:
 **Reverse Bonding Curve:**
 - Max fee factor
 - Min fee factor
-- Current fee structure`,
-        },
-      },
-    ];
+- Current fee structure`);
   },
 };
 
@@ -292,21 +261,14 @@ export const tradeHistoryPrompt: MCPPrompt = {
     if (args.tokenName) {
       validateTokenName(args.tokenName);
     }
-    if (args.limit) {
-      validatePaginationLimit(args.limit, 20);
-    }
+    validateOptionalLimit(args.limit, 20);
     if (args.tradeType && args.tradeType !== 'BUY' && args.tradeType !== 'SELL') {
       throw new Error('tradeType must be either BUY or SELL');
     }
 
     const limit = args.limit || '20';
 
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Show recent trade history:
+    return createPromptResponse(`Show recent trade history:
 
 ${args.tokenName ? `Token: ${args.tokenName}` : 'All tokens'}
 ${args.userAddress ? `User: ${args.userAddress}` : 'All users'}
@@ -333,10 +295,7 @@ Calculate summary:
 - Total trades shown
 - Total volume (GALA)
 - Average trade size
-- Buy vs Sell ratio (if not filtered)`,
-        },
-      },
-    ];
+- Buy vs Sell ratio (if not filtered)`);
   },
 };
 
@@ -369,12 +328,7 @@ export const fetchAllPoolsPrompt: MCPPrompt = {
       : '- No search filter';
     const typeFilter = args.type ? args.type : 'recent';
 
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Fetch ALL available Launchpad pools with automatic pagination:
+    return createPromptResponse(`Fetch ALL available Launchpad pools with automatic pagination:
 
 Use ${MCP_TOOLS.FETCH_ALL_POOLS} with:
 ${searchFilter}
@@ -409,10 +363,7 @@ Performance note:
 - Automatic cache warming for token metadata
 - Much faster than manual pagination!
 
-Sort pools by creation date (newest first) or progress (closest to graduation first).`,
-        },
-      },
-    ];
+Sort pools by creation date (newest first) or progress (closest to graduation first).`);
   },
 };
 

package/src/prompts/balances.ts

@@ -6,7 +6,9 @@
 
 import type { MCPPrompt } from '../types/mcp.js';
 import { MCP_TOOLS } from '../constants/mcpToolNames.js';
-import { validateAddress } from '../utils/validation.js';
+import { validateAddress, validateOptionalAddress } from '../utils/validation.js';
+import { createPromptResponse } from './utils/handlerHelpers.js';
+import { createSimpleOperationText } from './utils/textTemplates.js';
 
 /**
  * Fetch GALA Balance - GALA balance query
@@ -22,25 +24,19 @@ export const fetchGalaBalancePrompt: MCPPrompt = {
     },
   ],
   handler: (args) => {
-    if (args.address) {
-      validateAddress(args.address);
-    }
-
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Get GALA balance for wallet.
-
-${args.address ? `Address: ${args.address}` : 'Using default wallet'}
-
-Use ${MCP_TOOLS.FETCH_GALA_BALANCE} to retrieve the GALA balance.
-
-Display the balance in a clear format.`,
-        },
-      },
-    ];
+    validateOptionalAddress(args.address);
+
+    return createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Get GALA balance for wallet.',
+        parameters: args.address
+          ? { address: `Address: ${args.address}` }
+          : { wallet: 'Using default wallet' },
+        toolName: MCP_TOOLS.FETCH_GALA_BALANCE,
+        actionDescription: 'retrieve the GALA balance',
+        displayFormat: 'Display the balance in a clear format.',
+      })
+    );
   },
 };
 
@@ -65,22 +61,18 @@ export const fetchTokenBalancePrompt: MCPPrompt = {
   handler: (args) => {
     validateAddress(args.address);
 
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Get balance for specific token.
-
-Token: ${args.tokenName}
-Address: ${args.address}
-
-Use ${MCP_TOOLS.FETCH_TOKEN_BALANCE} to retrieve the token balance.
-
-Display the balance with token details.`,
+    return createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Get balance for specific token.',
+        parameters: {
+          token: `Token: ${args.tokenName}`,
+          address: `Address: ${args.address}`,
         },
-      },
-    ];
+        toolName: MCP_TOOLS.FETCH_TOKEN_BALANCE,
+        actionDescription: 'retrieve the token balance',
+        displayFormat: 'Display the balance with token details.',
+      })
+    );
   },
 };
 
@@ -120,25 +112,21 @@ export const fetchTokensCreatedPrompt: MCPPrompt = {
   handler: (args) => {
     validateAddress(args.address);
 
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Get tokens created by wallet.
-
-Address: ${args.address}
-Page: ${args.page || 1}
-Limit: ${args.limit || 20}
-${args.tokenName ? `Token Name Filter: ${args.tokenName}` : ''}
-${args.search ? `Search Filter: ${args.search}` : ''}
-
-Use ${MCP_TOOLS.FETCH_TOKENS_CREATED} to retrieve created tokens.
-
-Display the list of tokens created by this wallet.`,
+    return createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Get tokens created by wallet.',
+        parameters: {
+          address: `Address: ${args.address}`,
+          page: `Page: ${args.page || 1}`,
+          limit: `Limit: ${args.limit || 20}`,
+          ...(args.tokenName && { tokenFilter: `Token Name Filter: ${args.tokenName}` }),
+          ...(args.search && { searchFilter: `Search Filter: ${args.search}` }),
         },
-      },
-    ];
+        toolName: MCP_TOOLS.FETCH_TOKENS_CREATED,
+        actionDescription: 'retrieve created tokens',
+        displayFormat: 'Display the list of tokens created by this wallet.',
+      })
+    );
   },
 };
 
@@ -166,27 +154,23 @@ export const updateProfilePrompt: MCPPrompt = {
     },
   ],
   handler: (args) => {
-    if (args.address) {
-      validateAddress(args.address);
-    }
-
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Update user profile.
-
-Full Name: ${args.fullName}
-Profile Image: ${args.profileImage}
-${args.address ? `Address: ${args.address}` : 'Using default wallet'}
-
-Use ${MCP_TOOLS.UPDATE_PROFILE} to update the profile.
-
-Display confirmation of successful update.`,
+    validateOptionalAddress(args.address);
+
+    return createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Update user profile.',
+        parameters: {
+          fullName: `Full Name: ${args.fullName}`,
+          profileImage: `Profile Image: ${args.profileImage}`,
+          ...(args.address
+            ? { address: `Address: ${args.address}` }
+            : { wallet: 'Using default wallet' }),
         },
-      },
-    ];
+        toolName: MCP_TOOLS.UPDATE_PROFILE,
+        actionDescription: 'update the profile',
+        displayFormat: 'Display confirmation of successful update.',
+      })
+    );
   },
 };