@gala-chain/launchpad-mcp-server 1.23.1 → 1.24.1

package/src/prompts/analysis.ts

@@ -0,0 +1,380 @@
+/**
+ * Analysis Prompts
+ *
+ * Slash commands for token analysis and comparison on Gala Launchpad
+ */
+
+import type { MCPPrompt } from '../types/mcp.js';
+import { MCP_TOOLS } from '../constants/mcpToolNames.js';
+import { validateTokenName, validateTokenList, validateOptionalLimit } from '../utils/validation.js';
+import { createPromptResponse } from './utils/handlerHelpers.js';
+
+/**
+ * Compare Tokens - Side-by-side comparison
+ */
+export const compareTokensPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:compare-tokens',
+  description: 'Compare two Launchpad tokens side-by-side with detailed metrics',
+  arguments: [
+    {
+      name: 'token1',
+      description: 'First token to compare (e.g., anime)',
+      required: true,
+    },
+    {
+      name: 'token2',
+      description: 'Second token to compare (e.g., test216253)',
+      required: true,
+    },
+  ],
+  handler: (args) => {
+    // Validate inputs
+    validateTokenName(args.token1, 'token1');
+    validateTokenName(args.token2, 'token2');
+
+    return createPromptResponse(`Compare two Launchpad tokens side-by-side:
+
+Token 1: ${args.token1}
+Token 2: ${args.token2}
+
+For EACH token, use the optimized pattern:
+
+1. Fetch pool details using ${MCP_TOOLS.FETCH_POOL_DETAILS_FOR_CALCULATION}
+
+2. Calculate metrics using LOCAL mode:
+   - Spot price: ${MCP_TOOLS.FETCH_LAUNCHPAD_TOKEN_SPOT_PRICE}
+   - Graduation cost: ${MCP_TOOLS.CALCULATE_BUY_AMOUNT_FOR_GRADUATION}
+   - Is graduated: ${MCP_TOOLS.IS_TOKEN_GRADUATED}
+
+3. Get additional data:
+   - Full pool details: ${MCP_TOOLS.FETCH_POOL_DETAILS}
+   - Token distribution: ${MCP_TOOLS.FETCH_TOKEN_DISTRIBUTION}
+   - Badges: ${MCP_TOOLS.FETCH_TOKEN_BADGES}
+
+Present a comparison table:
+
+| Metric | ${args.token1} | ${args.token2} |
+|--------|--------|--------|
+| Spot Price (USD) | ... | ... |
+| Market Cap Estimate | ... | ... |
+| Pool Status | ... | ... |
+| Progress to Graduation | ... | ... |
+| Remaining Tokens | ... | ... |
+| GALA to Graduate | ... | ... |
+| Holder Count | ... | ... |
+| Creator Status | ... | ... |
+
+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?`);
+  },
+};
+
+/**
+ * Graduation Status - Check multiple tokens for graduation readiness
+ */
+export const graduationStatusPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:graduation-status',
+  description: 'Check graduation status and readiness for multiple tokens',
+  arguments: [
+    {
+      name: 'tokens',
+      description: 'Comma-separated token names (e.g., anime,test216253,dragnrkti)',
+      required: true,
+    },
+  ],
+  handler: (args) => {
+    // Validate inputs
+    const tokenArray = validateTokenList(args.tokens);
+
+    return createPromptResponse(`Check graduation status for multiple tokens:
+
+Tokens: ${args.tokens}
+
+For EACH token in the list:
+
+1. Check if graduated: ${MCP_TOOLS.IS_TOKEN_GRADUATED}
+
+2. If not graduated, use optimized pattern:
+   a. Fetch pool details: ${MCP_TOOLS.FETCH_POOL_DETAILS_FOR_CALCULATION}
+   b. Calculate graduation cost: ${MCP_TOOLS.CALCULATE_BUY_AMOUNT_FOR_GRADUATION} (LOCAL mode)
+   c. Calculate progress: (currentSupply / maxSupply * 100)
+
+3. Get full pool details: ${MCP_TOOLS.FETCH_POOL_DETAILS}
+
+Present a table:
+
+| Token | Status | Progress | Remaining Tokens | GALA to Graduate | Frontend URL |
+|-------|--------|----------|------------------|------------------|--------------|
+| ... | ... | ... | ... | ... | ... |
+
+Summary:
+- Total tokens analyzed: ${tokenArray.length}
+- Already graduated: [count]
+- Close to graduation (>90%): [count]
+- Mid-progress (50-90%): [count]
+- Early stage (<50%): [count]
+
+Provide recommendations:
+- Which tokens are good graduation opportunities?
+- Which tokens might be undervalued?`);
+  },
+};
+
+/**
+ * Spot Prices - Batch spot price lookup
+ */
+export const spotPricesPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:spot-prices',
+  description: 'Get spot prices for multiple Launchpad tokens efficiently',
+  arguments: [
+    {
+      name: 'tokens',
+      description: 'Comma-separated token names (e.g., anime,test216253,dragnrkti)',
+      required: true,
+    },
+  ],
+  handler: (args) => {
+    // Validate inputs
+    validateTokenList(args.tokens);
+
+    return createPromptResponse(`Get spot prices for multiple Launchpad tokens:
+
+Tokens: ${args.tokens}
+
+Use the optimized batch pattern for EACH token:
+
+1. Fetch pool details: ${MCP_TOOLS.FETCH_POOL_DETAILS_FOR_CALCULATION}
+2. Calculate spot price: ${MCP_TOOLS.FETCH_LAUNCHPAD_TOKEN_SPOT_PRICE} (LOCAL mode)
+
+Also get GALA spot price: ${MCP_TOOLS.FETCH_GALA_SPOT_PRICE}
+
+Present results:
+
+**GALA Spot Price:** $[price]
+
+**Launchpad Token Prices:**
+| Token | USD Price | GALA Price | Market Cap Est. |
+|-------|-----------|------------|-----------------|
+| ... | ... | ... | ... |
+
+Performance note: Using LOCAL calculations - instant results with <0.01% difference from external!
+
+Sort by USD price (highest to lowest).`);
+  },
+};
+
+/**
+ * Pool Details - Comprehensive pool information
+ */
+export const poolDetailsPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:pool-details',
+  description: 'Get comprehensive pool information including distribution and badges',
+  arguments: [
+    {
+      name: 'tokenName',
+      description: 'Token to analyze (e.g., anime)',
+      required: true,
+    },
+  ],
+  handler: (args) => {
+    // Validate inputs
+    validateTokenName(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}
+3. Achievement badges: ${MCP_TOOLS.FETCH_TOKEN_BADGES}
+4. Recent volume data (last 24h): ${MCP_TOOLS.FETCH_VOLUME_DATA} with 1h resolution
+5. Check if graduated: ${MCP_TOOLS.IS_TOKEN_GRADUATED}
+6. Frontend URL: ${MCP_TOOLS.GET_URL_BY_TOKEN_NAME}
+
+Display organized sections:
+
+**Basic Info:**
+- Token name and symbol
+- Pool status
+- Created by
+- Frontend URL
+
+**Supply Metrics:**
+- Current supply
+- Maximum supply
+- Remaining tokens
+- Progress percentage
+
+**Distribution:**
+- Total holders
+- Top holders (if available)
+- Distribution metrics
+
+**Achievements:**
+- Volume badges
+- Engagement badges
+- Other achievements
+
+**Recent Activity (24h):**
+- Trading volume
+- Price movement
+- Number of trades
+
+**Reverse Bonding Curve:**
+- Max fee factor
+- Min fee factor
+- Current fee structure`);
+  },
+};
+
+/**
+ * Trade History - Recent trades with filters
+ */
+export const tradeHistoryPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:trade-history',
+  description: 'View recent trades for a token or user with filtering options',
+  arguments: [
+    {
+      name: 'tokenName',
+      description: 'Token to view trades for (optional)',
+      required: false,
+    },
+    {
+      name: 'userAddress',
+      description: 'User address to filter by (optional)',
+      required: false,
+    },
+    {
+      name: 'tradeType',
+      description: 'Trade type filter: BUY or SELL (optional)',
+      required: false,
+    },
+    {
+      name: 'limit',
+      description: 'Number of trades to show (default: 20)',
+      required: false,
+    },
+  ],
+  handler: (args) => {
+    // Validate inputs
+    if (args.tokenName) {
+      validateTokenName(args.tokenName);
+    }
+    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 createPromptResponse(`Show recent trade history:
+
+${args.tokenName ? `Token: ${args.tokenName}` : 'All tokens'}
+${args.userAddress ? `User: ${args.userAddress}` : 'All users'}
+${args.tradeType ? `Type: ${args.tradeType}` : 'All trade types'}
+Limit: ${limit}
+
+Use ${MCP_TOOLS.FETCH_TRADES} with:
+${args.tokenName ? `- tokenName: "${args.tokenName}"` : ''}
+${args.userAddress ? `- userAddress: "${args.userAddress}"` : ''}
+${args.tradeType ? `- tradeType: "${args.tradeType}"` : ''}
+- limit: ${limit}
+- sortOrder: "DESC" (newest first)
+
+For each trade, display:
+- Timestamp (formatted)
+- Token name
+- Trade type (BUY/SELL)
+- Amount (tokens)
+- Price (GALA)
+- User address (truncated)
+- Transaction ID
+
+Calculate summary:
+- Total trades shown
+- Total volume (GALA)
+- Average trade size
+- Buy vs Sell ratio (if not filtered)`);
+  },
+};
+
+/**
+ * Fetch All Pools - Get all available pools with automatic pagination
+ */
+export const fetchAllPoolsPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:fetch-all-pools',
+  description: 'Fetch all available Launchpad pools with automatic pagination (no limit needed)',
+  arguments: [
+    {
+      name: 'search',
+      description: 'Optional search filter for token names (fuzzy match)',
+      required: false,
+    },
+    {
+      name: 'type',
+      description: 'Pool type filter: recent or popular (optional, default: recent)',
+      required: false,
+    },
+  ],
+  handler: (args) => {
+    // Validate type if provided
+    if (args.type && args.type !== 'recent' && args.type !== 'popular') {
+      throw new Error('type must be either "recent" or "popular"');
+    }
+
+    const searchFilter = args.search
+      ? `- search: "${args.search}" (fuzzy match filter)`
+      : '- No search filter';
+    const typeFilter = args.type ? args.type : 'recent';
+
+    return createPromptResponse(`Fetch ALL available Launchpad pools with automatic pagination:
+
+Use ${MCP_TOOLS.FETCH_ALL_POOLS} with:
+${searchFilter}
+- type: "${typeFilter}"
+
+This tool automatically:
+- Fetches the first page to determine total available pools
+- Concurrently fetches remaining pages (up to 5 at a time)
+- Returns ALL matching pools in a single result
+
+For each pool, display:
+- Token name and symbol
+- Pool status (Ongoing/Completed)
+- Current price (if available)
+- Progress percentage
+- Creator address (truncated)
+- Frontend URL (use ${MCP_TOOLS.GET_URL_BY_TOKEN_NAME})
+
+Provide summary:
+- Total pools found
+- How many are graduated (Completed)
+- How many are active (Ongoing)
+- Distribution by progress stage:
+  * Early (<25%)
+  * Growing (25-75%)
+  * Near graduation (75-99%)
+  * Graduated (100%)
+
+Performance note:
+- Uses concurrent fetching with ${MCP_TOOLS.FETCH_ALL_POOLS}
+- Max 5 concurrent requests to avoid rate limiting
+- Automatic cache warming for token metadata
+- Much faster than manual pagination!
+
+Sort pools by creation date (newest first) or progress (closest to graduation first).`);
+  },
+};
+
+/**
+ * Export all analysis prompts
+ */
+export const analysisPrompts: MCPPrompt[] = [
+  compareTokensPrompt,
+  graduationStatusPrompt,
+  spotPricesPrompt,
+  poolDetailsPrompt,
+  tradeHistoryPrompt,
+  fetchAllPoolsPrompt,
+];

package/src/prompts/balances.ts

@@ -0,0 +1,182 @@
+/**
+ * Balance & Portfolio Prompts
+ *
+ * Slash commands for balance queries and portfolio management
+ */
+
+import type { MCPPrompt } from '../types/mcp.js';
+import { MCP_TOOLS } from '../constants/mcpToolNames.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
+ */
+export const fetchGalaBalancePrompt: MCPPrompt = {
+  name: 'galachain-launchpad:fetch-gala-balance',
+  description: 'Get GALA balance for a wallet',
+  arguments: [
+    {
+      name: 'address',
+      description: 'Wallet address (optional, defaults to SDK wallet)',
+      required: false,
+    },
+  ],
+  handler: (args) => {
+    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.',
+      })
+    );
+  },
+};
+
+/**
+ * Fetch Token Balance - Single token balance (optimized)
+ */
+export const fetchTokenBalancePrompt: MCPPrompt = {
+  name: 'galachain-launchpad:fetch-token-balance',
+  description: 'Get balance for a specific token',
+  arguments: [
+    {
+      name: 'tokenName',
+      description: 'Token name (e.g., anime)',
+      required: true,
+    },
+    {
+      name: 'address',
+      description: 'Wallet address',
+      required: true,
+    },
+  ],
+  handler: (args) => {
+    validateAddress(args.address);
+
+    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.',
+      })
+    );
+  },
+};
+
+/**
+ * Fetch Tokens Created - Created tokens query
+ */
+export const fetchTokensCreatedPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:fetch-tokens-created',
+  description: 'Get tokens created by a wallet',
+  arguments: [
+    {
+      name: 'address',
+      description: 'Wallet address',
+      required: true,
+    },
+    {
+      name: 'page',
+      description: 'Page number (default: 1)',
+      required: false,
+    },
+    {
+      name: 'limit',
+      description: 'Results per page (default: 20)',
+      required: false,
+    },
+    {
+      name: 'tokenName',
+      description: 'Filter by exact token name (optional)',
+      required: false,
+    },
+    {
+      name: 'search',
+      description: 'Filter by fuzzy search (optional)',
+      required: false,
+    },
+  ],
+  handler: (args) => {
+    validateAddress(args.address);
+
+    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.',
+      })
+    );
+  },
+};
+
+/**
+ * Update Profile - Profile modification
+ */
+export const updateProfilePrompt: MCPPrompt = {
+  name: 'galachain-launchpad:update-profile',
+  description: 'Update user profile information',
+  arguments: [
+    {
+      name: 'fullName',
+      description: 'Full name (letters and spaces only)',
+      required: true,
+    },
+    {
+      name: 'profileImage',
+      description: 'Profile image URL or empty string',
+      required: true,
+    },
+    {
+      name: 'address',
+      description: 'Wallet address (optional)',
+      required: false,
+    },
+  ],
+  handler: (args) => {
+    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.',
+      })
+    );
+  },
+};
+
+export const balancePrompts: MCPPrompt[] = [
+  fetchGalaBalancePrompt,
+  fetchTokenBalancePrompt,
+  fetchTokensCreatedPrompt,
+  updateProfilePrompt,
+];

package/src/prompts/create-token.ts

@@ -0,0 +1,123 @@
+/**
+ * Token Creation Prompts
+ *
+ * Slash commands for creating new tokens on Gala Launchpad
+ */
+
+import type { MCPPrompt } from '../types/mcp.js';
+import { createCreateTokenWorkflow } from './utils/workflowTemplates.js';
+import {
+  validateTokenName,
+  validateTokenSymbol,
+  validateUrl,
+  validateNumericAmount,
+} from '../utils/validation.js';
+
+/**
+ * Create Token - Guided token creation workflow
+ */
+export const createTokenPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:create-token',
+  description:
+    'Guide user through creating a new token on Gala Launchpad with metadata, image upload, and optional pre-buy',
+  arguments: [
+    {
+      name: 'tokenName',
+      description:
+        'Name for the new token - must be 3-20 lowercase alphanumeric characters (e.g., "mytoken")',
+      required: true,
+    },
+    {
+      name: 'tokenSymbol',
+      description: 'Token symbol - must be 1-8 uppercase letters (e.g., "MTK")',
+      required: true,
+    },
+    {
+      name: 'description',
+      description: 'Token description - brief description of what the token is for (1-500 chars)',
+      required: true,
+    },
+    {
+      name: 'websiteUrl',
+      description: 'Optional website URL (e.g., "https://mytoken.com") - at least one social URL required',
+      required: false,
+    },
+    {
+      name: 'twitterUrl',
+      description:
+        'Optional Twitter profile URL (e.g., "https://twitter.com/mytoken") - at least one social URL required',
+      required: false,
+    },
+    {
+      name: 'telegramUrl',
+      description:
+        'Optional Telegram channel URL (e.g., "https://t.me/mytoken") - at least one social URL required',
+      required: false,
+    },
+    {
+      name: 'imagePath',
+      description:
+        'Optional path to token image file - will be uploaded to IPFS (e.g., "/path/to/image.png")',
+      required: false,
+    },
+    {
+      name: 'preBuyGala',
+      description:
+        'Optional GALA amount for initial token purchase (e.g., "100" for 100 GALA) - helps bootstrap liquidity',
+      required: false,
+    },
+  ],
+  handler: (args) => {
+    // Validate inputs
+    validateTokenName(args.tokenName);
+    validateTokenSymbol(args.tokenSymbol);
+
+    // Validate at least one social URL
+    const hasSocialUrl = args.websiteUrl || args.twitterUrl || args.telegramUrl;
+    if (!hasSocialUrl) {
+      throw new Error(
+        'At least one social URL is required: websiteUrl, twitterUrl, or telegramUrl'
+      );
+    }
+
+    // Validate social URLs if provided
+    if (args.websiteUrl) {
+      validateUrl(args.websiteUrl, 'websiteUrl');
+    }
+    if (args.twitterUrl) {
+      validateUrl(args.twitterUrl, 'twitterUrl');
+    }
+    if (args.telegramUrl) {
+      validateUrl(args.telegramUrl, 'telegramUrl');
+    }
+
+    // Validate pre-buy amount if provided
+    if (args.preBuyGala) {
+      validateNumericAmount(args.preBuyGala, 'preBuyGala');
+    }
+
+    return [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: createCreateTokenWorkflow({
+            tokenName: args.tokenName,
+            tokenSymbol: args.tokenSymbol,
+            description: args.description,
+            websiteUrl: args.websiteUrl,
+            twitterUrl: args.twitterUrl,
+            telegramUrl: args.telegramUrl,
+            imagePath: args.imagePath,
+            preBuyGala: args.preBuyGala,
+          }),
+        },
+      },
+    ];
+  },
+};
+
+/**
+ * Export all token creation prompts
+ */
+export const creationPrompts: MCPPrompt[] = [createTokenPrompt];