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

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 1.14.2
+
+### Patch Changes
+
+- feat: enhance MCP SDK usage documentation with 200+ code examples
+  - Add price-history topic with fetchPriceHistory and fetchAllPriceHistory examples
+  - Add token-details topic with token metadata retrieval and validation
+  - Add profile-management topic with user profile workflows
+  - Enhance fetch-pools topic with 9 advanced examples and 11 tool equivalents
+  - Enhance balances topic with additional methods (fetchTokensCreated, fetchProfile)
+  - Expand mcp-to-sdk-mapping with 15+ missing tools across multiple sections
+  - Fix error-handling topic syntax error
+
+- Updated dependencies
+  - @gala-chain/launchpad-sdk@3.19.2
+
 ## 1.14.0
 
 ### Breaking 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.1";
+export declare const MCP_SERVER_VERSION = "1.14.2";
 //# 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.1';
+exports.MCP_SERVER_VERSION = '1.14.2';
 //# sourceMappingURL=version.js.map

package/dist/tools/utils/explainSdkUsage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"explainSdkUsage.d.ts","sourceRoot":"","sources":["../../../src/tools/utils/explainSdkUsage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AA2wBlD;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,OA+DjC,CAAC"}
+{"version":3,"file":"explainSdkUsage.d.ts","sourceRoot":"","sources":["../../../src/tools/utils/explainSdkUsage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AA6qClD;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,OAqEjC,CAAC"}

package/dist/tools/utils/explainSdkUsage.js

@@ -137,15 +137,14 @@ async function graduatePool() {
 - \`gala_launchpad_graduate_token\`
 `,
     'fetch-pools': `
-## Fetching Pool Data with SDK
+## Fetching Pool Data with Advanced Methods
 
 \`\`\`typescript
 import { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';
 
-async function fetchPools() {
-  const sdk = createLaunchpadSDK({
-    wallet: 'your-private-key'
-  });
+// 1. BASIC POOL FETCHING - With Pagination
+async function basicPoolFetching() {
+  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });
 
   // Fetch recent pools with pagination
   const pools = await sdk.fetchPools({
@@ -154,29 +153,146 @@ async function fetchPools() {
     page: 1
   });
 
-  console.log(\`Found \${pools.total} pools\`);
-  console.log(\`Page \${pools.page} of \${pools.totalPages}\`);
-  console.log(\`Has next page: \${pools.hasNext}\`);
-
+  console.log(\`Found \${pools.total} pools, page \${pools.page} of \${pools.totalPages}\`);
   pools.pools.forEach(pool => {
     console.log(\`\${pool.tokenName}: \${pool.tokenSymbol}\`);
-    console.log(\`Creator: \${pool.creatorAddress}\`);
-    console.log(\`Created: \${pool.createdAt}\`);
   });
+}
+
+// 2. AUTO-PAGINATED FETCHING - Get ALL Pools
+async function fetchAllPools() {
+  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });
+
+  // Auto-paginated - returns all pools without manual pagination
+  const allPools = await sdk.fetchAllPools({
+    type: 'recent'
+  });
+
+  console.log(\`Total pools: \${allPools.pools.length}\`);
+}
 
-  // Fetch specific pool details
-  const details = await sdk.fetchPoolDetails('dragnrkti');
+// 3. POOL DETAILS - Complete information
+async function getPoolDetails(tokenName) {
+  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });
 
-  console.log('Sale status:', details.saleStatus);
+  const details = await sdk.fetchPoolDetails(tokenName);
+
+  console.log('Sale status:', details.saleStatus); // 'Ongoing' or 'Completed'
   console.log('Base price:', details.basePrice);
   console.log('Max supply:', details.maxSupply);
-  console.log('Native token quantity:', details.nativeTokenQuantity);
+  console.log('Remaining tokens:', details.sellingTokenQuantity);
+}
+
+// 4. POOL DETAILS FOR CALCULATIONS - Optimized for math
+async function getOptimizedPoolDetails(tokenName) {
+  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });
+
+  // Returns only fields needed for bonding curve calculations
+  const poolData = await sdk.fetchPoolDetailsForCalculation(tokenName);
+
+  console.log('Current supply:', poolData.currentSupply);
+  console.log('Remaining tokens:', poolData.remainingTokens);
+  console.log('Max supply:', poolData.maxSupply);
+  console.log('Reverse bonding curve max fee:', poolData.reverseBondingCurveMaxFeeFactor);
+}
+
+// 5. VOLUME & OHLCV DATA - Historical candlestick data
+async function getVolumeData(tokenName) {
+  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });
+
+  // Different resolutions: '1m', '5m', '15m', '1h', '4h', '1d'
+  const volumeData = await sdk.fetchVolumeData({
+    tokenName: tokenName,
+    from: new Date(Date.now() - 7 * 24 * 60 * 60 * 1000), // Last 7 days
+    to: new Date(),
+    resolution: '1h' // 1-hour candlesticks
+  });
+
+  volumeData.forEach(candle => {
+    console.log(\`\${candle.time}: O:\${candle.open} H:\${candle.high} L:\${candle.low} C:\${candle.close} V:\${candle.volume}\`);
+  });
+}
+
+// 6. SPOT PRICES - DEX tokens (GALA, SILK, MUSIC)
+async function getDexTokenPrices() {
+  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });
+
+  // Fetch prices for multiple DEX tokens
+  const prices = await sdk.fetchTokenSpotPrice(['GALA', 'SILK', 'MUSIC']);
+
+  console.log(\`GALA: \$\${prices.GALA}\`);
+  console.log(\`SILK: \$\${prices.SILK}\`);
+  console.log(\`MUSIC: \$\${prices.MUSIC}\`);
+}
+
+// 7. LAUNCHPAD TOKEN SPOT PRICES
+async function getLaunchpadTokenPrice(tokenName) {
+  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });
+
+  // Get USD spot price for a launchpad token (anime, woohoo, etc.)
+  const price = await sdk.fetchLaunchpadTokenSpotPrice(tokenName);
+
+  console.log(\`\${tokenName} price: \$\${price}\`);
+}
+
+// 8. RESOLVE UTILITY ADDRESSES
+async function resolveAddresses(tokenName) {
+  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });
+
+  // Get GalaChain vault address for token
+  const vaultAddress = await sdk.resolveVaultAddress(tokenName);
+  console.log(\`Vault address: \${vaultAddress}\`);
+
+  // Get TokenClassKey for token
+  const tokenClassKey = await sdk.resolveTokenClassKey(tokenName);
+  console.log(\`TokenClassKey: \${tokenClassKey}\`);
+}
+
+// 9. COMPLETE INVESTMENT ANALYSIS WORKFLOW
+async function analyzeToken(tokenName) {
+  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });
+
+  // Get all token data in parallel
+  const [details, volumeData, distribution, badges] = await Promise.all([
+    sdk.fetchPoolDetails(tokenName),
+    sdk.fetchVolumeData({ tokenName, resolution: '1d' }),
+    sdk.fetchTokenDistribution(tokenName),
+    sdk.fetchTokenBadges(tokenName)
+  ]);
+
+  // Analyze status
+  console.log(\`Pool Status: \${details.saleStatus}\`);
+  console.log(\`Supply: \${details.currentSupply} / \${details.maxSupply}\`);
+
+  // Analyze volume trend
+  const volumes = volumeData.map(v => parseFloat(v.volume));
+  const avgVolume = volumes.reduce((a, b) => a + b, 0) / volumes.length;
+  console.log(\`Avg daily volume: \$\${avgVolume.toFixed(2)}\`);
+
+  // Analyze distribution
+  const top5Ownership = distribution.holders
+    .sort((a, b) => parseFloat(b.balance) - parseFloat(a.balance))
+    .slice(0, 5)
+    .reduce((sum, h) => sum + h.percentage, 0);
+  console.log(\`Top 5 holders: \${top5Ownership.toFixed(2)}%\`);
+
+  // Check badges
+  console.log(\`Badges: \${badges.join(', ')}\`);
 }
 \`\`\`
 
 **MCP Tool Equivalents:**
-- \`gala_launchpad_fetch_pools\`
-- \`gala_launchpad_fetch_pool_details\`
+- \`gala_launchpad_fetch_pools\` - Paginated pool list
+- \`gala_launchpad_fetch_all_pools\` - Auto-paginated all pools
+- \`gala_launchpad_fetch_pool_details\` - Complete pool information
+- \`gala_launchpad_fetch_pool_details_for_calculation\` - Optimized for calculations
+- \`gala_launchpad_fetch_volume_data\` - OHLCV candlestick data
+- \`gala_launchpad_fetch_token_spot_price\` - DEX token prices (GALA, SILK, MUSIC)
+- \`gala_launchpad_fetch_launchpad_token_spot_price\` - Launchpad token USD prices
+- \`gala_launchpad_fetch_token_distribution\` - Token holder analysis
+- \`gala_launchpad_fetch_token_badges\` - Achievement badges
+- \`gala_launchpad_resolve_vault_address\` - Get vault address
+- \`gala_launchpad_resolve_token_class_key\` - Get TokenClassKey
 `,
     'balances': `
 ## Checking Balances with SDK
@@ -215,6 +331,25 @@ async function checkBalances() {
   portfolio.tokens.forEach(token => {
     console.log(\`\${token.name}: \${token.quantity}\`);
   });
+
+  // Check tokens created by this wallet
+  const createdTokens = await sdk.fetchTokensCreated({
+    address: sdk.getAddress(),
+    limit: 10
+  });
+
+  console.log(\`Created \${createdTokens.total} tokens\`);
+  createdTokens.tokens.forEach(token => {
+    console.log(\`  \${token.symbol}: \${token.name}\`);
+  });
+
+  // Get user profile
+  const profile = await sdk.fetchProfile();
+  console.log(\`Profile: \${profile.fullName}\`);
+
+  // Check profile of another user
+  const otherProfile = await sdk.fetchProfile('eth|0x...');
+  console.log(\`Other user: \${otherProfile.fullName}\`);
 }
 \`\`\`
 
@@ -222,6 +357,8 @@ async function checkBalances() {
 - \`gala_launchpad_fetch_gala_balance\`
 - \`gala_launchpad_fetch_token_balance\`
 - \`gala_launchpad_fetch_tokens_held\`
+- \`gala_launchpad_fetch_tokens_created\`
+- \`gala_launchpad_fetch_profile\`
 `,
     'token-creation': `
 ## Creating Tokens with SDK
@@ -422,7 +559,7 @@ async function errorHandlingExample() {
     } else if (error instanceof TokenNotFoundError) {
       console.error('Token does not exist:', error.tokenName);
 
-    } catch if (error instanceof NetworkError) {
+    } else if (error instanceof NetworkError) {
       console.error('Network issue:', error.message);
       console.error('Status code:', error.statusCode);
 
@@ -624,6 +761,257 @@ async function localCalculationsExample() {
 - \`gala_launchpad_calculate_buy_amount_external\`
 - \`gala_launchpad_calculate_sell_amount_local\`
 - \`gala_launchpad_calculate_sell_amount_external\`
+`,
+    'price-history': `
+## Historical Price Analysis with SDK
+
+\`\`\`typescript
+import { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';
+
+async function analyzePriceHistory() {
+  const sdk = createLaunchpadSDK({
+    wallet: 'your-private-key-or-mnemonic'
+  });
+
+  // Paginated price history
+  const history = await sdk.fetchPriceHistory({
+    tokenId: 'Token|Unit|GUSDC|eth:0x...',
+    from: new Date('2025-01-01'),
+    to: new Date('2025-01-31'),
+    sortOrder: 'DESC',
+    page: 1,
+    limit: 50
+  });
+
+  console.log(\`Found \${history.snapshots.length} snapshots\`);
+  console.log(\`Total available: \${history.total} (page \${history.page} of \${history.totalPages})\`);
+
+  // Auto-paginated complete history
+  const allHistory = await sdk.fetchAllPriceHistory({
+    tokenId: 'GWETH|Unit|none|none',
+    from: new Date('2024-01-01'),
+    sortOrder: 'ASC'
+  });
+
+  // Price analysis
+  const prices = allHistory.snapshots.map(s => parseFloat(s.price));
+  const avg = prices.reduce((a, b) => a + b, 0) / prices.length;
+  const variance = prices.reduce((sum, p) => sum + Math.pow(p - avg, 2), 0) / prices.length;
+  const volatility = Math.sqrt(variance);
+
+  console.log(\`Average: \$\${avg.toFixed(4)}, Volatility: \$\${volatility.toFixed(4)}\`);
+
+  // Data export (CSV)
+  const csv = ['timestamp,price'].concat(
+    allHistory.snapshots.map(s => \`\${s.timestamp.toISOString()},\${s.price}\`)
+  ).join('\\n');
+
+  console.log('CSV export:', csv.split('\\n').slice(0, 3).join('\\n'));
+}
+\`\`\`
+
+**Key Methods:**
+- \`fetchPriceHistory()\` - Paginated historical prices (max 50 per page)
+- \`fetchAllPriceHistory()\` - Auto-paginated complete history (all snapshots)
+
+**Response Fields:**
+- \`price\` - Token price as decimal string
+- \`timestamp\` - ISO 8601 timestamp
+- \`tokenId\` - Token identifier (pipe-delimited)
+
+**Use Cases:**
+- Technical analysis and charting
+- Volatility assessment
+- Price trend identification
+- Data export for analytics
+- Backtesting strategies
+
+**Token ID Formats:**
+- String: \`Token|Unit|GUSDC|eth:0x...\`
+- Object: \`{ collection, category, type, additionalKey }\`
+
+**MCP Tool Equivalents:**
+- \`gala_launchpad_fetch_price_history\` - Paginated
+- \`gala_launchpad_fetch_all_price_history\` - Auto-paginated
+`,
+    'token-details': `
+## Token Details and Metadata with SDK
+
+\`\`\`typescript
+import { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';
+
+async function analyzeTokenDetails() {
+  const sdk = createLaunchpadSDK({
+    wallet: 'your-private-key-or-mnemonic'
+  });
+
+  // Fetch token metadata
+  const details = await sdk.fetchTokenDetails('Token|Unit|GUSDC|eth:0x...');
+
+  console.log('Token Information:');
+  console.log(\`  Name: \${details.name}\`);
+  console.log(\`  Symbol: \${details.symbol}\`);
+  console.log(\`  Decimals: \${details.decimals}\`);
+  console.log(\`  Verified: \${details.verified}\`);
+  console.log(\`  Trading: \${details.tradingEnabled}\`);
+  console.log(\`  Network: \${details.network}\`);
+  console.log(\`  Image: \${details.image}\`);
+
+  // Pre-trading validation
+  async function validateBeforeTrade(tokenId: string) {
+    const token = await sdk.fetchTokenDetails(tokenId);
+
+    if (!token.verified) {
+      console.warn(\`⚠️  \${token.symbol} is NOT verified\`);
+    }
+
+    if (!token.tradingEnabled) {
+      throw new Error(\`Trading disabled for \${token.symbol}\`);
+    }
+
+    if (token.network !== 'ethereum') {
+      throw new Error(\`Wrong network: got \${token.network}\`);
+    }
+
+    return token;
+  }
+
+  // Batch token comparison
+  const tokens = ['GALA|Unit|none|none', 'Token|Unit|GUSDC|eth:0x...'];
+  const details_list = await Promise.all(
+    tokens.map(id => sdk.fetchTokenDetails(id).catch(() => null))
+  );
+
+  const verified = details_list.filter(t => t?.verified).length;
+  console.log(\`Verified tokens: \${verified}/\${tokens.length}\`);
+}
+\`\`\`
+
+**Response Fields:**
+- \`symbol\` - Token symbol (e.g., 'GUSDC')
+- \`name\` - Full token name
+- \`decimals\` - Decimal places
+- \`verified\` - Verification status
+- \`tradingEnabled\` - Trading availability
+- \`network\` - Network name (e.g., 'ethereum')
+- \`contractAddress\` - Smart contract address
+- \`image\` - Token image URL
+- \`chainId\` - Blockchain chain ID
+
+**Use Cases:**
+- Pre-trading validation and safety checks
+- Display token metadata in UI
+- Verify token authenticity
+- Network compatibility checking
+
+**Token ID Formats:**
+- String: \`Token|Unit|GUSDC|eth:0x...\`
+- Object: \`{ collection, category, type, additionalKey }\`
+
+**MCP Tool Equivalent:** \`gala_launchpad_fetch_token_details\`
+`,
+    'profile-management': `
+## User Profile Management with SDK
+
+\`\`\`typescript
+import { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';
+
+async function manageUserProfiles() {
+  const sdk = createLaunchpadSDK({
+    wallet: 'your-private-key-or-mnemonic'
+  });
+
+  // Fetch current user profile
+  const myProfile = await sdk.fetchProfile();
+  console.log(\`Name: \${myProfile.fullName}\`);
+  console.log(\`Avatar: \${myProfile.profileImage}\`);
+
+  // Fetch another user's profile
+  const other = await sdk.fetchProfile('eth|0x...');
+  console.log(\`Other user: \${other.fullName}\`);
+
+  // Update profile
+  const updated = await sdk.updateProfile({
+    fullName: 'Satoshi Nakamoto',
+    profileImage: 'https://example.com/avatar.png',
+    address: sdk.getAddress()
+  });
+
+  console.log(\`Updated: \${updated.fullName}\`);
+
+  // Upload profile image (Node.js only)
+  const imgResult = await sdk.uploadProfileImage({
+    imagePath: '/path/to/avatar.png'
+  });
+
+  // Update with uploaded image
+  await sdk.updateProfile({
+    fullName: 'My Name',
+    profileImage: imgResult.imageUrl,
+    address: sdk.getAddress()
+  });
+
+  // Complete workflow: Update profile, then launch token
+  async function createTokenWithProfile() {
+    const avatar = await sdk.uploadProfileImage({
+      imagePath: '/path/to/pic.png'
+    });
+
+    await sdk.updateProfile({
+      fullName: 'Token Creator',
+      profileImage: avatar.imageUrl,
+      address: sdk.getAddress()
+    });
+
+    const logo = await sdk.uploadTokenImage({
+      tokenName: 'mytoken',
+      imagePath: '/path/to/logo.png'
+    });
+
+    const result = await sdk.launchToken({
+      tokenName: 'mytoken',
+      tokenSymbol: 'MTK',
+      tokenDescription: 'Awesome token',
+      tokenImage: logo.imageUrl,
+      websiteUrl: 'https://mytoken.com'
+    });
+
+    return result;
+  }
+
+  // Batch profile fetching
+  const addresses = ['eth|0xaddress1', 'eth|0xaddress2'];
+  const profiles = await Promise.all(
+    addresses.map(addr => sdk.fetchProfile(addr).catch(() => null))
+  );
+
+  console.log('Profiles:', profiles.filter(p => p).map(p => p.fullName));
+}
+\`\`\`
+
+**Profile Methods:**
+- \`fetchProfile(address?)\` - Get user profile
+- \`updateProfile(data)\` - Update profile info
+- \`uploadProfileImage(options)\` - Upload avatar (Node.js)
+
+**Profile Fields:**
+- \`fullName\` - Display name (max 100 chars)
+- \`profileImage\` - Avatar image URL
+- \`address\` - Wallet address
+- \`createdAt\` - Creation date
+- \`updatedAt\` - Update timestamp
+
+**Use Cases:**
+- Display user profiles
+- Allow profile customization
+- Manage profile images
+- Token creator attribution
+- Multi-wallet profiles
+
+**MCP Tool Equivalents:**
+- \`gala_launchpad_fetch_profile\`
+- \`gala_launchpad_update_profile\`
+- \`gala_launchpad_upload_profile_image\`
 `,
     'token-distribution': `
 ## Token Holder Distribution with SDK
@@ -724,15 +1112,32 @@ function calculateGini(holders: Array<{balance: string}>) {
 | \`gala_launchpad_calculate_sell_amount_external\` | \`sdk.calculateSellAmountExternal(options)\` | Explicit network quote (sell) |
 | \`gala_launchpad_buy_tokens\` | \`sdk.buy(options)\` | Execute token purchase |
 | \`gala_launchpad_sell_tokens\` | \`sdk.sell(options)\` | Execute token sale |
+| \`gala_launchpad_calculate_buy_amount_for_graduation\` | \`sdk.calculateBuyAmountForGraduation(options)\` | Calculate graduation cost |
 | \`gala_launchpad_graduate_token\` | \`sdk.graduateToken(options)\` | One-step pool graduation |
+| \`gala_launchpad_fetch_trades\` | \`sdk.fetchTrades(options)\` | Get trade history |
+| \`gala_launchpad_get_bundler_transaction_result\` | \`sdk.getBundlerTransactionResult(txId)\` | Get transaction result |
 
 ### Pool Management
 | MCP Tool | SDK Method | Notes |
 |----------|------------|-------|
 | \`gala_launchpad_fetch_pools\` | \`sdk.fetchPools(options)\` | List pools with filtering |
+| \`gala_launchpad_fetch_all_pools\` | \`sdk.fetchAllPools(options)\` | Auto-paginated all pools |
 | \`gala_launchpad_fetch_pool_details\` | \`sdk.fetchPoolDetails(tokenName)\` | Get specific pool data |
+| \`gala_launchpad_fetch_pool_details_for_calculation\` | \`sdk.fetchPoolDetailsForCalculation(tokenName)\` | Optimized for calculations |
 | \`gala_launchpad_fetch_token_distribution\` | \`sdk.fetchTokenDistribution(tokenName)\` | Holder distribution |
 | \`gala_launchpad_fetch_token_badges\` | \`sdk.fetchTokenBadges(tokenName)\` | Achievement badges |
+| \`gala_launchpad_fetch_volume_data\` | \`sdk.fetchVolumeData(options)\` | OHLCV candlestick data |
+| \`gala_launchpad_fetch_token_spot_price\` | \`sdk.fetchTokenSpotPrice(symbols)\` | DEX token spot prices |
+| \`gala_launchpad_fetch_launchpad_token_spot_price\` | \`sdk.fetchLaunchpadTokenSpotPrice(options)\` | Launchpad token price |
+| \`gala_launchpad_resolve_vault_address\` | \`sdk.resolveVaultAddress(tokenName)\` | Get vault address |
+| \`gala_launchpad_resolve_token_class_key\` | \`sdk.resolveTokenClassKey(tokenName)\` | Get TokenClassKey |
+| \`gala_launchpad_fetch_token_details\` | \`sdk.fetchTokenDetails(tokenId)\` | Comprehensive token metadata |
+
+### Price History & Analysis
+| MCP Tool | SDK Method | Notes |
+|----------|------------|-------|
+| \`gala_launchpad_fetch_price_history\` | \`sdk.fetchPriceHistory(options)\` | Paginated price snapshots |
+| \`gala_launchpad_fetch_all_price_history\` | \`sdk.fetchAllPriceHistory(options)\` | Auto-paginated all prices |
 
 ### Balance & Portfolio
 | MCP Tool | SDK Method | Notes |
@@ -741,6 +1146,16 @@ function calculateGini(holders: Array<{balance: string}>) {
 | \`gala_launchpad_fetch_token_balance\` | \`sdk.fetchTokenBalance(options)\` | Specific token balance |
 | \`gala_launchpad_fetch_tokens_held\` | \`sdk.fetchTokensHeld(options)\` | Portfolio holdings |
 | \`gala_launchpad_fetch_tokens_created\` | \`sdk.fetchTokensCreated(options)\` | Created tokens |
+| \`gala_launchpad_fetch_profile\` | \`sdk.fetchProfile(address?)\` | User profile |
+| \`gala_launchpad_update_profile\` | \`sdk.updateProfile(data)\` | Update profile |
+| \`gala_launchpad_upload_profile_image\` | \`sdk.uploadProfileImage(options)\` | Upload avatar |
+
+### Profile Management
+| MCP Tool | SDK Method | Notes |
+|----------|------------|-------|
+| \`gala_launchpad_fetch_profile\` | \`sdk.fetchProfile(address?)\` | Get user profile |
+| \`gala_launchpad_update_profile\` | \`sdk.updateProfile(data)\` | Update profile info |
+| \`gala_launchpad_upload_profile_image\` | \`sdk.uploadProfileImage(options)\` | Upload profile image |
 
 ### Token Creation
 | MCP Tool | SDK Method | Notes |
@@ -787,14 +1202,17 @@ Available topics:
 - 'pool-graduation' - Graduate a bonding curve pool
 - 'fetch-pools' - Query pool data and details
 - 'balances' - Check GALA and token balances
+- 'price-history' - Historical price analysis and technical analysis
+- 'token-details' - Comprehensive token metadata and validation
 - 'token-distribution' - Analyze token holder distribution and concentration
 - 'token-creation' - Launch new tokens
+- 'profile-management' - User profile management and customization
 - 'multi-wallet' - Use multiple wallets (privateKey override pattern)
 - 'transfers' - Transfer GALA and tokens between wallets
 - 'error-handling' - Handle errors and exceptions
 - 'installation' - Install and configure SDK
 - 'local-calculations' - Local vs external bonding curve calculations
-- 'mcp-to-sdk-mapping' - Complete mapping of MCP tools to SDK methods
+- 'mcp-to-sdk-mapping' - Complete mapping of MCP tools to SDK methods (56+ tools)
 
 Returns runnable TypeScript code examples with explanations.`,
     inputSchema: {
@@ -808,8 +1226,11 @@ Returns runnable TypeScript code examples with explanations.`,
                     'pool-graduation',
                     'fetch-pools',
                     'balances',
+                    'price-history',
+                    'token-details',
                     'token-distribution',
                     'token-creation',
+                    'profile-management',
                     'multi-wallet',
                     'transfers',
                     'error-handling',
@@ -830,7 +1251,7 @@ Returns runnable TypeScript code examples with explanations.`,
         return (0, response_formatter_js_1.formatSuccess)({
             topic: args.topic,
             explanation: example,
-            sdkVersion: '3.11.7',
+            sdkVersion: '3.19.0',
             packageName: '@gala-chain/launchpad-sdk',
             documentation: 'https://www.npmjs.com/package/@gala-chain/launchpad-sdk',
         });

package/dist/tools/utils/explainSdkUsage.js.map

@@ -1 +1 @@
-{"version":3,"file":"explainSdkUsage.js","sourceRoot":"","sources":["../../../src/tools/utils/explainSdkUsage.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAGH,mEAAiE;AACjE,6EAAkE;AAElE;;GAEG;AACH,MAAM,YAAY,GAAG;IACnB,oBAAoB;IACpB,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyCf;IAEC,aAAa,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsChB;IAEC,iBAAiB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwCpB;IAEC,aAAa,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyChB;IAEC,UAAU,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4Cb;IAEC,gBAAgB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwDnB;IAEC,cAAc,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4DjB;IAEC,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0Cd;IAEC,gBAAgB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4DnB;IAEC,cAAc,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoEjB;IAEC,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8GvB;IAEC,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoFvB;IAEC,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2DvB;CACA,CAAC;AAEF;;GAEG;AACU,QAAA,mBAAmB,GAAY;IAC1C,IAAI,EAAE,kCAAkC;IACxC,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;6DAoB8C;IAC3D,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE;oBACJ,YAAY;oBACZ,aAAa;oBACb,iBAAiB;oBACjB,aAAa;oBACb,UAAU;oBACV,oBAAoB;oBACpB,gBAAgB;oBAChB,cAAc;oBACd,WAAW;oBACX,gBAAgB;oBAChB,cAAc;oBACd,oBAAoB;oBACpB,oBAAoB;iBACrB;gBACD,WAAW,EAAE,gCAAgC;aAC9C;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB;IACD,OAAO,EAAE,IAAA,oCAAiB,EAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;QAC9C,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,KAAkC,CAAC,CAAC;QAEtE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAClD,CAAC;QAED,OAAO,IAAA,qCAAa,EAAC;YACnB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,OAAO;YACpB,UAAU,EAAE,QAAQ;YACpB,WAAW,EAAE,2BAA2B;YACxC,aAAa,EAAE,yDAAyD;SACzE,CAAC,CAAC;IACL,CAAC,CAAC;CACH,CAAC"}
+{"version":3,"file":"explainSdkUsage.js","sourceRoot":"","sources":["../../../src/tools/utils/explainSdkUsage.ts"],"names":[],"mappings":"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"}