@gala-chain/launchpad-mcp-server 1.2.19 → 1.2.21

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 1.2.20 - 2025-10-02
+
+### Changed
+
+- Updated SDK dependency from ^3.7.5 to ^3.7.6
+- Inherits graduation calculation documentation improvements from SDK v3.7.6
+
 ## 1.2.19 - 2025-10-02
 
 ### Documentation

package/README.md

@@ -4,7 +4,7 @@ MCP (Model Context Protocol) server for Gala Launchpad SDK - Enables AI agents t
 
 ## 🚀 Features
 
-- **40 AI-accessible tools** for complete Gala Launchpad integration
+- **41 AI-accessible tools** for complete Gala Launchpad integration
 - **Type-safe** - Full TypeScript support with validated inputs
 - **Production-ready** - Built on [@gala-chain/launchpad-sdk ](https://www.npmjs.com/package/@gala-chain/launchpad-sdk)
 - **Easy setup** - Works with Claude Desktop and other MCP clients
@@ -50,7 +50,7 @@ Add to your `claude_desktop_config.json`:
 3. **Restart Claude Desktop**
 4. **Use tools**: Ask Claude to interact with Gala Launchpad!
 
-## 🛠️ Available Tools (40 Total)
+## 🛠️ Available Tools (41 Total)
 
 ### Pool Management (8 tools)
 - `gala_launchpad_fetch_pools` - Fetch token pools with filtering
@@ -128,8 +128,9 @@ Add to your `claude_desktop_config.json`:
 - `gala_launchpad_transfer_gala` - Transfer GALA tokens
 - `gala_launchpad_transfer_token` - Transfer launchpad tokens
 
-### Utility Tools (1 tool)
+### Utility Tools (2 tools)
 - `gala_launchpad_get_url_by_token_name` - Generate frontend URL for a token
+- `gala_launchpad_explain_sdk_usage` - Get SDK code examples and usage explanations
 
 ## 💡 Example Usage
 
@@ -145,6 +146,35 @@ Ask Claude (or your AI assistant):
 
 > "Show me all tokens I'm holding"
 
+## 📚 SDK Usage Reference
+
+The MCP server includes a built-in SDK documentation tool that provides complete, runnable code examples for using the SDK directly instead of through MCP tools. This is perfect for developers who want to integrate the SDK into their applications.
+
+**Ask Claude for SDK code examples:**
+
+> "Explain how to buy tokens using the SDK"
+
+> "Show me the SDK code for selling tokens"
+
+> "How do I use multiple wallets with the SDK?"
+
+> "Show me all MCP tools and their SDK method equivalents"
+
+**Available topics:**
+- `buy-tokens` - Complete buying workflow
+- `sell-tokens` - Complete selling workflow
+- `pool-graduation` - Graduate bonding curve pools
+- `fetch-pools` - Query pool data
+- `balances` - Check GALA and token balances
+- `token-creation` - Launch new tokens
+- `multi-wallet` - Multi-wallet patterns
+- `transfers` - Transfer tokens between wallets
+- `error-handling` - Handle exceptions
+- `installation` - Install and configure SDK
+- `mcp-to-sdk-mapping` - Complete tool-to-method mapping
+
+Each topic returns complete TypeScript code with explanations, making it easy to transition from MCP tools to direct SDK integration.
+
 ## 🔐 Multi-Wallet Support
 
 All signing operations support an optional `privateKey` parameter for per-operation wallet overrides. This enables:

package/dist/schemas/common-schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"common-schemas.d.ts","sourceRoot":"","sources":["../../src/schemas/common-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAiDH;;;GAGG;AACH,eAAO,MAAM,iBAAiB,KAA6C,CAAC;AAE5E;;;GAGG;AACH,eAAO,MAAM,mBAAmB,KAAiD,CAAC;AAElF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,KAGpC,CAAC;AAMF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,KAG9B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,KAAuD,CAAC;AAMnF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,KAGjC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,KAGnC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;CAIjC,CAAC;AAMF;;;GAGG;AACH,eAAO,MAAM,UAAU,KAAyB,CAAC;AAEjD;;;GAGG;AACH,eAAO,MAAM,sBAAsB,KAGlC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,KAA2C,CAAC;AAEzE;;;GAGG;AACH,eAAO,MAAM,aAAa,KAGzB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,KAGjC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,KAA2D,CAAC;AAE1F;;;GAGG;AACH,eAAO,MAAM,gBAAgB,KAAmC,CAAC;AAMjE;;;GAGG;AACH,eAAO,MAAM,WAAW,KAA4D,CAAC;AAErF;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,EACpD,YAAY,GAAE,MAAW,GACxB;IACD,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB,CAqBA;AAMD;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;CAKrC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;CAMnC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;CAI7B,CAAC"}
+{"version":3,"file":"common-schemas.d.ts","sourceRoot":"","sources":["../../src/schemas/common-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAkDH;;;GAGG;AACH,eAAO,MAAM,iBAAiB,KAA6C,CAAC;AAE5E;;;GAGG;AACH,eAAO,MAAM,mBAAmB,KAAiD,CAAC;AAElF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,KAGpC,CAAC;AAMF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,KAG9B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,KAAuD,CAAC;AAMnF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,KAGjC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,KAGnC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;CAIjC,CAAC;AAMF;;;GAGG;AACH,eAAO,MAAM,UAAU,KAAyB,CAAC;AAEjD;;;GAGG;AACH,eAAO,MAAM,sBAAsB,KAGlC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,KAA2C,CAAC;AAEzE;;;GAGG;AACH,eAAO,MAAM,aAAa,KAGzB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,KAGjC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,KAA2D,CAAC;AAE1F;;;GAGG;AACH,eAAO,MAAM,gBAAgB,KAAmC,CAAC;AAMjE;;;GAGG;AACH,eAAO,MAAM,WAAW,KAA4D,CAAC;AAErF;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,EACpD,YAAY,GAAE,MAAW,GACxB;IACD,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB,CAqBA;AAMD;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;CAKrC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;CAMnC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;CAI7B,CAAC"}

package/dist/schemas/common-schemas.js

@@ -25,6 +25,7 @@ const constraints_js_1 = require("../utils/constraints.js");
 function toMCPSchema(zodSchema, customDescription) {
     const jsonSchema = (0, zod_to_json_schema_1.zodToJsonSchema)(zodSchema, { $refStrategy: 'none' });
     // Extract the schema properties (removing $schema metadata)
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
     const { $schema, ...schemaProps } = jsonSchema;
     // Override description if provided
     if (customDescription) {

package/dist/schemas/common-schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"common-schemas.js","sourceRoot":"","sources":["../../src/schemas/common-schemas.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"common-schemas.js","sourceRoot":"","sources":["../../src/schemas/common-schemas.ts"],"names":[],"mappings":"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"}

package/dist/tools/creation/index.js

@@ -191,7 +191,7 @@ exports.fetchLaunchTokenFeeTool = {
         type: 'object',
         properties: {},
     },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
+    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, _args) => {
         const feeAmount = await sdk.fetchLaunchTokenFee();
         return (0, response_formatter_js_1.formatSuccess)({ feeAmount });
     }),

package/dist/tools/creation/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/creation/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/creation/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/index.d.ts

@@ -1,10 +1,10 @@
 /**
  * Tool Registry
  *
- * All 37 MCP tools for Gala Launchpad
+ * All 41 MCP tools for Gala Launchpad
  */
 /**
- * Complete tool registry (37 tools)
+ * Complete tool registry (41 tools)
  */
 export declare const tools: import("../types/mcp.js").MCPTool[];
 //# sourceMappingURL=index.d.ts.map

package/dist/tools/index.js

@@ -2,7 +2,7 @@
 /**
  * Tool Registry
  *
- * All 37 MCP tools for Gala Launchpad
+ * All 41 MCP tools for Gala Launchpad
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.tools = void 0;
@@ -14,19 +14,19 @@ const index_js_5 = require("./social/index.js");
 const index_js_6 = require("./transfers/index.js");
 const index_js_7 = require("./utils/index.js");
 /**
- * Complete tool registry (37 tools)
+ * Complete tool registry (41 tools)
  */
 exports.tools = [
-    ...index_js_1.poolTools, // 12 tools
-    ...index_js_2.tradingTools, // 7 tools (added getBundlerTransactionResult)
+    ...index_js_1.poolTools, // 8 tools
+    ...index_js_2.tradingTools, // 8 tools
     ...index_js_3.balanceTools, // 6 tools
-    ...index_js_4.creationTools, // 3 tools
+    ...index_js_4.creationTools, // 4 tools
     ...index_js_5.socialTools, // 2 tools
     ...index_js_6.transferTools, // 2 tools
-    ...index_js_7.utilityTools, // 5 tools (added createWallet, getAddress, getEthereumAddress, getConfig)
+    ...index_js_7.utilityTools, // 6 tools (added explainSdkUsage)
 ];
 // Verify tool count
-if (exports.tools.length !== 37) {
-    console.warn(`Warning: Expected 37 tools, but registered ${exports.tools.length} tools`);
+if (exports.tools.length !== 41) {
+    console.warn(`Warning: Expected 41 tools, but registered ${exports.tools.length} tools`);
 }
 //# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,+CAA6C;AAC7C,iDAAkD;AAClD,iDAAkD;AAClD,kDAAoD;AACpD,gDAAgD;AAChD,mDAAqD;AACrD,+CAAgD;AAEhD;;GAEG;AACU,QAAA,KAAK,GAAG;IACnB,GAAG,oBAAS,EAAO,WAAW;IAC9B,GAAG,uBAAY,EAAI,8CAA8C;IACjE,GAAG,uBAAY,EAAI,UAAU;IAC7B,GAAG,wBAAa,EAAG,UAAU;IAC7B,GAAG,sBAAW,EAAK,UAAU;IAC7B,GAAG,wBAAa,EAAG,UAAU;IAC7B,GAAG,uBAAY,EAAI,0EAA0E;CAC9F,CAAC;AAEF,oBAAoB;AACpB,IAAI,aAAK,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;IACxB,OAAO,CAAC,IAAI,CACV,8CAA8C,aAAK,CAAC,MAAM,QAAQ,CACnE,CAAC;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,+CAA6C;AAC7C,iDAAkD;AAClD,iDAAkD;AAClD,kDAAoD;AACpD,gDAAgD;AAChD,mDAAqD;AACrD,+CAAgD;AAEhD;;GAEG;AACU,QAAA,KAAK,GAAG;IACnB,GAAG,oBAAS,EAAO,UAAU;IAC7B,GAAG,uBAAY,EAAI,UAAU;IAC7B,GAAG,uBAAY,EAAI,UAAU;IAC7B,GAAG,wBAAa,EAAG,UAAU;IAC7B,GAAG,sBAAW,EAAK,UAAU;IAC7B,GAAG,wBAAa,EAAG,UAAU;IAC7B,GAAG,uBAAY,EAAI,kCAAkC;CACtD,CAAC;AAEF,oBAAoB;AACpB,IAAI,aAAK,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;IACxB,OAAO,CAAC,IAAI,CACV,8CAA8C,aAAK,CAAC,MAAM,QAAQ,CACnE,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,12 @@
+/**
+ * SDK Usage Explanation Tool
+ *
+ * Provides detailed explanations and code examples for using the Gala Launchpad SDK directly.
+ * Acts as a development reference showing how MCP tools map to SDK methods.
+ */
+import type { MCPTool } from '../../types/mcp.js';
+/**
+ * SDK Usage Explanation Tool
+ */
+export declare const explainSdkUsageTool: MCPTool;
+//# sourceMappingURL=explainSdkUsage.d.ts.map

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

@@ -0,0 +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;AAgkBlD;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,OA2DjC,CAAC"}

package/dist/tools/utils/explainSdkUsage.js

@@ -0,0 +1,634 @@
+"use strict";
+/**
+ * SDK Usage Explanation Tool
+ *
+ * Provides detailed explanations and code examples for using the Gala Launchpad SDK directly.
+ * Acts as a development reference showing how MCP tools map to SDK methods.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.explainSdkUsageTool = void 0;
+const error_handler_js_1 = require("../../utils/error-handler.js");
+const response_formatter_js_1 = require("../../utils/response-formatter.js");
+/**
+ * SDK code examples organized by topic
+ */
+const SDK_EXAMPLES = {
+    // Trading workflows
+    'buy-tokens': `
+## Buying Tokens with SDK
+
+\`\`\`typescript
+import { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';
+
+async function buyTokens() {
+  // 1. Create SDK instance
+  const sdk = createLaunchpadSDK({
+    wallet: 'your-private-key-or-mnemonic'
+  });
+
+  // 2. Calculate expected amounts FIRST (REQUIRED)
+  const calculation = await sdk.calculateBuyAmount({
+    tokenName: 'dragnrkti',
+    amount: '100',      // Spending 100 GALA
+    type: 'native'      // 'native' = GALA amount, 'exact' = token amount
+  });
+
+  console.log('Expected tokens:', calculation.amount);
+  console.log('RBC Fee:', calculation.reverseBondingCurveFee);
+  console.log('Transaction fee:', calculation.transactionFee);
+
+  // 3. Execute buy with slippage protection
+  const result = await sdk.buy({
+    tokenName: 'dragnrkti',
+    amount: '100',
+    type: 'native',
+    expectedAmount: calculation.amount,  // REQUIRED: from step 2
+    maxAcceptableReverseBondingCurveFee: calculation.reverseBondingCurveFee, // RECOMMENDED
+    slippageToleranceFactor: 0.01  // 1% slippage tolerance (REQUIRED)
+  });
+
+  console.log('Transaction ID:', result.transactionId);
+  console.log('GALA spent:', result.inputAmount);
+  console.log('Tokens received:', result.outputAmount);
+  console.log('Total fees:', result.totalFees);
+}
+\`\`\`
+
+**MCP Tool Equivalent:** \`gala_launchpad_buy_tokens\`
+`,
+    'sell-tokens': `
+## Selling Tokens with SDK
+
+\`\`\`typescript
+import { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';
+
+async function sellTokens() {
+  // 1. Create SDK instance
+  const sdk = createLaunchpadSDK({
+    wallet: 'your-private-key'
+  });
+
+  // 2. Calculate expected GALA FIRST (REQUIRED)
+  const calculation = await sdk.calculateSellAmount({
+    tokenName: 'dragnrkti',
+    amount: '1000',     // Selling 1000 tokens
+    type: 'exact'       // 'exact' = exact tokens, 'native' = target GALA amount
+  });
+
+  console.log('Expected GALA:', calculation.amount);
+  console.log('RBC Fee:', calculation.reverseBondingCurveFee);
+
+  // 3. Execute sell with slippage protection
+  const result = await sdk.sell({
+    tokenName: 'dragnrkti',
+    amount: '1000',
+    type: 'exact',
+    expectedAmount: calculation.amount,  // REQUIRED: from step 2
+    maxAcceptableReverseBondingCurveFee: calculation.reverseBondingCurveFee, // RECOMMENDED
+    slippageToleranceFactor: 0.01  // 1% slippage
+  });
+
+  console.log('Tokens sold:', result.inputAmount);
+  console.log('GALA received:', result.outputAmount);
+}
+\`\`\`
+
+**MCP Tool Equivalent:** \`gala_launchpad_sell_tokens\`
+`,
+    'pool-graduation': `
+## Pool Graduation with SDK
+
+\`\`\`typescript
+import { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';
+
+async function graduatePool() {
+  const sdk = createLaunchpadSDK({
+    wallet: 'your-private-key'
+  });
+
+  // Option 1: Calculate graduation cost first (recommended)
+  const calculation = await sdk.calculateBuyAmountForGraduation('dragnrkti');
+
+  console.log('GALA cost to graduate:', calculation.amount);
+  console.log('RBC Fee:', calculation.reverseBondingCurveFee);
+  console.log('Transaction fee:', calculation.transactionFee);
+
+  // Check if you have enough balance
+  const balance = await sdk.fetchGalaBalance();
+  if (parseFloat(balance.balance) < parseFloat(calculation.amount)) {
+    throw new Error('Insufficient GALA balance');
+  }
+
+  // Option 2: One-step graduation (convenience method)
+  const result = await sdk.graduateToken({
+    tokenName: 'dragnrkti',
+    slippageToleranceFactor: 0.01  // Optional: defaults to SDK config
+  });
+
+  console.log('Pool graduated!');
+  console.log('Transaction ID:', result.transactionId);
+  console.log('Total GALA spent:', result.inputAmount);
+  console.log('Tokens received:', result.outputAmount);
+}
+\`\`\`
+
+**MCP Tool Equivalents:**
+- \`gala_launchpad_calculate_buy_amount_for_graduation\`
+- \`gala_launchpad_graduate_token\`
+`,
+    'fetch-pools': `
+## Fetching Pool Data with SDK
+
+\`\`\`typescript
+import { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';
+
+async function fetchPools() {
+  const sdk = createLaunchpadSDK({
+    wallet: 'your-private-key'
+  });
+
+  // Fetch recent pools with pagination
+  const pools = await sdk.fetchPools({
+    type: 'recent',
+    limit: 10,
+    page: 1
+  });
+
+  console.log(\`Found \${pools.total} pools\`);
+  console.log(\`Page \${pools.page} of \${pools.totalPages}\`);
+  console.log(\`Has next page: \${pools.hasNext}\`);
+
+  pools.pools.forEach(pool => {
+    console.log(\`\${pool.tokenName}: \${pool.tokenSymbol}\`);
+    console.log(\`Creator: \${pool.creatorAddress}\`);
+    console.log(\`Created: \${pool.createdAt}\`);
+  });
+
+  // Fetch specific pool details
+  const details = await sdk.fetchPoolDetails('dragnrkti');
+
+  console.log('Sale status:', details.saleStatus);
+  console.log('Base price:', details.basePrice);
+  console.log('Max supply:', details.maxSupply);
+  console.log('Native token quantity:', details.nativeTokenQuantity);
+}
+\`\`\`
+
+**MCP Tool Equivalents:**
+- \`gala_launchpad_fetch_pools\`
+- \`gala_launchpad_fetch_pool_details\`
+`,
+    'balances': `
+## Checking Balances with SDK
+
+\`\`\`typescript
+import { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';
+
+async function checkBalances() {
+  const sdk = createLaunchpadSDK({
+    wallet: 'your-private-key'
+  });
+
+  // Check GALA balance
+  const galaBalance = await sdk.fetchGalaBalance();
+  console.log(\`GALA: \${galaBalance.balance}\`);
+  console.log(\`Decimals: \${galaBalance.decimals}\`);
+  console.log(\`Last updated: \${galaBalance.lastUpdated.toISOString()}\`);
+
+  // Check specific token balance
+  const tokenBalance = await sdk.fetchTokenBalance({
+    tokenName: 'dragnrkti',
+    address: sdk.getAddress()
+  });
+
+  console.log(\`Token: \${tokenBalance.quantity}\`);
+  console.log(\`USD value: $\${tokenBalance.holdingPriceUsd}\`);
+  console.log(\`GALA value: \${tokenBalance.holdingPriceGala}\`);
+
+  // Check all tokens held
+  const portfolio = await sdk.fetchTokensHeld({
+    address: sdk.getAddress(),
+    limit: 20
+  });
+
+  console.log(\`Holding \${portfolio.total} different tokens\`);
+  portfolio.tokens.forEach(token => {
+    console.log(\`\${token.name}: \${token.quantity}\`);
+  });
+}
+\`\`\`
+
+**MCP Tool Equivalents:**
+- \`gala_launchpad_fetch_gala_balance\`
+- \`gala_launchpad_fetch_token_balance\`
+- \`gala_launchpad_fetch_tokens_held\`
+`,
+    'token-creation': `
+## Creating Tokens with SDK
+
+\`\`\`typescript
+import { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';
+
+async function launchToken() {
+  const sdk = createLaunchpadSDK({
+    wallet: 'your-private-key'
+  });
+
+  // 1. Check if name/symbol available
+  const nameAvailable = await sdk.isTokenNameAvailable('mytoken');
+  const symbolAvailable = await sdk.isTokenSymbolAvailable('MTK');
+
+  if (!nameAvailable || !symbolAvailable) {
+    throw new Error('Name or symbol already taken');
+  }
+
+  // 2. Check launch fee
+  const launchFee = await sdk.fetchLaunchTokenFee();
+  console.log(\`Launch fee: \${launchFee} GALA\`);
+
+  // 3. Upload token image (Node.js only)
+  const imageUpload = await sdk.uploadTokenImage({
+    tokenName: 'mytoken',
+    imagePath: '/path/to/image.png'
+  });
+
+  // 4. Launch the token
+  const result = await sdk.launchToken({
+    tokenName: 'mytoken',
+    tokenSymbol: 'MTK',
+    tokenDescription: 'My awesome token',
+    tokenImage: imageUpload.imageUrl,
+    websiteUrl: 'https://mytoken.com',
+    twitterUrl: 'https://twitter.com/mytoken',
+    preBuyQuantity: '100'  // Optional: pre-buy with GALA
+  });
+
+  console.log('Token launched!');
+  console.log('Transaction ID:', result.transactionId);
+
+  // Get frontend URL
+  const url = sdk.getUrlByTokenName('mytoken');
+  console.log(\`View at: \${url}\`);
+}
+\`\`\`
+
+**MCP Tool Equivalents:**
+- \`gala_launchpad_check_token_name\`
+- \`gala_launchpad_check_token_symbol\`
+- \`gala_launchpad_fetch_launch_token_fee\`
+- \`gala_launchpad_upload_token_image\`
+- \`gala_launchpad_launch_token\`
+- \`gala_launchpad_get_url_by_token_name\`
+`,
+    'multi-wallet': `
+## Multi-Wallet Support with SDK
+
+\`\`\`typescript
+import { createLaunchpadSDK, createWallet } from '@gala-chain/launchpad-sdk';
+
+async function multiWalletExample() {
+  // Main SDK with your wallet
+  const sdk = createLaunchpadSDK({
+    wallet: 'your-main-private-key'
+  });
+
+  // Create a test wallet
+  const testWallet = createWallet();
+  console.log('Test wallet:', testWallet.address);
+
+  // 1. Fund test wallet from main wallet
+  await sdk.transferGala({
+    recipientAddress: testWallet.address,
+    amount: '1000'
+  });
+
+  // 2. Have test wallet buy tokens (using privateKey override)
+  const buyCalc = await sdk.calculateBuyAmount({
+    tokenName: 'dragnrkti',
+    amount: '100',
+    type: 'native'
+  });
+
+  const buyResult = await sdk.buy({
+    tokenName: 'dragnrkti',
+    amount: '100',
+    type: 'native',
+    expectedAmount: buyCalc.amount,
+    slippageToleranceFactor: 0.01,
+    privateKey: testWallet.privateKey  // Override to use test wallet
+  });
+
+  console.log('Test wallet bought tokens');
+
+  // 3. Have test wallet post comment
+  await sdk.postComment({
+    tokenName: 'dragnrkti',
+    content: 'Great project!',
+    privateKey: testWallet.privateKey  // Test wallet posts
+  });
+
+  // 4. Check balances for both wallets
+  const mainBalance = await sdk.fetchGalaBalance();  // Main wallet
+  const testBalance = await sdk.fetchGalaBalance(testWallet.address);  // Test wallet
+
+  console.log(\`Main wallet: \${mainBalance.balance} GALA\`);
+  console.log(\`Test wallet: \${testBalance.balance} GALA\`);
+}
+\`\`\`
+
+**Key Points:**
+- All signing operations support \`privateKey\` parameter
+- Creates temporary SDK instance internally
+- Supports: buy, sell, launchToken, transfers, comments, profile updates
+`,
+    'transfers': `
+## Token Transfers with SDK
+
+\`\`\`typescript
+import { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';
+
+async function transferTokens() {
+  const sdk = createLaunchpadSDK({
+    wallet: 'your-private-key'
+  });
+
+  // Transfer GALA tokens
+  const galaTransfer = await sdk.transferGala({
+    recipientAddress: '0x1234...', // or 'eth|1234...'
+    amount: '100',
+    uniqueKey: 'galaconnect-operation-my-transfer-123'  // Optional idempotency
+  });
+
+  console.log('GALA transfer ID:', galaTransfer.transactionId);
+  console.log('Status:', galaTransfer.status);
+
+  // Transfer launchpad tokens
+  const tokenTransfer = await sdk.transferToken({
+    to: 'eth|5678...',
+    tokenName: 'dragnrkti',
+    amount: '1000',  // Token amount
+    uniqueKey: 'galaconnect-operation-token-456'
+  });
+
+  console.log('Token transfer ID:', tokenTransfer.transactionId);
+}
+\`\`\`
+
+**Features:**
+- EIP-712 signatures for security
+- Supports both \`0x\` and \`eth|\` address formats
+- Optional idempotency keys prevent duplicates
+- Comprehensive validation
+
+**MCP Tool Equivalents:**
+- \`gala_launchpad_transfer_gala\`
+- \`gala_launchpad_transfer_token\`
+`,
+    'error-handling': `
+## Error Handling with SDK
+
+\`\`\`typescript
+import {
+  createLaunchpadSDK,
+  ValidationError,
+  NetworkError,
+  TransactionError,
+  TokenNotFoundError
+} from '@gala-chain/launchpad-sdk';
+
+async function errorHandlingExample() {
+  const sdk = createLaunchpadSDK({
+    wallet: 'your-private-key'
+  });
+
+  try {
+    // Attempt trade
+    const result = await sdk.buy({
+      tokenName: 'dragnrkti',
+      amount: '100',
+      type: 'native',
+      expectedAmount: '5000',
+      slippageToleranceFactor: 0.01
+    });
+
+    console.log('Success:', result.transactionId);
+
+  } catch (error) {
+    if (error instanceof ValidationError) {
+      console.error('Invalid input:', error.message);
+      console.error('Field:', error.field);
+      console.error('Code:', error.code);
+
+    } else if (error instanceof TokenNotFoundError) {
+      console.error('Token does not exist:', error.tokenName);
+
+    } catch if (error instanceof NetworkError) {
+      console.error('Network issue:', error.message);
+      console.error('Status code:', error.statusCode);
+
+    } else if (error instanceof TransactionError) {
+      console.error('Transaction failed:', error.message);
+      console.error('Transaction ID:', error.transactionId);
+
+    } else {
+      console.error('Unexpected error:', error);
+    }
+  }
+}
+\`\`\`
+
+**Error Types:**
+- \`ValidationError\` - Invalid input parameters
+- \`NetworkError\` - HTTP/network failures
+- \`TransactionError\` - Blockchain transaction failures
+- \`TokenNotFoundError\` - Token doesn't exist
+- \`ConfigurationError\` - SDK misconfiguration
+- \`WebSocketError\` - Real-time connection issues
+`,
+    'installation': `
+## Installing and Importing SDK
+
+### NPM Installation
+
+\`\`\`bash
+# Install SDK
+npm install @gala-chain/launchpad-sdk
+
+# Install peer dependencies
+npm install ethers@^6.15.0 @gala-chain/api@^2.4.3 @gala-chain/connect@^2.4.3 \\
+  socket.io-client@^4.8.1 axios@^1.12.2 bignumber.js@^9.1.2 zod@^3.25.76
+\`\`\`
+
+### Import Patterns
+
+\`\`\`typescript
+// Main SDK class
+import { LaunchpadSDK } from '@gala-chain/launchpad-sdk';
+
+// Helper functions (recommended)
+import {
+  createLaunchpadSDK,
+  createTestLaunchpadSDK,
+  createWallet,
+  validateWalletInput
+} from '@gala-chain/launchpad-sdk';
+
+// Error types
+import {
+  ValidationError,
+  NetworkError,
+  TransactionError,
+  TokenNotFoundError
+} from '@gala-chain/launchpad-sdk';
+
+// Type definitions
+import type {
+  PoolData,
+  TradeResult,
+  TokenBalanceInfo,
+  BuyTokenOptions,
+  SellTokenOptions
+} from '@gala-chain/launchpad-sdk';
+\`\`\`
+
+### Environment Configuration
+
+\`\`\`typescript
+// Development (default)
+const sdk = createLaunchpadSDK({
+  wallet: 'your-private-key',
+  config: {
+    baseUrl: 'https://lpad-backend-dev1.defi.gala.com',
+    debug: true
+  }
+});
+
+// Production
+const sdk = createLaunchpadSDK({
+  wallet: 'your-private-key',
+  config: {
+    baseUrl: 'https://lpad-backend-prod1.defi.gala.com',
+    debug: false,
+    timeout: 60000
+  }
+});
+\`\`\`
+`,
+    'mcp-to-sdk-mapping': `
+## MCP Tool to SDK Method Mapping
+
+### Trading Operations
+| MCP Tool | SDK Method | Notes |
+|----------|------------|-------|
+| \`gala_launchpad_calculate_buy_amount\` | \`sdk.calculateBuyAmount(options)\` | Get quote before buying |
+| \`gala_launchpad_calculate_sell_amount\` | \`sdk.calculateSellAmount(options)\` | Get quote before selling |
+| \`gala_launchpad_buy_tokens\` | \`sdk.buy(options)\` | Execute token purchase |
+| \`gala_launchpad_sell_tokens\` | \`sdk.sell(options)\` | Execute token sale |
+| \`gala_launchpad_graduate_token\` | \`sdk.graduateToken(options)\` | One-step pool graduation |
+
+### Pool Management
+| MCP Tool | SDK Method | Notes |
+|----------|------------|-------|
+| \`gala_launchpad_fetch_pools\` | \`sdk.fetchPools(options)\` | List pools with filtering |
+| \`gala_launchpad_fetch_pool_details\` | \`sdk.fetchPoolDetails(tokenName)\` | Get specific pool data |
+| \`gala_launchpad_fetch_token_distribution\` | \`sdk.fetchTokenDistribution(tokenName)\` | Holder distribution |
+| \`gala_launchpad_fetch_token_badges\` | \`sdk.fetchTokenBadges(tokenName)\` | Achievement badges |
+
+### Balance & Portfolio
+| MCP Tool | SDK Method | Notes |
+|----------|------------|-------|
+| \`gala_launchpad_fetch_gala_balance\` | \`sdk.fetchGalaBalance(address?)\` | GALA balance |
+| \`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 |
+
+### Token Creation
+| MCP Tool | SDK Method | Notes |
+|----------|------------|-------|
+| \`gala_launchpad_fetch_launch_token_fee\` | \`sdk.fetchLaunchTokenFee()\` | Get launch cost |
+| \`gala_launchpad_check_token_name\` | \`sdk.isTokenNameAvailable(name)\` | Check name |
+| \`gala_launchpad_check_token_symbol\` | \`sdk.isTokenSymbolAvailable(symbol)\` | Check symbol |
+| \`gala_launchpad_launch_token\` | \`sdk.launchToken(data)\` | Create token |
+| \`gala_launchpad_upload_token_image\` | \`sdk.uploadTokenImage(options)\` | Upload image |
+
+### Transfers & Social
+| MCP Tool | SDK Method | Notes |
+|----------|------------|-------|
+| \`gala_launchpad_transfer_gala\` | \`sdk.transferGala(options)\` | Transfer GALA |
+| \`gala_launchpad_transfer_token\` | \`sdk.transferToken(options)\` | Transfer tokens |
+| \`gala_launchpad_post_comment\` | \`sdk.postComment(options)\` | Post comment |
+| \`gala_launchpad_fetch_comments\` | \`sdk.fetchComments(options)\` | Get comments |
+
+### Utilities
+| MCP Tool | SDK Method | Notes |
+|----------|------------|-------|
+| \`gala_launchpad_create_wallet\` | \`createWallet()\` | Generate wallet |
+| \`gala_launchpad_get_address\` | \`sdk.getAddress()\` | Get backend format |
+| \`gala_launchpad_get_ethereum_address\` | \`sdk.getEthereumAddress()\` | Get 0x format |
+| \`gala_launchpad_get_url_by_token_name\` | \`sdk.getUrlByTokenName(name)\` | Frontend URL |
+
+**Key Difference:** MCP tools return \`{ success: true, data: {...} }\`, SDK methods return direct result objects.
+`,
+};
+/**
+ * SDK Usage Explanation Tool
+ */
+exports.explainSdkUsageTool = {
+    name: 'gala_launchpad_explain_sdk_usage',
+    description: `Get detailed SDK code examples and explanations for using the Gala Launchpad SDK directly.
+
+This tool provides complete, working code examples showing how to use the SDK instead of MCP tools.
+Perfect for developers who want to integrate the SDK into their applications.
+
+Available topics:
+- 'buy-tokens' - Complete buying workflow with calculation and execution
+- 'sell-tokens' - Complete selling workflow with slippage protection
+- 'pool-graduation' - Graduate a bonding curve pool
+- 'fetch-pools' - Query pool data and details
+- 'balances' - Check GALA and token balances
+- 'token-creation' - Launch new tokens
+- '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
+- 'mcp-to-sdk-mapping' - Complete mapping of MCP tools to SDK methods
+
+Returns runnable TypeScript code examples with explanations.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            topic: {
+                type: 'string',
+                enum: [
+                    'buy-tokens',
+                    'sell-tokens',
+                    'pool-graduation',
+                    'fetch-pools',
+                    'balances',
+                    'token-creation',
+                    'multi-wallet',
+                    'transfers',
+                    'error-handling',
+                    'installation',
+                    'mcp-to-sdk-mapping',
+                ],
+                description: 'The SDK usage topic to explain',
+            },
+        },
+        required: ['topic'],
+    },
+    handler: (0, error_handler_js_1.withErrorHandling)(async (_sdk, args) => {
+        const example = SDK_EXAMPLES[args.topic];
+        if (!example) {
+            throw new Error(`Unknown topic: ${args.topic}`);
+        }
+        return (0, response_formatter_js_1.formatSuccess)({
+            topic: args.topic,
+            explanation: example,
+            sdkVersion: '3.7.5',
+            packageName: '@gala-chain/launchpad-sdk',
+            documentation: 'https://www.npmjs.com/package/@gala-chain/launchpad-sdk',
+        });
+    }),
+};
+//# sourceMappingURL=explainSdkUsage.js.map

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

@@ -0,0 +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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsDvB;CACA,CAAC;AAEF;;GAEG;AACU,QAAA,mBAAmB,GAAY;IAC1C,IAAI,EAAE,kCAAkC;IACxC,WAAW,EAAE;;;;;;;;;;;;;;;;;;6DAkB8C;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,gBAAgB;oBAChB,cAAc;oBACd,WAAW;oBACX,gBAAgB;oBAChB,cAAc;oBACd,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,OAAO;YACnB,WAAW,EAAE,2BAA2B;YACxC,aAAa,EAAE,yDAAyD;SACzE,CAAC,CAAC;IACL,CAAC,CAAC;CACH,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,eAAO,MAAM,YAAY,wCAMxB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,eAAO,MAAM,YAAY,wCAOxB,CAAC"}

package/dist/tools/utils/index.js

@@ -9,11 +9,13 @@ const getAddress_js_1 = require("./getAddress.js");
 const getEthereumAddress_js_1 = require("./getEthereumAddress.js");
 const getConfig_js_1 = require("./getConfig.js");
 const getUrlByTokenName_js_1 = require("./getUrlByTokenName.js");
+const explainSdkUsage_js_1 = require("./explainSdkUsage.js");
 exports.utilityTools = [
     createWallet_js_1.createWalletTool,
     getAddress_js_1.getAddressTool,
     getEthereumAddress_js_1.getEthereumAddressTool,
     getConfig_js_1.getConfigTool,
     getUrlByTokenName_js_1.getUrlByTokenNameTool,
+    explainSdkUsage_js_1.explainSdkUsageTool,
 ];
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/utils/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,uDAAqD;AACrD,mDAAiD;AACjD,mEAAiE;AACjE,iDAA+C;AAC/C,iEAA+D;AAElD,QAAA,YAAY,GAAG;IAC1B,kCAAgB;IAChB,8BAAc;IACd,8CAAsB;IACtB,4BAAa;IACb,4CAAqB;CACtB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/utils/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,uDAAqD;AACrD,mDAAiD;AACjD,mEAAiE;AACjE,iDAA+C;AAC/C,iEAA+D;AAC/D,6DAA2D;AAE9C,QAAA,YAAY,GAAG;IAC1B,kCAAgB;IAChB,8BAAc;IACd,8CAAsB;IACtB,4BAAa;IACb,4CAAqB;IACrB,wCAAmB;CACpB,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gala-chain/launchpad-mcp-server",
-  "version": "1.2.19",
-  "description": "MCP server for Gala Launchpad SDK with 40 tools - AI agents can interact with Gala Launchpad",
+  "version": "1.2.21",
+  "description": "MCP server for Gala Launchpad SDK with 41 tools - AI agents can interact with Gala Launchpad and learn SDK usage",
   "main": "dist/index.js",
   "bin": {
     "gala-launchpad-mcp": "./dist/index.js"
@@ -56,7 +56,7 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@gala-chain/launchpad-sdk": "^3.7.5",
+    "@gala-chain/launchpad-sdk": "^3.7.6",
     "@modelcontextprotocol/sdk": "^0.5.0",
     "ethers": "^6.15.0",
     "@gala-chain/api": "^2.4.3",

package/test-explain.mjs

@@ -0,0 +1,73 @@
+#!/usr/bin/env node
+import { spawn } from 'child_process';
+
+const PRIVATE_KEY = '0x1234567890123456789012345678901234567890123456789012345678901234';
+
+const serverProcess = spawn('node', ['dist/index.js'], {
+  env: { ...process.env, PRIVATE_KEY }
+});
+
+let responseBuffer = '';
+
+serverProcess.stdout.on('data', (data) => {
+  responseBuffer += data.toString();
+
+  // Try to parse JSON-RPC messages
+  const lines = responseBuffer.split('\n');
+  responseBuffer = lines.pop(); // Keep incomplete line
+
+  for (const line of lines) {
+    if (!line.trim()) continue;
+    try {
+      const response = JSON.parse(line);
+      if (response.result?.success) {
+        console.log('\n✅ explainSdkUsage Tool Response:');
+        console.log('Topic:', response.result.data.topic);
+        console.log('SDK Version:', response.result.data.sdkVersion);
+        console.log('\nExplanation Preview:');
+        console.log(response.result.data.explanation.substring(0, 500) + '...\n');
+        serverProcess.kill();
+        process.exit(0);
+      }
+    } catch (e) {
+      // Ignore parse errors
+    }
+  }
+});
+
+serverProcess.stderr.on('data', (data) => {
+  console.error('Error:', data.toString());
+});
+
+// Initialize
+serverProcess.stdin.write(JSON.stringify({
+  jsonrpc: '2.0',
+  id: 1,
+  method: 'initialize',
+  params: {
+    protocolVersion: '2024-11-05',
+    capabilities: {}
+  }
+}) + '\n');
+
+// Wait a bit then call the tool
+setTimeout(() => {
+  serverProcess.stdin.write(JSON.stringify({
+    jsonrpc: '2.0',
+    id: 2,
+    method: 'tools/call',
+    params: {
+      name: 'gala_launchpad_explain_sdk_usage',
+      arguments: {
+        topic: 'buy-tokens'
+      }
+    }
+  }) + '\n');
+}, 1000);
+
+// Timeout after 5 seconds
+setTimeout(() => {
+  console.error('❌ Test timed out');
+  serverProcess.kill();
+  process.exit(1);
+}, 5000);