@gala-chain/launchpad-mcp-server 1.7.2 → 1.7.4

package/src/prompts/index.ts

@@ -0,0 +1,123 @@
+/**
+ * Gala Launchpad MCP Prompts (Slash Commands)
+ *
+ * Provides user-friendly slash commands for common Launchpad workflows
+ */
+
+import { tradingPrompts } from './trading.js';
+import { portfolioPrompts } from './portfolio.js';
+import { analysisPrompts } from './analysis.js';
+import type { MCPPrompt } from '../types/mcp.js';
+
+/**
+ * All available prompts
+ */
+export const prompts: MCPPrompt[] = [
+  ...tradingPrompts,
+  ...portfolioPrompts,
+  ...analysisPrompts,
+];
+
+/**
+ * Optimized prompt registry using Map for O(1) lookups
+ * Improves performance for large prompt collections
+ */
+const promptMap = new Map<string, MCPPrompt>(
+  prompts.map((prompt) => [prompt.name, prompt])
+);
+
+/**
+ * Get prompt by name (optimized with Map lookup)
+ *
+ * @param name - Prompt name (e.g., 'galachain-launchpad:analyze-token')
+ * @returns Prompt object or undefined if not found
+ *
+ * @example
+ * ```typescript
+ * const prompt = getPrompt('galachain-launchpad:buy-tokens');
+ * if (prompt) {
+ *   const messages = prompt.handler({ tokenName: 'anime', galaAmount: '100' });
+ * }
+ * ```
+ */
+export function getPrompt(name: string): MCPPrompt | undefined {
+  return promptMap.get(name);
+}
+
+/**
+ * Get all prompt names
+ *
+ * @returns Array of all registered prompt names
+ *
+ * @example
+ * ```typescript
+ * const names = getPromptNames();
+ * // ['galachain-launchpad:analyze-token', 'galachain-launchpad:buy-tokens', ...]
+ * ```
+ */
+export function getPromptNames(): string[] {
+  return Array.from(promptMap.keys());
+}
+
+/**
+ * Check if a prompt exists by name
+ *
+ * @param name - Prompt name to check
+ * @returns True if prompt exists, false otherwise
+ *
+ * @example
+ * ```typescript
+ * if (hasPrompt('galachain-launchpad:analyze-token')) {
+ *   console.log('Prompt is available');
+ * }
+ * ```
+ */
+export function hasPrompt(name: string): boolean {
+  return promptMap.has(name);
+}
+
+/**
+ * Get prompts by category
+ *
+ * @param category - Category name ('trading', 'portfolio', or 'analysis')
+ * @returns Array of prompts in the specified category
+ *
+ * @example
+ * ```typescript
+ * const tradingCommands = getPromptsByCategory('trading');
+ * // Returns [analyzeTokenPrompt, buyTokensPrompt, sellTokensPrompt, graduateTokenPrompt]
+ * ```
+ */
+export function getPromptsByCategory(
+  category: 'trading' | 'portfolio' | 'analysis'
+): MCPPrompt[] {
+  switch (category) {
+    case 'trading':
+      return tradingPrompts;
+    case 'portfolio':
+      return portfolioPrompts;
+    case 'analysis':
+      return analysisPrompts;
+    default:
+      return [];
+  }
+}
+
+/**
+ * Get prompt count
+ *
+ * @returns Total number of registered prompts
+ *
+ * @example
+ * ```typescript
+ * console.log(`Total prompts: ${getPromptCount()}`); // Total prompts: 14
+ * ```
+ */
+export function getPromptCount(): number {
+  return promptMap.size;
+}
+
+/**
+ * Export individual prompt categories for documentation
+ */
+export { tradingPrompts, portfolioPrompts, analysisPrompts };

package/src/prompts/portfolio.ts

@@ -0,0 +1,242 @@
+/**
+ * Portfolio Prompts
+ *
+ * Slash commands for portfolio management on Gala Launchpad
+ */
+
+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';
+
+/**
+ * Portfolio - Complete portfolio analysis
+ */
+export const portfolioPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:portfolio',
+  description: 'Analyze complete portfolio with GALA balance, token holdings, and total USD value',
+  handler: () => [
+    {
+      role: 'user',
+      content: {
+        type: 'text',
+        text: createPortfolioWorkflow(),
+      },
+    },
+  ],
+};
+
+/**
+ * Tokens Held - List all token holdings
+ */
+export const tokensHeldPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:tokens-held',
+  description: 'List all Launchpad tokens currently held with balances',
+  arguments: [
+    {
+      name: 'search',
+      description: 'Optional search filter for token names (fuzzy match)',
+      required: false,
+    },
+    {
+      name: 'limit',
+      description: 'Number of tokens to show (default: 20)',
+      required: false,
+    },
+  ],
+  handler: (args) => {
+    // Validate inputs
+    if (args.limit) {
+      validatePaginationLimit(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:
+
+Use ${MCP_TOOLS.FETCH_TOKENS_HELD} with:
+${searchFilter}
+- limit: ${limit}
+
+For each token, display:
+- Token name
+- Balance (formatted with decimals)
+- Whether I created this token (if applicable)
+
+Sort by balance (highest to lowest).
+
+If I have more tokens than the limit, show pagination info and offer to fetch more.`,
+        },
+      },
+    ];
+  },
+};
+
+/**
+ * Tokens Created - Show tokens created by user
+ */
+export const tokensCreatedPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:tokens-created',
+  description: 'List all Launchpad tokens created by the user with their current status',
+  arguments: [
+    {
+      name: 'search',
+      description: 'Optional search filter for token names (fuzzy match)',
+      required: false,
+    },
+    {
+      name: 'limit',
+      description: 'Number of tokens to show (default: 20)',
+      required: false,
+    },
+  ],
+  handler: (args) => {
+    // Validate inputs
+    if (args.limit) {
+      validatePaginationLimit(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:
+
+Use ${MCP_TOOLS.FETCH_TOKENS_CREATED} with:
+${searchFilter}
+- limit: ${limit}
+
+For each token, display:
+- Token name and symbol
+- Current status (check using ${MCP_TOOLS.FETCH_POOL_DETAILS}):
+  * Pool status (Ongoing/Completed)
+  * Current supply
+  * Remaining tokens
+  * Progress percentage
+- Whether graduated (use ${MCP_TOOLS.IS_TOKEN_GRADUATED})
+- Frontend URL (use ${MCP_TOOLS.GET_URL_BY_TOKEN_NAME})
+
+Provide a summary:
+- Total tokens created
+- How many are graduated
+- How many are still in bonding curve phase`,
+        },
+      },
+    ];
+  },
+};
+
+/**
+ * Balance - Check GALA and specific token balances
+ */
+export const balancePrompt: MCPPrompt = {
+  name: 'galachain-launchpad:balance',
+  description: 'Check GALA balance and optionally a specific token balance',
+  arguments: [
+    {
+      name: 'tokenName',
+      description: 'Optional token name to check balance for (e.g., anime)',
+      required: false,
+    },
+  ],
+  handler: (args) => {
+    // Validate inputs
+    if (args.tokenName) {
+      validateTokenName(args.tokenName);
+    }
+
+    return [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: args.tokenName
+            ? `Check my balances:
+
+1. GALA balance using ${MCP_TOOLS.FETCH_GALA_BALANCE}
+2. ${args.tokenName} token balance using ${MCP_TOOLS.FETCH_TOKEN_BALANCE}
+3. Calculate USD values:
+   - GALA USD value using ${MCP_TOOLS.FETCH_GALA_SPOT_PRICE}
+   - ${args.tokenName} USD value using ${MCP_TOOLS.FETCH_LAUNCHPAD_TOKEN_SPOT_PRICE}
+
+Display:
+- GALA: [amount] ($[USD value])
+- ${args.tokenName}: [amount] ($[USD value])
+- Total value: $[combined USD value]`
+            : `Check my GALA balance:
+
+Use ${MCP_TOOLS.FETCH_GALA_BALANCE} to get current GALA balance.
+Use ${MCP_TOOLS.FETCH_GALA_SPOT_PRICE} to calculate USD value.
+
+Display:
+- GALA: [amount]
+- USD value: $[calculated value]
+
+Tip: Add tokenName argument to check a specific token balance.`,
+        },
+      },
+    ];
+  },
+};
+
+/**
+ * Profile - Show user profile information
+ */
+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:
+
+1. Get profile info using ${MCP_TOOLS.FETCH_PROFILE}
+   - Full name
+   - Profile image URL
+   - Wallet address
+
+2. Get activity summary:
+   - Tokens held count: ${MCP_TOOLS.FETCH_TOKENS_HELD} (limit: 1) for total
+   - Tokens created count: ${MCP_TOOLS.FETCH_TOKENS_CREATED} (limit: 1) for total
+
+3. Get wallet info:
+   - GalaChain address format: ${MCP_TOOLS.GET_ADDRESS}
+   - Ethereum address format: ${MCP_TOOLS.GET_ETHEREUM_ADDRESS}
+   - GALA balance: ${MCP_TOOLS.FETCH_GALA_BALANCE}
+
+Display:
+- Profile details
+- Activity metrics
+- Wallet addresses
+- Current balance`,
+      },
+    },
+  ],
+};
+
+/**
+ * Export all portfolio prompts
+ */
+export const portfolioPrompts: MCPPrompt[] = [
+  portfolioPrompt,
+  tokensHeldPrompt,
+  tokensCreatedPrompt,
+  balancePrompt,
+  profilePrompt,
+];

package/src/prompts/trading.ts

@@ -0,0 +1,191 @@
+/**
+ * Trading Prompts
+ *
+ * Slash commands for trading operations on Gala Launchpad
+ */
+
+import type { MCPPrompt } from '../types/mcp.js';
+import {
+  createTradingWorkflow,
+  createAnalysisWorkflow,
+} from './utils/workflowTemplates.js';
+import { validateTokenName, validateNumericAmount, validateSlippage } from '../utils/validation.js';
+
+/**
+ * Analyze Token - Complete token analysis workflow
+ */
+export const analyzeTokenPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:analyze-token',
+  description:
+    'Perform comprehensive analysis of a Launchpad token including pool details, spot price, and graduation cost',
+  arguments: [
+    {
+      name: 'tokenName',
+      description: 'Token name to analyze (e.g., anime, test216253)',
+      required: true,
+    },
+  ],
+  handler: (args) => {
+    // Validate inputs
+    validateTokenName(args.tokenName);
+
+    return [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: createAnalysisWorkflow(args.tokenName),
+        },
+      },
+    ];
+  },
+};
+
+/**
+ * Buy Tokens - Guided token purchase workflow
+ */
+export const buyTokensPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:buy-tokens',
+  description: 'Guide user through buying tokens with slippage protection and cost breakdown',
+  arguments: [
+    {
+      name: 'tokenName',
+      description: 'Token to buy (e.g., anime)',
+      required: true,
+    },
+    {
+      name: 'galaAmount',
+      description: 'GALA amount to spend (e.g., 100)',
+      required: true,
+    },
+    {
+      name: 'slippage',
+      description: 'Slippage tolerance percentage (default: 1)',
+      required: false,
+    },
+  ],
+  handler: (args) => {
+    // Validate inputs
+    validateTokenName(args.tokenName);
+    validateNumericAmount(args.galaAmount, 'galaAmount');
+    if (args.slippage) {
+      validateSlippage(args.slippage);
+    }
+
+    return [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: createTradingWorkflow({
+            operation: 'buy',
+            tokenName: args.tokenName,
+            amount: args.galaAmount,
+            amountType: 'gala',
+            slippage: args.slippage || '1',
+          }),
+        },
+      },
+    ];
+  },
+};
+
+/**
+ * Sell Tokens - Guided token sale workflow
+ */
+export const sellTokensPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:sell-tokens',
+  description: 'Guide user through selling tokens with slippage protection',
+  arguments: [
+    {
+      name: 'tokenName',
+      description: 'Token to sell (e.g., anime)',
+      required: true,
+    },
+    {
+      name: 'tokenAmount',
+      description: 'Token amount to sell (e.g., 1000)',
+      required: true,
+    },
+    {
+      name: 'slippage',
+      description: 'Slippage tolerance percentage (default: 1)',
+      required: false,
+    },
+  ],
+  handler: (args) => {
+    // Validate inputs
+    validateTokenName(args.tokenName);
+    validateNumericAmount(args.tokenAmount, 'tokenAmount');
+    if (args.slippage) {
+      validateSlippage(args.slippage);
+    }
+
+    return [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: createTradingWorkflow({
+            operation: 'sell',
+            tokenName: args.tokenName,
+            amount: args.tokenAmount,
+            slippage: args.slippage || '1',
+          }),
+        },
+      },
+    ];
+  },
+};
+
+/**
+ * Graduate Token - One-step graduation workflow
+ */
+export const graduateTokenPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:graduate-token',
+  description:
+    'Graduate a bonding curve pool by buying all remaining tokens in one transaction',
+  arguments: [
+    {
+      name: 'tokenName',
+      description: 'Token to graduate (e.g., anime)',
+      required: true,
+    },
+    {
+      name: 'slippage',
+      description: 'Slippage tolerance percentage (default: 1)',
+      required: false,
+    },
+  ],
+  handler: (args) => {
+    // Validate inputs
+    validateTokenName(args.tokenName);
+    if (args.slippage) {
+      validateSlippage(args.slippage);
+    }
+
+    return [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: createTradingWorkflow({
+            operation: 'graduate',
+            tokenName: args.tokenName,
+            slippage: args.slippage || '1',
+          }),
+        },
+      },
+    ];
+  },
+};
+
+/**
+ * Export all trading prompts
+ */
+export const tradingPrompts: MCPPrompt[] = [
+  analyzeTokenPrompt,
+  buyTokensPrompt,
+  sellTokensPrompt,
+  graduateTokenPrompt,
+];