@gala-chain/launchpad-mcp-server 1.12.3 → 1.12.4

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 (62) hide show
  1. package/CHANGELOG.md +39 -0
  2. package/README.md +63 -1
  3. package/dist/generated/version.d.ts +1 -1
  4. package/dist/generated/version.js +1 -1
  5. package/package.json +2 -2
  6. package/docs/AI-AGENT-PATTERNS.md +0 -555
  7. package/docs/CONSTRAINTS-REFERENCE.md +0 -454
  8. package/docs/PROMPT-TOOL-MAPPING.md +0 -352
  9. package/docs/examples/default-values-pattern.md +0 -240
  10. package/docs/examples/tool-factory-pattern.md +0 -217
  11. package/jest.config.js +0 -94
  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 -114
  16. package/src/prompts/__tests__/registry.test.ts +0 -143
  17. package/src/prompts/analysis.ts +0 -429
  18. package/src/prompts/index.ts +0 -127
  19. package/src/prompts/portfolio.ts +0 -242
  20. package/src/prompts/trading.ts +0 -191
  21. package/src/prompts/utility.ts +0 -43
  22. package/src/prompts/utils/workflowTemplates.ts +0 -344
  23. package/src/schemas/common-schemas.ts +0 -392
  24. package/src/scripts/test-all-prompts.ts +0 -184
  25. package/src/server.ts +0 -247
  26. package/src/tools/balance/index.ts +0 -174
  27. package/src/tools/creation/index.ts +0 -182
  28. package/src/tools/index.ts +0 -80
  29. package/src/tools/pools/fetchAllPools.ts +0 -47
  30. package/src/tools/pools/fetchAllPriceHistory.ts +0 -101
  31. package/src/tools/pools/fetchAllPrices.ts +0 -39
  32. package/src/tools/pools/fetchPoolDetails.ts +0 -27
  33. package/src/tools/pools/fetchPoolDetailsForCalculation.ts +0 -22
  34. package/src/tools/pools/fetchPools.ts +0 -47
  35. package/src/tools/pools/fetchPriceHistory.ts +0 -106
  36. package/src/tools/pools/fetchPrices.ts +0 -52
  37. package/src/tools/pools/index.ts +0 -248
  38. package/src/tools/social/index.ts +0 -64
  39. package/src/tools/trading/index.ts +0 -605
  40. package/src/tools/transfers/index.ts +0 -75
  41. package/src/tools/utils/clearCache.ts +0 -36
  42. package/src/tools/utils/createWallet.ts +0 -19
  43. package/src/tools/utils/explainSdkUsage.ts +0 -853
  44. package/src/tools/utils/getAddress.ts +0 -12
  45. package/src/tools/utils/getCacheInfo.ts +0 -14
  46. package/src/tools/utils/getConfig.ts +0 -11
  47. package/src/tools/utils/getEthereumAddress.ts +0 -12
  48. package/src/tools/utils/getUrlByTokenName.ts +0 -12
  49. package/src/tools/utils/getVersion.ts +0 -25
  50. package/src/tools/utils/index.ts +0 -27
  51. package/src/tools/utils/isTokenGraduated.ts +0 -16
  52. package/src/types/mcp.ts +0 -72
  53. package/src/utils/__tests__/validation.test.ts +0 -147
  54. package/src/utils/constraints.ts +0 -146
  55. package/src/utils/default-values.ts +0 -208
  56. package/src/utils/error-handler.ts +0 -69
  57. package/src/utils/error-templates.ts +0 -273
  58. package/src/utils/response-formatter.ts +0 -51
  59. package/src/utils/tool-factory.ts +0 -257
  60. package/src/utils/tool-registry.ts +0 -296
  61. package/src/utils/validation.ts +0 -336
  62. package/tsconfig.json +0 -23
package/CHANGELOG.md CHANGED
@@ -1,5 +1,44 @@
1
1
  # Changelog
2
2
 
3
+ ## 1.12.4
4
+
5
+ ### Patch Changes
6
+
7
+ - docs: comprehensive documentation updates for price history methods
8
+
9
+ ### SDK Documentation Updates
10
+ - Added complete documentation for all 4 price history methods in README.md
11
+ - fetchPriceHistory (paginated)
12
+ - fetchAllPriceHistory (auto-paginated)
13
+ - fetchPrices (paginated latest prices)
14
+ - fetchAllPrices (auto-paginated latest prices)
15
+ - Added comprehensive examples showing usage patterns, configuration, and workflows
16
+ - Updated MySQL configuration section with code examples for all 4 methods
17
+ - Added price history patterns documentation to CLAUDE.md
18
+ - Added latest token price queries section to CLAUDE.md with detailed examples
19
+ - Created comprehensive fetch-all-price-history-demo.ts example script
20
+ - Demonstrates statistical analysis, trend calculation, moving averages
21
+ - Shows CSV export, time period comparison, and multi-token analysis
22
+ - Includes volatility calculation and price statistics
23
+
24
+ ### MCP Server Documentation Updates
25
+ - Updated tool count from 52 to 55 in README (includes 4 price history tools)
26
+ - Added "Price History & Analysis" section documenting 4 price history tools
27
+ - Updated MCP installation version references (1.12.3, SDK 3.15.3)
28
+ - Added complete price history tool descriptions with use cases and examples
29
+
30
+ ### Agent Documentation Updates
31
+ - Updated @agent-galachain-launchpad-developer.md
32
+ - Updated SDK method count: 46 → 50 (includes price history)
33
+ - Updated MCP tool count: 51 → 55 (includes 4 price history tools)
34
+ - Updated version references: v3.11.0+ → v3.15.3+
35
+ - Added "Price History & Analysis" section to Complete Method Reference
36
+ - Updated service architecture to include PriceHistoryService
37
+ - Updated support section with latest version information
38
+
39
+ - Updated dependencies
40
+ - @gala-chain/launchpad-sdk@3.15.4
41
+
3
42
  ## 1.12.3
4
43
 
5
44
  ### Patch Changes
package/README.md CHANGED
@@ -4,7 +4,7 @@ MCP (Model Context Protocol) server for Gala Launchpad SDK - Enables AI agents t
4
4
 
5
5
  ## 🚀 Features
6
6
 
7
- - **52 AI-accessible tools** for complete Gala Launchpad integration
7
+ - **55 AI-accessible tools** for complete Gala Launchpad integration (includes 4 price history tools)
8
8
  - **14 slash commands** (prompts) for quick access to common workflows
9
9
  - **Type-safe** - Full TypeScript support with validated inputs
10
10
  - **Production-ready** - Built on [@gala-chain/launchpad-sdk ](https://www.npmjs.com/package/@gala-chain/launchpad-sdk)
@@ -252,6 +252,68 @@ Ask Claude:
252
252
 
253
253
  > "Show me GALA token price history from the last 7 days with daily snapshots"
254
254
 
255
+ ---
256
+
257
+ #### 📊 All Historical Price Data (Auto-Paginated)
258
+
259
+ **`gala_launchpad_fetch_all_price_history`** - Fetch all historical price snapshots (auto-paginated)
260
+
261
+ Automatically fetches all pages of historical price data and returns complete dataset in single result.
262
+
263
+ **Use Cases:**
264
+ - Complete volatility analysis
265
+ - Full historical trend analysis
266
+ - Statistical calculations on entire dataset
267
+ - Data export for backtesting
268
+
269
+ **Example:**
270
+
271
+ Ask Claude:
272
+
273
+ > "Get all price history for GUSDC token from January 2024 and calculate volatility"
274
+
275
+ ---
276
+
277
+ #### 💰 Latest Token Prices
278
+
279
+ **`gala_launchpad_fetch_prices`** - Fetch latest prices for all tokens (paginated)
280
+
281
+ Returns the most recent price snapshot for each unique token in the database.
282
+
283
+ **Use Cases:**
284
+ - Market overview dashboards
285
+ - Price comparison across tokens
286
+ - Real-time price monitoring
287
+ - Market statistics
288
+
289
+ **Example:**
290
+
291
+ Ask Claude:
292
+
293
+ > "Fetch the latest prices for the top 20 most expensive tokens"
294
+
295
+ > "Show me all token prices sorted alphabetically"
296
+
297
+ ---
298
+
299
+ **`gala_launchpad_fetch_all_prices`** - Fetch all latest prices (auto-paginated)
300
+
301
+ Convenience method that automatically paginates through all tokens and returns all latest prices.
302
+
303
+ **Use Cases:**
304
+ - Complete market analysis
305
+ - Market-wide statistics and calculations
306
+ - Price monitoring across all tokens
307
+ - Data export for analysis tools
308
+
309
+ **Example:**
310
+
311
+ Ask Claude:
312
+
313
+ > "Get all latest token prices and tell me the average price across all tokens"
314
+
315
+ > "Show me the most and least expensive tokens right now"
316
+
255
317
  ### Balance & Portfolio (6 tools)
256
318
  - `gala_launchpad_fetch_gala_balance` - Get GALA balance
257
319
  - `gala_launchpad_fetch_token_balance` - Get token balance
@@ -3,5 +3,5 @@
3
3
  * This file is generated by scripts/inject-version.ts during build
4
4
  * DO NOT EDIT MANUALLY
5
5
  */
6
- export declare const MCP_SERVER_VERSION = "1.12.3";
6
+ export declare const MCP_SERVER_VERSION = "1.12.4";
7
7
  //# sourceMappingURL=version.d.ts.map
@@ -6,5 +6,5 @@
6
6
  */
7
7
  Object.defineProperty(exports, "__esModule", { value: true });
8
8
  exports.MCP_SERVER_VERSION = void 0;
9
- exports.MCP_SERVER_VERSION = '1.12.3';
9
+ exports.MCP_SERVER_VERSION = '1.12.4';
10
10
  //# sourceMappingURL=version.js.map
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@gala-chain/launchpad-mcp-server",
3
- "version": "1.12.3",
3
+ "version": "1.12.4",
4
4
  "description": "MCP server for Gala Launchpad SDK with 55 tools + 14 slash commands - Production-grade AI agent integration with comprehensive validation, optimized performance, and 80%+ test coverage",
5
5
  "main": "dist/index.js",
6
6
  "bin": {
@@ -64,7 +64,7 @@
64
64
  "dependencies": {
65
65
  "@gala-chain/api": "^2.4.3",
66
66
  "@gala-chain/connect": "^2.4.3",
67
- "@gala-chain/launchpad-sdk": "^3.15.3",
67
+ "@gala-chain/launchpad-sdk": "^3.15.4",
68
68
  "@modelcontextprotocol/sdk": "^0.5.0",
69
69
  "axios": "^1.12.2",
70
70
  "bignumber.js": "^9.1.2",