@gala-chain/launchpad-mcp-server 1.22.0 → 1.22.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (73) hide show
  1. package/CHANGELOG.md +8 -0
  2. package/dist/generated/version.d.ts +1 -1
  3. package/dist/generated/version.js +1 -1
  4. package/package.json +2 -2
  5. package/docs/AI-AGENT-PATTERNS.md +0 -555
  6. package/docs/CONSTRAINTS-REFERENCE.md +0 -454
  7. package/docs/PROMPT-TOOL-MAPPING.md +0 -352
  8. package/docs/examples/default-values-pattern.md +0 -240
  9. package/docs/examples/tool-factory-pattern.md +0 -217
  10. package/jest.config.js +0 -94
  11. package/src/__tests__/integration/fetchTokenDetails.integration.test.ts +0 -258
  12. package/src/__tests__/integration/poolTools.integration.test.ts +0 -185
  13. package/src/constants/mcpToolNames.ts +0 -141
  14. package/src/index.ts +0 -19
  15. package/src/prompts/__tests__/promptStructure.test.ts +0 -137
  16. package/src/prompts/__tests__/registry.test.ts +0 -191
  17. package/src/prompts/analysis.ts +0 -429
  18. package/src/prompts/create-token.ts +0 -123
  19. package/src/prompts/dex-trading.ts +0 -86
  20. package/src/prompts/discover-tokens.ts +0 -86
  21. package/src/prompts/index.ts +0 -154
  22. package/src/prompts/liquidity-positions.ts +0 -270
  23. package/src/prompts/portfolio.ts +0 -242
  24. package/src/prompts/trading.ts +0 -191
  25. package/src/prompts/utility.ts +0 -43
  26. package/src/prompts/utils/workflowTemplates.ts +0 -511
  27. package/src/schemas/common-schemas.ts +0 -393
  28. package/src/scripts/test-all-prompts.ts +0 -184
  29. package/src/server.ts +0 -277
  30. package/src/tools/__tests__/dex-tools.test.ts +0 -562
  31. package/src/tools/__tests__/liquidity-positions.test.ts +0 -673
  32. package/src/tools/balance/index.ts +0 -174
  33. package/src/tools/creation/index.ts +0 -182
  34. package/src/tools/dex/index.ts +0 -226
  35. package/src/tools/dex/liquidity-positions.ts +0 -547
  36. package/src/tools/index.ts +0 -86
  37. package/src/tools/pools/fetchAllPools.ts +0 -47
  38. package/src/tools/pools/fetchAllPriceHistory.ts +0 -119
  39. package/src/tools/pools/fetchPoolDetails.ts +0 -27
  40. package/src/tools/pools/fetchPoolDetailsForCalculation.ts +0 -22
  41. package/src/tools/pools/fetchPools.ts +0 -47
  42. package/src/tools/pools/fetchPriceHistory.ts +0 -124
  43. package/src/tools/pools/fetchTokenDetails.ts +0 -77
  44. package/src/tools/pools/index.ts +0 -284
  45. package/src/tools/social/index.ts +0 -64
  46. package/src/tools/trading/index.ts +0 -605
  47. package/src/tools/transfers/index.ts +0 -75
  48. package/src/tools/utils/clearCache.ts +0 -36
  49. package/src/tools/utils/createWallet.ts +0 -19
  50. package/src/tools/utils/explainSdkUsage.ts +0 -1446
  51. package/src/tools/utils/getAddress.ts +0 -12
  52. package/src/tools/utils/getCacheInfo.ts +0 -14
  53. package/src/tools/utils/getConfig.ts +0 -11
  54. package/src/tools/utils/getEthereumAddress.ts +0 -12
  55. package/src/tools/utils/getUrlByTokenName.ts +0 -12
  56. package/src/tools/utils/getVersion.ts +0 -25
  57. package/src/tools/utils/getWallet.ts +0 -25
  58. package/src/tools/utils/hasWallet.ts +0 -15
  59. package/src/tools/utils/index.ts +0 -33
  60. package/src/tools/utils/isTokenGraduated.ts +0 -16
  61. package/src/tools/utils/setWallet.ts +0 -41
  62. package/src/types/mcp.ts +0 -72
  63. package/src/utils/__tests__/validation.test.ts +0 -147
  64. package/src/utils/constraints.ts +0 -155
  65. package/src/utils/default-values.ts +0 -208
  66. package/src/utils/error-handler.ts +0 -69
  67. package/src/utils/error-templates.ts +0 -273
  68. package/src/utils/response-formatter.ts +0 -51
  69. package/src/utils/tool-factory.ts +0 -257
  70. package/src/utils/tool-registry.ts +0 -296
  71. package/src/utils/validation.ts +0 -371
  72. package/tests/wallet-management-integration.test.ts +0 -284
  73. package/tsconfig.json +0 -23
@@ -1,242 +0,0 @@
1
- /**
2
- * Portfolio Prompts
3
- *
4
- * Slash commands for portfolio management on Gala Launchpad
5
- */
6
-
7
- import type { MCPPrompt } from '../types/mcp.js';
8
- import { MCP_TOOLS } from '../constants/mcpToolNames.js';
9
- import { createPortfolioWorkflow } from './utils/workflowTemplates.js';
10
- import { validateTokenName, validatePaginationLimit } from '../utils/validation.js';
11
-
12
- /**
13
- * Portfolio - Complete portfolio analysis
14
- */
15
- export const portfolioPrompt: MCPPrompt = {
16
- name: 'galachain-launchpad:portfolio',
17
- description: 'Analyze complete portfolio with GALA balance, token holdings, and total USD value',
18
- handler: () => [
19
- {
20
- role: 'user',
21
- content: {
22
- type: 'text',
23
- text: createPortfolioWorkflow(),
24
- },
25
- },
26
- ],
27
- };
28
-
29
- /**
30
- * Tokens Held - List all token holdings
31
- */
32
- export const tokensHeldPrompt: MCPPrompt = {
33
- name: 'galachain-launchpad:tokens-held',
34
- description: 'List all Launchpad tokens currently held with balances',
35
- arguments: [
36
- {
37
- name: 'search',
38
- description: 'Optional search filter for token names (fuzzy match)',
39
- required: false,
40
- },
41
- {
42
- name: 'limit',
43
- description: 'Number of tokens to show (default: 20)',
44
- required: false,
45
- },
46
- ],
47
- handler: (args) => {
48
- // Validate inputs
49
- if (args.limit) {
50
- validatePaginationLimit(args.limit, 100);
51
- }
52
-
53
- const limit = args.limit || '20';
54
- const searchFilter = args.search
55
- ? `- search: "${args.search}" (fuzzy match filter)`
56
- : '- No search filter (show all tokens)';
57
-
58
- return [
59
- {
60
- role: 'user',
61
- content: {
62
- type: 'text',
63
- text: `Show me all Launchpad tokens I'm currently holding:
64
-
65
- Use ${MCP_TOOLS.FETCH_TOKENS_HELD} with:
66
- ${searchFilter}
67
- - limit: ${limit}
68
-
69
- For each token, display:
70
- - Token name
71
- - Balance (formatted with decimals)
72
- - Whether I created this token (if applicable)
73
-
74
- Sort by balance (highest to lowest).
75
-
76
- If I have more tokens than the limit, show pagination info and offer to fetch more.`,
77
- },
78
- },
79
- ];
80
- },
81
- };
82
-
83
- /**
84
- * Tokens Created - Show tokens created by user
85
- */
86
- export const tokensCreatedPrompt: MCPPrompt = {
87
- name: 'galachain-launchpad:tokens-created',
88
- description: 'List all Launchpad tokens created by the user with their current status',
89
- arguments: [
90
- {
91
- name: 'search',
92
- description: 'Optional search filter for token names (fuzzy match)',
93
- required: false,
94
- },
95
- {
96
- name: 'limit',
97
- description: 'Number of tokens to show (default: 20)',
98
- required: false,
99
- },
100
- ],
101
- handler: (args) => {
102
- // Validate inputs
103
- if (args.limit) {
104
- validatePaginationLimit(args.limit, 100);
105
- }
106
-
107
- const limit = args.limit || '20';
108
- const searchFilter = args.search
109
- ? `- search: "${args.search}" (fuzzy match filter)`
110
- : '- No search filter (show all tokens)';
111
-
112
- return [
113
- {
114
- role: 'user',
115
- content: {
116
- type: 'text',
117
- text: `Show me all Launchpad tokens I've created:
118
-
119
- Use ${MCP_TOOLS.FETCH_TOKENS_CREATED} with:
120
- ${searchFilter}
121
- - limit: ${limit}
122
-
123
- For each token, display:
124
- - Token name and symbol
125
- - Current status (check using ${MCP_TOOLS.FETCH_POOL_DETAILS}):
126
- * Pool status (Ongoing/Completed)
127
- * Current supply
128
- * Remaining tokens
129
- * Progress percentage
130
- - Whether graduated (use ${MCP_TOOLS.IS_TOKEN_GRADUATED})
131
- - Frontend URL (use ${MCP_TOOLS.GET_URL_BY_TOKEN_NAME})
132
-
133
- Provide a summary:
134
- - Total tokens created
135
- - How many are graduated
136
- - How many are still in bonding curve phase`,
137
- },
138
- },
139
- ];
140
- },
141
- };
142
-
143
- /**
144
- * Balance - Check GALA and specific token balances
145
- */
146
- export const balancePrompt: MCPPrompt = {
147
- name: 'galachain-launchpad:balance',
148
- description: 'Check GALA balance and optionally a specific token balance',
149
- arguments: [
150
- {
151
- name: 'tokenName',
152
- description: 'Optional token name to check balance for (e.g., anime)',
153
- required: false,
154
- },
155
- ],
156
- handler: (args) => {
157
- // Validate inputs
158
- if (args.tokenName) {
159
- validateTokenName(args.tokenName);
160
- }
161
-
162
- return [
163
- {
164
- role: 'user',
165
- content: {
166
- type: 'text',
167
- text: args.tokenName
168
- ? `Check my balances:
169
-
170
- 1. GALA balance using ${MCP_TOOLS.FETCH_GALA_BALANCE}
171
- 2. ${args.tokenName} token balance using ${MCP_TOOLS.FETCH_TOKEN_BALANCE}
172
- 3. Calculate USD values:
173
- - GALA USD value using ${MCP_TOOLS.FETCH_GALA_SPOT_PRICE}
174
- - ${args.tokenName} USD value using ${MCP_TOOLS.FETCH_LAUNCHPAD_TOKEN_SPOT_PRICE}
175
-
176
- Display:
177
- - GALA: [amount] ($[USD value])
178
- - ${args.tokenName}: [amount] ($[USD value])
179
- - Total value: $[combined USD value]`
180
- : `Check my GALA balance:
181
-
182
- Use ${MCP_TOOLS.FETCH_GALA_BALANCE} to get current GALA balance.
183
- Use ${MCP_TOOLS.FETCH_GALA_SPOT_PRICE} to calculate USD value.
184
-
185
- Display:
186
- - GALA: [amount]
187
- - USD value: $[calculated value]
188
-
189
- Tip: Add tokenName argument to check a specific token balance.`,
190
- },
191
- },
192
- ];
193
- },
194
- };
195
-
196
- /**
197
- * Profile - Show user profile information
198
- */
199
- export const profilePrompt: MCPPrompt = {
200
- name: 'galachain-launchpad:profile',
201
- description: 'Show user profile information and activity summary',
202
- handler: () => [
203
- {
204
- role: 'user',
205
- content: {
206
- type: 'text',
207
- text: `Show my Gala Launchpad profile:
208
-
209
- 1. Get profile info using ${MCP_TOOLS.FETCH_PROFILE}
210
- - Full name
211
- - Profile image URL
212
- - Wallet address
213
-
214
- 2. Get activity summary:
215
- - Tokens held count: ${MCP_TOOLS.FETCH_TOKENS_HELD} (limit: 1) for total
216
- - Tokens created count: ${MCP_TOOLS.FETCH_TOKENS_CREATED} (limit: 1) for total
217
-
218
- 3. Get wallet info:
219
- - GalaChain address format: ${MCP_TOOLS.GET_ADDRESS}
220
- - Ethereum address format: ${MCP_TOOLS.GET_ETHEREUM_ADDRESS}
221
- - GALA balance: ${MCP_TOOLS.FETCH_GALA_BALANCE}
222
-
223
- Display:
224
- - Profile details
225
- - Activity metrics
226
- - Wallet addresses
227
- - Current balance`,
228
- },
229
- },
230
- ],
231
- };
232
-
233
- /**
234
- * Export all portfolio prompts
235
- */
236
- export const portfolioPrompts: MCPPrompt[] = [
237
- portfolioPrompt,
238
- tokensHeldPrompt,
239
- tokensCreatedPrompt,
240
- balancePrompt,
241
- profilePrompt,
242
- ];
@@ -1,191 +0,0 @@
1
- /**
2
- * Trading Prompts
3
- *
4
- * Slash commands for trading operations on Gala Launchpad
5
- */
6
-
7
- import type { MCPPrompt } from '../types/mcp.js';
8
- import {
9
- createTradingWorkflow,
10
- createAnalysisWorkflow,
11
- } from './utils/workflowTemplates.js';
12
- import { validateTokenName, validateNumericAmount, validateSlippage } from '../utils/validation.js';
13
-
14
- /**
15
- * Analyze Token - Complete token analysis workflow
16
- */
17
- export const analyzeTokenPrompt: MCPPrompt = {
18
- name: 'galachain-launchpad:analyze-token',
19
- description:
20
- 'Perform comprehensive analysis of a Launchpad token including pool details, spot price, and graduation cost',
21
- arguments: [
22
- {
23
- name: 'tokenName',
24
- description: 'Token name to analyze (e.g., anime, test216253)',
25
- required: true,
26
- },
27
- ],
28
- handler: (args) => {
29
- // Validate inputs
30
- validateTokenName(args.tokenName);
31
-
32
- return [
33
- {
34
- role: 'user',
35
- content: {
36
- type: 'text',
37
- text: createAnalysisWorkflow(args.tokenName),
38
- },
39
- },
40
- ];
41
- },
42
- };
43
-
44
- /**
45
- * Buy Tokens - Guided token purchase workflow
46
- */
47
- export const buyTokensPrompt: MCPPrompt = {
48
- name: 'galachain-launchpad:buy-tokens',
49
- description: 'Guide user through buying tokens with slippage protection and cost breakdown',
50
- arguments: [
51
- {
52
- name: 'tokenName',
53
- description: 'Token to buy (e.g., anime)',
54
- required: true,
55
- },
56
- {
57
- name: 'galaAmount',
58
- description: 'GALA amount to spend (e.g., 100)',
59
- required: true,
60
- },
61
- {
62
- name: 'slippage',
63
- description: 'Slippage tolerance percentage (default: 1)',
64
- required: false,
65
- },
66
- ],
67
- handler: (args) => {
68
- // Validate inputs
69
- validateTokenName(args.tokenName);
70
- validateNumericAmount(args.galaAmount, 'galaAmount');
71
- if (args.slippage) {
72
- validateSlippage(args.slippage);
73
- }
74
-
75
- return [
76
- {
77
- role: 'user',
78
- content: {
79
- type: 'text',
80
- text: createTradingWorkflow({
81
- operation: 'buy',
82
- tokenName: args.tokenName,
83
- amount: args.galaAmount,
84
- amountType: 'gala',
85
- slippage: args.slippage || '1',
86
- }),
87
- },
88
- },
89
- ];
90
- },
91
- };
92
-
93
- /**
94
- * Sell Tokens - Guided token sale workflow
95
- */
96
- export const sellTokensPrompt: MCPPrompt = {
97
- name: 'galachain-launchpad:sell-tokens',
98
- description: 'Guide user through selling tokens with slippage protection',
99
- arguments: [
100
- {
101
- name: 'tokenName',
102
- description: 'Token to sell (e.g., anime)',
103
- required: true,
104
- },
105
- {
106
- name: 'tokenAmount',
107
- description: 'Token amount to sell (e.g., 1000)',
108
- required: true,
109
- },
110
- {
111
- name: 'slippage',
112
- description: 'Slippage tolerance percentage (default: 1)',
113
- required: false,
114
- },
115
- ],
116
- handler: (args) => {
117
- // Validate inputs
118
- validateTokenName(args.tokenName);
119
- validateNumericAmount(args.tokenAmount, 'tokenAmount');
120
- if (args.slippage) {
121
- validateSlippage(args.slippage);
122
- }
123
-
124
- return [
125
- {
126
- role: 'user',
127
- content: {
128
- type: 'text',
129
- text: createTradingWorkflow({
130
- operation: 'sell',
131
- tokenName: args.tokenName,
132
- amount: args.tokenAmount,
133
- slippage: args.slippage || '1',
134
- }),
135
- },
136
- },
137
- ];
138
- },
139
- };
140
-
141
- /**
142
- * Graduate Token - One-step graduation workflow
143
- */
144
- export const graduateTokenPrompt: MCPPrompt = {
145
- name: 'galachain-launchpad:graduate-token',
146
- description:
147
- 'Graduate a bonding curve pool by buying all remaining tokens in one transaction',
148
- arguments: [
149
- {
150
- name: 'tokenName',
151
- description: 'Token to graduate (e.g., anime)',
152
- required: true,
153
- },
154
- {
155
- name: 'slippage',
156
- description: 'Slippage tolerance percentage (default: 1)',
157
- required: false,
158
- },
159
- ],
160
- handler: (args) => {
161
- // Validate inputs
162
- validateTokenName(args.tokenName);
163
- if (args.slippage) {
164
- validateSlippage(args.slippage);
165
- }
166
-
167
- return [
168
- {
169
- role: 'user',
170
- content: {
171
- type: 'text',
172
- text: createTradingWorkflow({
173
- operation: 'graduate',
174
- tokenName: args.tokenName,
175
- slippage: args.slippage || '1',
176
- }),
177
- },
178
- },
179
- ];
180
- },
181
- };
182
-
183
- /**
184
- * Export all trading prompts
185
- */
186
- export const tradingPrompts: MCPPrompt[] = [
187
- analyzeTokenPrompt,
188
- buyTokensPrompt,
189
- sellTokensPrompt,
190
- graduateTokenPrompt,
191
- ];
@@ -1,43 +0,0 @@
1
- /**
2
- * Utility Prompts
3
- *
4
- * Slash commands for utility and information operations on Gala Launchpad
5
- */
6
-
7
- import type { MCPPrompt } from '../types/mcp.js';
8
-
9
- /**
10
- * Get Version - Display SDK and MCP server version information
11
- *
12
- * Shows the current versions of both the Gala Launchpad SDK and the MCP server,
13
- * useful for debugging version mismatch issues or verifying installed versions.
14
- */
15
- export const getVersionPrompt: MCPPrompt = {
16
- name: 'galachain-launchpad:version',
17
- description: 'Get SDK and MCP server version information',
18
- handler: () => {
19
- return [
20
- {
21
- role: 'user',
22
- content: {
23
- type: 'text',
24
- text: `Get version information for the Gala Launchpad SDK and MCP server.
25
-
26
- Use the gala_launchpad_get_version tool to fetch the version details.
27
-
28
- Display the results in a clear, formatted response showing:
29
- 1. SDK Version
30
- 2. MCP Server Version
31
- 3. Timestamp
32
-
33
- This is helpful for debugging version compatibility issues or confirming installed versions.`,
34
- },
35
- },
36
- ];
37
- },
38
- };
39
-
40
- /**
41
- * All utility prompts
42
- */
43
- export const utilityPrompts: MCPPrompt[] = [getVersionPrompt];