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

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/social.ts

@@ -0,0 +1,100 @@
+/**
+ * Social Interaction Prompts
+ *
+ * Slash commands for comments and social interactions
+ */
+
+import type { MCPPrompt } from '../types/mcp.js';
+import { MCP_TOOLS } from '../constants/mcpToolNames.js';
+import { validateTokenName } from '../utils/validation.js';
+
+/**
+ * Post Comment - Post comment on token
+ */
+export const postCommentPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:post-comment',
+  description: 'Post a comment on a token pool',
+  arguments: [
+    {
+      name: 'tokenName',
+      description: 'Token name (e.g., anime)',
+      required: true,
+    },
+    {
+      name: 'message',
+      description: 'Comment message (max 500 characters)',
+      required: true,
+    },
+  ],
+  handler: (args) => {
+    validateTokenName(args.tokenName);
+
+    return [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `Post comment on token pool.
+
+Token: ${args.tokenName}
+Message: ${args.message}
+
+Use ${MCP_TOOLS.POST_COMMENT} to post the comment.
+
+Display confirmation of successful comment posting.`,
+        },
+      },
+    ];
+  },
+};
+
+/**
+ * Fetch Comments - Get token comments
+ */
+export const fetchCommentsPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:fetch-comments',
+  description: 'Get comments for a token pool',
+  arguments: [
+    {
+      name: 'tokenName',
+      description: 'Token name (e.g., anime)',
+      required: true,
+    },
+    {
+      name: 'page',
+      description: 'Page number (default: 1)',
+      required: false,
+    },
+    {
+      name: 'limit',
+      description: 'Results per page (default: 20)',
+      required: false,
+    },
+  ],
+  handler: (args) => {
+    validateTokenName(args.tokenName);
+
+    return [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `Fetch comments for token pool.
+
+Token: ${args.tokenName}
+Page: ${args.page || 1}
+Limit: ${args.limit || 20}
+
+Use ${MCP_TOOLS.FETCH_COMMENTS} to retrieve comments.
+
+Display the comments with author information and timestamps.`,
+        },
+      },
+    ];
+  },
+};
+
+export const socialPrompts: MCPPrompt[] = [
+  postCommentPrompt,
+  fetchCommentsPrompt,
+];