@gala-chain/launchpad-mcp-server 1.14.2 → 1.15.0

package/CHANGELOG.md

@@ -1,5 +1,123 @@
 # Changelog
 
+## 1.15.0
+
+### Minor Changes
+
+- Add tokenName parameter support to fetchPriceHistory and fetchAllPriceHistory (v3.20.0+)
+
+  **Features:**
+  - New optional `tokenName` parameter enables simple token names (e.g., "demonkpop") with automatic
+    resolution to full tokenId
+  - Mutual exclusivity validation: use exactly one of `tokenName` OR `tokenId` (not both, not
+    neither)
+  - Full backward compatibility with existing tokenId parameter usage (string and object formats)
+  - New helper method `fetchTokenClassKeyByTokenName()` for token name resolution
+  - Enhanced JSDoc with comprehensive examples for all three token identification methods
+
+  **SDK Changes:**
+  - `PriceHistoryService`: Added tokenName parameter support with auto-resolution via
+    TokenResolverService
+  - `LaunchpadSDK`: Wired TokenResolverService to PriceHistoryService for automatic name resolution
+  - Updated type definitions with optional `tokenName?: string` parameter
+  - Added comprehensive validation for mutual exclusivity
+
+  **MCP Server Changes:**
+  - `gala_launchpad_fetch_price_history`: Updated schema to support optional tokenName parameter
+  - `gala_launchpad_fetch_all_price_history`: Updated schema to support optional tokenName parameter
+  - Both tools now accept flexible token identification (tokenName or tokenId, choose one)
+
+  **Documentation:**
+  - Updated SDK README with new usage patterns and examples
+  - Updated CLAUDE.md Price History Patterns section
+  - Added complete section in complete-sdk-demo.ts demonstrating tokenName parameter
+  - Enhanced JSDoc comments for all methods with practical examples
+
+  **Testing:**
+  - Added 33 comprehensive unit tests covering:
+    - Token name to token class key resolution
+    - Mutual exclusivity validation
+    - Error handling for invalid inputs
+    - Integration with both fetchPriceHistory and fetchAllPriceHistory
+    - All test suites passing (1102 total tests)
+
+  **Breaking Changes:** None - fully backward compatible
+
+  **Migration Guide:** Instead of: `sdk.fetchPriceHistory({ tokenId: 'Token|Unit|DKP|eth:...' })`
+  You can now use: `sdk.fetchPriceHistory({ tokenName: 'demonkpop' })`
+
+### Patch Changes
+
+- Fix token format conversion and add DEX spot pricing for graduated launchpad tokens
+
+  **Bug Fixes:**
+  - **CRITICAL**: Fixed PriceHistoryService token format conversion that was losing Ethereum
+    addresses for launchpad tokens
+    - Was converting: `Token|Unit|GDOG|eth:902...` → `GDOG$Unit$none$none` ❌
+    - Now converts: `Token|Unit|GDOG|eth:902...` → `Token$Unit$GDOG$eth:902...` ✅
+    - Impact: All launchpad token price history queries now return data instead of empty results
+    - Affected methods: `fetchPriceHistory()`, `fetchAllPriceHistory()`
+  - Updated test expectations in `price-history-service.test.ts` to validate correct token format
+    - All 1,102 unit tests passing
+
+  **Features:**
+  - New method `DexService.fetchDexTokenSpotPrice(tokenId)` for real-time DEX market prices
+    - Uses `/v1/trade/price` endpoint for accurate graduated token pricing
+    - Supports both pipe-delimited and object token ID formats
+    - Perfect for tokens trading on the DEX post-graduation
+  - Enhanced `fetchLaunchpadTokenSpotPrice()` to intelligently select price source:
+    - Active pool tokens: Uses bonding curve calculation
+    - Graduated tokens: Uses `/v1/trade/price` endpoint for real DEX market prices
+    - Optional `fetchPoolDetails` parameter enables automatic graduation detection
+    - Gracefully falls back to bonding curve if graduation check unavailable
+
+  **SDK Changes:**
+  - `PriceHistoryService.ts`: Fixed token format converter to use `pipeFormatToDollarFormat()`
+    utility
+  - `DexService.ts`: Added `fetchDexTokenSpotPrice()` method with full documentation
+  - `DexService.ts`: Enhanced `fetchLaunchpadTokenSpotPrice()` with graduation detection
+  - Added import of `pipeFormatToDollarFormat` to DexService
+
+  **Test Results:**
+  - All price history service tests passing (33 tests)
+  - All SDK tests passing (1102 total tests)
+  - No regressions detected
+
+  **Breaking Changes:** None - both are enhancements/bug fixes
+
+  **Example Usage (Graduated Token):**
+
+  ```typescript
+  // Graduated token now returns real DEX market price
+  const price = await sdk.fetchLaunchpadTokenSpotPrice(
+    'galadog',
+    calculateBuyAmount,
+    fetchPoolDetails // Optional - enables automatic DEX pricing
+  );
+  // Returns: { symbol: 'GALADOG', price: 0.019110 } (real market price)
+  ```
+
+  **Example Usage (Direct DEX Pricing):**
+
+  ```typescript
+  // Query DEX directly for any trading token
+  const price = await dexService.fetchDexTokenSpotPrice(
+    'Token|Unit|GDOG|eth:902Ef7566c8A8bEe5517FdEC0D7b5d1157942830'
+  );
+  // Returns: { symbol: 'GDOG', price: 0.019110 }
+  ```
+
+- Updated dependencies
+- Updated dependencies
+  - @gala-chain/launchpad-sdk@3.20.0
+
+## 1.14.3
+
+### Patch Changes
+
+- fix: correct fetchPools tool enum values to match SDK (recent/popular instead of
+  recent/trending/user)
+
 ## 1.14.2
 
 ### Patch Changes

package/dist/generated/version.d.ts

@@ -3,5 +3,5 @@
  * This file is generated by scripts/inject-version.ts during build
  * DO NOT EDIT MANUALLY
  */
-export declare const MCP_SERVER_VERSION = "1.14.2";
+export declare const MCP_SERVER_VERSION = "1.15.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/generated/version.js

@@ -6,5 +6,5 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MCP_SERVER_VERSION = void 0;
-exports.MCP_SERVER_VERSION = '1.14.2';
+exports.MCP_SERVER_VERSION = '1.15.0';
 //# sourceMappingURL=version.js.map

package/dist/tools/pools/fetchAllPriceHistory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetchAllPriceHistory.d.ts","sourceRoot":"","sources":["../../../src/tools/pools/fetchAllPriceHistory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAIlD,eAAO,MAAM,wBAAwB,EAAE,OA2FtC,CAAC"}
+{"version":3,"file":"fetchAllPriceHistory.d.ts","sourceRoot":"","sources":["../../../src/tools/pools/fetchAllPriceHistory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAIlD,eAAO,MAAM,wBAAwB,EAAE,OA2GtC,CAAC"}

package/dist/tools/pools/fetchAllPriceHistory.js

@@ -18,7 +18,12 @@ exports.fetchAllPriceHistoryTool = {
 **Requirements:**
 - DEX Backend API must be configured (dexBackendBaseUrl in SDK config)
 - Node.js environment only (not available in browser)
-- Token parameter is required
+- Either tokenName OR tokenId is required (not both)
+
+**Token Identification:**
+- Use \`tokenName\` for convenience (e.g., "demonkpop") - automatically resolved to full token ID
+- Use \`tokenId\` for direct specification (e.g., "Token|Unit|DKP|eth:...")
+- Provide exactly ONE of these parameters
 
 **Use Cases:**
 - Complete historical price analysis and charting
@@ -30,6 +35,10 @@ exports.fetchAllPriceHistoryTool = {
     inputSchema: {
         type: 'object',
         properties: {
+            tokenName: {
+                type: 'string',
+                description: 'Simple token name for convenience (e.g., "demonkpop", "shoewars") - automatically resolves to full token ID. Use this OR tokenId, not both.',
+            },
             tokenId: {
                 oneOf: [
                     {
@@ -60,7 +69,7 @@ exports.fetchAllPriceHistoryTool = {
                         description: 'TokenClassKey object format',
                     },
                 ],
-                description: 'Token identifier (string or TokenClassKey object)',
+                description: 'Token identifier (string or TokenClassKey object). Use this OR tokenName, not both.',
             },
             from: {
                 type: 'string',
@@ -78,14 +87,20 @@ exports.fetchAllPriceHistoryTool = {
                 description: 'Sort order for results (default: DESC for newest-first)',
             },
         },
-        required: ['tokenId'],
+        required: [],
     },
     handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
         // Convert string dates to Date objects if provided
         const options = {
-            tokenId: args.tokenId,
             sortOrder: args.sortOrder,
         };
+        // Support both tokenName and tokenId (mutual exclusivity validation happens in SDK)
+        if (args.tokenName) {
+            options.tokenName = args.tokenName;
+        }
+        else {
+            options.tokenId = args.tokenId;
+        }
         if (args.from) {
             options.from = new Date(args.from);
         }

package/dist/tools/pools/fetchAllPriceHistory.js.map

@@ -1 +1 @@
-{"version":3,"file":"fetchAllPriceHistory.js","sourceRoot":"","sources":["../../../src/tools/pools/fetchAllPriceHistory.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAGH,6EAAkE;AAClE,mEAAiE;AAEpD,QAAA,wBAAwB,GAAY;IAC/C,IAAI,EAAE,wCAAwC;IAC9C,WAAW,EAAE;;;;;;;;;;;;;;;oHAeqG;IAElH,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,KAAK,EAAE;oBACL;wBACE,IAAI,EAAE,QAAQ;wBACd,WAAW,EACT,oGAAoG;qBACvG;oBACD;wBACE,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,UAAU,EAAE;gCACV,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,kCAAkC;6BAChD;4BACD,QAAQ,EAAE;gCACR,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,+BAA+B;6BAC7C;4BACD,IAAI,EAAE;gCACJ,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,4BAA4B;6BAC1C;4BACD,aAAa,EAAE;gCACb,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,oCAAoC;6BAClD;yBACF;wBACD,QAAQ,EAAE,CAAC,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,CAAC;wBAC7D,WAAW,EAAE,6BAA6B;qBAC3C;iBACF;gBACD,WAAW,EAAE,mDAAmD;aACjE;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,MAAM,EAAE,WAAW;gBACnB,WAAW,EAAE,qEAAqE;aACnF;YACD,EAAE,EAAE;gBACF,IAAI,EAAE,QAAQ;gBACd,MAAM,EAAE,WAAW;gBACnB,WAAW,EAAE,2DAA2D;aACzE;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;gBACrB,WAAW,EAAE,yDAAyD;aACvE;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;IAED,OAAO,EAAE,IAAA,oCAAiB,EAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC7C,mDAAmD;QACnD,MAAM,OAAO,GAAQ;YACnB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC;QAEF,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;QACD,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACZ,OAAO,CAAC,EAAE,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjC,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;QACvD,OAAO,IAAA,qCAAa,EAAC,MAAM,CAAC,CAAC;IAC/B,CAAC,CAAC;CACH,CAAC"}
+{"version":3,"file":"fetchAllPriceHistory.js","sourceRoot":"","sources":["../../../src/tools/pools/fetchAllPriceHistory.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAGH,6EAAkE;AAClE,mEAAiE;AAEpD,QAAA,wBAAwB,GAAY;IAC/C,IAAI,EAAE,wCAAwC;IAC9C,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;oHAoBqG;IAElH,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,6IAA6I;aAChJ;YACD,OAAO,EAAE;gBACP,KAAK,EAAE;oBACL;wBACE,IAAI,EAAE,QAAQ;wBACd,WAAW,EACT,oGAAoG;qBACvG;oBACD;wBACE,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,UAAU,EAAE;gCACV,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,kCAAkC;6BAChD;4BACD,QAAQ,EAAE;gCACR,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,+BAA+B;6BAC7C;4BACD,IAAI,EAAE;gCACJ,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,4BAA4B;6BAC1C;4BACD,aAAa,EAAE;gCACb,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,oCAAoC;6BAClD;yBACF;wBACD,QAAQ,EAAE,CAAC,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,CAAC;wBAC7D,WAAW,EAAE,6BAA6B;qBAC3C;iBACF;gBACD,WAAW,EAAE,qFAAqF;aACnG;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,MAAM,EAAE,WAAW;gBACnB,WAAW,EAAE,qEAAqE;aACnF;YACD,EAAE,EAAE;gBACF,IAAI,EAAE,QAAQ;gBACd,MAAM,EAAE,WAAW;gBACnB,WAAW,EAAE,2DAA2D;aACzE;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;gBACrB,WAAW,EAAE,yDAAyD;aACvE;SACF;QACD,QAAQ,EAAE,EAAE;KACb;IAED,OAAO,EAAE,IAAA,oCAAiB,EAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC7C,mDAAmD;QACnD,MAAM,OAAO,GAAQ;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC;QAEF,oFAAoF;QACpF,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QACrC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QACjC,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;QACD,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACZ,OAAO,CAAC,EAAE,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjC,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;QACvD,OAAO,IAAA,qCAAa,EAAC,MAAM,CAAC,CAAC;IAC/B,CAAC,CAAC;CACH,CAAC"}

package/dist/tools/pools/fetchPools.js

@@ -14,7 +14,7 @@ exports.fetchPoolsTool = {
         properties: {
             type: {
                 type: 'string',
-                enum: ['recent', 'trending', 'user'],
+                enum: ['recent', 'popular'],
                 description: 'Type of pools to fetch (default: recent)',
             },
             creatorAddress: {

package/dist/tools/pools/fetchPools.js.map

@@ -1 +1 @@
-{"version":3,"file":"fetchPools.js","sourceRoot":"","sources":["../../../src/tools/pools/fetchPools.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAGH,6EAAkE;AAClE,mEAAiE;AAEpD,QAAA,cAAc,GAAY;IACrC,IAAI,EAAE,4BAA4B;IAClC,WAAW,EAAE,qEAAqE;IAClF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC;gBACpC,WAAW,EAAE,0CAA0C;aACxD;YACD,cAAc,EAAE;gBACd,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,6CAA6C;gBACtD,WAAW,EAAE,sCAAsC;aACpD;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,0BAA0B;aACxC;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,GAAG;gBACZ,WAAW,EAAE,gCAAgC;aAC9C;SACF;KACF;IACD,OAAO,EAAE,IAAA,oCAAiB,EAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC7C,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC;YAClC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,QAAQ;YAC3B,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC;YACpB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;SACxB,CAAC,CAAC;QAEH,OAAO,IAAA,qCAAa,EAAC,MAAM,CAAC,CAAC;IAC/B,CAAC,CAAC;CACH,CAAC"}
+{"version":3,"file":"fetchPools.js","sourceRoot":"","sources":["../../../src/tools/pools/fetchPools.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAGH,6EAAkE;AAClE,mEAAiE;AAEpD,QAAA,cAAc,GAAY;IACrC,IAAI,EAAE,4BAA4B;IAClC,WAAW,EAAE,qEAAqE;IAClF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;gBAC3B,WAAW,EAAE,0CAA0C;aACxD;YACD,cAAc,EAAE;gBACd,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,6CAA6C;gBACtD,WAAW,EAAE,sCAAsC;aACpD;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,0BAA0B;aACxC;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,GAAG;gBACZ,WAAW,EAAE,gCAAgC;aAC9C;SACF;KACF;IACD,OAAO,EAAE,IAAA,oCAAiB,EAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC7C,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC;YAClC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,QAAQ;YAC3B,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC;YACpB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;SACxB,CAAC,CAAC;QAEH,OAAO,IAAA,qCAAa,EAAC,MAAM,CAAC,CAAC;IAC/B,CAAC,CAAC;CACH,CAAC"}

package/dist/tools/pools/fetchPriceHistory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetchPriceHistory.d.ts","sourceRoot":"","sources":["../../../src/tools/pools/fetchPriceHistory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAKlD,eAAO,MAAM,qBAAqB,EAAE,OA+FnC,CAAC"}
+{"version":3,"file":"fetchPriceHistory.d.ts","sourceRoot":"","sources":["../../../src/tools/pools/fetchPriceHistory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAKlD,eAAO,MAAM,qBAAqB,EAAE,OA+GnC,CAAC"}

package/dist/tools/pools/fetchPriceHistory.js

@@ -19,7 +19,12 @@ exports.fetchPriceHistoryTool = {
 **Requirements:**
 - DEX Backend API must be configured (dexBackendBaseUrl in SDK config)
 - Node.js environment only (not available in browser)
-- Token parameter is required
+- Either tokenName OR tokenId is required (not both)
+
+**Token Identification:**
+- Use \`tokenName\` for convenience (e.g., "demonkpop") - automatically resolved to full token ID
+- Use \`tokenId\` for direct specification (e.g., "Token|Unit|DKP|eth:...")
+- Provide exactly ONE of these parameters
 
 **Use Cases:**
 - Historical price analysis and charting
@@ -31,6 +36,10 @@ exports.fetchPriceHistoryTool = {
     inputSchema: {
         type: 'object',
         properties: {
+            tokenName: {
+                type: 'string',
+                description: 'Simple token name for convenience (e.g., "demonkpop", "shoewars") - automatically resolves to full token ID. Use this OR tokenId, not both.',
+            },
             tokenId: {
                 oneOf: [
                     {
@@ -61,7 +70,7 @@ exports.fetchPriceHistoryTool = {
                         description: 'TokenClassKey object format',
                     },
                 ],
-                description: 'Token identifier (string or TokenClassKey object)',
+                description: 'Token identifier (string or TokenClassKey object). Use this OR tokenName, not both.',
             },
             from: {
                 type: 'string',
@@ -81,16 +90,22 @@ exports.fetchPriceHistoryTool = {
             page: common_schemas_js_1.PAGE_SCHEMA,
             limit: (0, common_schemas_js_1.createLimitSchema)('priceHistory', 10),
         },
-        required: ['tokenId'],
+        required: [],
     },
     handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
         // Convert string dates to Date objects if provided
         const options = {
-            tokenId: args.tokenId,
             sortOrder: args.sortOrder,
             page: args.page,
             limit: args.limit,
         };
+        // Support both tokenName and tokenId (mutual exclusivity validation happens in SDK)
+        if (args.tokenName) {
+            options.tokenName = args.tokenName;
+        }
+        else {
+            options.tokenId = args.tokenId;
+        }
         if (args.from) {
             options.from = new Date(args.from);
         }

package/dist/tools/pools/fetchPriceHistory.js.map

@@ -1 +1 @@
-{"version":3,"file":"fetchPriceHistory.js","sourceRoot":"","sources":["../../../src/tools/pools/fetchPriceHistory.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAGH,6EAAkE;AAClE,mEAAiE;AACjE,uEAAiF;AAEpE,QAAA,qBAAqB,GAAY;IAC5C,IAAI,EAAE,oCAAoC;IAC1C,WAAW,EAAE;;;;;;;;;;;;;;;oFAeqE;IAElF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,KAAK,EAAE;oBACL;wBACE,IAAI,EAAE,QAAQ;wBACd,WAAW,EACT,oGAAoG;qBACvG;oBACD;wBACE,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,UAAU,EAAE;gCACV,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,kCAAkC;6BAChD;4BACD,QAAQ,EAAE;gCACR,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,+BAA+B;6BAC7C;4BACD,IAAI,EAAE;gCACJ,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,4BAA4B;6BAC1C;4BACD,aAAa,EAAE;gCACb,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,oCAAoC;6BAClD;yBACF;wBACD,QAAQ,EAAE,CAAC,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,CAAC;wBAC7D,WAAW,EAAE,6BAA6B;qBAC3C;iBACF;gBACD,WAAW,EAAE,mDAAmD;aACjE;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,MAAM,EAAE,WAAW;gBACnB,WAAW,EAAE,qEAAqE;aACnF;YACD,EAAE,EAAE;gBACF,IAAI,EAAE,QAAQ;gBACd,MAAM,EAAE,WAAW;gBACnB,WAAW,EAAE,2DAA2D;aACzE;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;gBACrB,WAAW,EAAE,yDAAyD;aACvE;YACD,IAAI,EAAE,+BAAW;YACjB,KAAK,EAAE,IAAA,qCAAiB,EAAC,cAAc,EAAE,EAAE,CAAC;SAC7C;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;IAED,OAAO,EAAE,IAAA,oCAAiB,EAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC7C,mDAAmD;QACnD,MAAM,OAAO,GAAQ;YACnB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;QAEF,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;QACD,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACZ,OAAO,CAAC,EAAE,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjC,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;QACpD,OAAO,IAAA,qCAAa,EAAC,MAAM,CAAC,CAAC;IAC/B,CAAC,CAAC;CACH,CAAC"}
+{"version":3,"file":"fetchPriceHistory.js","sourceRoot":"","sources":["../../../src/tools/pools/fetchPriceHistory.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAGH,6EAAkE;AAClE,mEAAiE;AACjE,uEAAiF;AAEpE,QAAA,qBAAqB,GAAY;IAC5C,IAAI,EAAE,oCAAoC;IAC1C,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;oFAoBqE;IAElF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,6IAA6I;aAChJ;YACD,OAAO,EAAE;gBACP,KAAK,EAAE;oBACL;wBACE,IAAI,EAAE,QAAQ;wBACd,WAAW,EACT,oGAAoG;qBACvG;oBACD;wBACE,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,UAAU,EAAE;gCACV,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,kCAAkC;6BAChD;4BACD,QAAQ,EAAE;gCACR,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,+BAA+B;6BAC7C;4BACD,IAAI,EAAE;gCACJ,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,4BAA4B;6BAC1C;4BACD,aAAa,EAAE;gCACb,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,oCAAoC;6BAClD;yBACF;wBACD,QAAQ,EAAE,CAAC,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,CAAC;wBAC7D,WAAW,EAAE,6BAA6B;qBAC3C;iBACF;gBACD,WAAW,EAAE,qFAAqF;aACnG;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,MAAM,EAAE,WAAW;gBACnB,WAAW,EAAE,qEAAqE;aACnF;YACD,EAAE,EAAE;gBACF,IAAI,EAAE,QAAQ;gBACd,MAAM,EAAE,WAAW;gBACnB,WAAW,EAAE,2DAA2D;aACzE;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;gBACrB,WAAW,EAAE,yDAAyD;aACvE;YACD,IAAI,EAAE,+BAAW;YACjB,KAAK,EAAE,IAAA,qCAAiB,EAAC,cAAc,EAAE,EAAE,CAAC;SAC7C;QACD,QAAQ,EAAE,EAAE;KACb;IAED,OAAO,EAAE,IAAA,oCAAiB,EAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC7C,mDAAmD;QACnD,MAAM,OAAO,GAAQ;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;QAEF,oFAAoF;QACpF,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QACrC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QACjC,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;QACD,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACZ,OAAO,CAAC,EAAE,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjC,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;QACpD,OAAO,IAAA,qCAAa,EAAC,MAAM,CAAC,CAAC;IAC/B,CAAC,CAAC;CACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gala-chain/launchpad-mcp-server",
-  "version": "1.14.2",
+  "version": "1.15.0",
   "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",
   "main": "dist/index.js",
   "bin": {
@@ -64,7 +64,7 @@
   "dependencies": {
     "@gala-chain/api": "^2.4.3",
     "@gala-chain/connect": "^2.4.3",
-    "@gala-chain/launchpad-sdk": "^3.19.2",
+    "@gala-chain/launchpad-sdk": "^3.20.0",
     "@modelcontextprotocol/sdk": "^0.5.0",
     "axios": "^1.12.2",
     "bignumber.js": "^9.1.2",