@gala-chain/launchpad-mcp-server 1.22.4 → 1.23.0

package/src/tools/trading/index.ts

@@ -0,0 +1,605 @@
+/**
+ * Trading Operations Tools
+ */
+
+import { TRADING_TYPES } from '@gala-chain/launchpad-sdk';
+import type { MCPTool } from '../../types/mcp.js';
+import { formatSuccess } from '../../utils/response-formatter.js';
+import { withErrorHandling } from '../../utils/error-handler.js';
+import {
+  TOKEN_NAME_SCHEMA,
+  DECIMAL_AMOUNT_SCHEMA,
+  PRIVATE_KEY_SCHEMA,
+  ADDRESS_SCHEMA,
+  PAGE_SCHEMA,
+  createLimitSchema,
+  TRANSACTION_ID_SCHEMA,
+  DATE_TIME_SCHEMA,
+  SORT_ORDER_SCHEMA,
+  SLIPPAGE_TOLERANCE_SCHEMA,
+  RBC_FEE_SLIPPAGE_SCHEMA,
+  CALCULATION_MODE_SCHEMA,
+  CURRENT_SUPPLY_SCHEMA,
+} from '../../schemas/common-schemas.js';
+import { applyOperationPaginationDefaults } from '../../utils/default-values.js';
+
+// 1. Calculate Buy Amount
+export const calculateBuyAmountTool: MCPTool = {
+  name: 'gala_launchpad_calculate_buy_amount',
+  description: 'Calculate token amounts for buying with fee breakdown',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      tokenName: TOKEN_NAME_SCHEMA,
+      amount: {
+        ...DECIMAL_AMOUNT_SCHEMA,
+        description: 'Amount in standard decimal format (e.g., "1" for 1 GALA)',
+      },
+      type: {
+        type: 'string',
+        enum: Object.values(TRADING_TYPES),
+        description: `Trade calculation type:
+
+- 'native': You specify GALA amount to spend
+  Example: "I want to spend 10 GALA to buy tokens" → type: 'native', amount: '10'
+
+- 'exact': You specify exact token amount to buy
+  Example: "I want to buy exactly 1000 WOO tokens" → type: 'exact', amount: '1000'
+
+Most common: Use 'native' when you know how much GALA to spend`,
+      },
+    },
+    required: ['tokenName', 'amount', 'type'],
+  },
+  handler: withErrorHandling(async (sdk, args) => {
+    const result = await sdk.calculateBuyAmount({
+      tokenName: args.tokenName,
+      amount: args.amount,
+      type: args.type,
+    });
+    return formatSuccess(result);
+  }),
+};
+
+// 2. Calculate Sell Amount
+export const calculateSellAmountTool: MCPTool = {
+  name: 'gala_launchpad_calculate_sell_amount',
+  description: 'Calculate GALA amounts for selling tokens',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      tokenName: TOKEN_NAME_SCHEMA,
+      amount: DECIMAL_AMOUNT_SCHEMA,
+      type: {
+        type: 'string',
+        enum: Object.values(TRADING_TYPES),
+        description: `Trade calculation type:
+
+- 'native': You specify GALA amount you want to receive
+  Example: "I want to receive 10 GALA from selling tokens" → type: 'native', amount: '10'
+
+- 'exact': You specify exact token amount to sell
+  Example: "I want to sell exactly 1000 WOO tokens" → type: 'exact', amount: '1000'
+
+Most common: Use 'native' when you know how much GALA you want to receive`,
+      },
+    },
+    required: ['tokenName', 'amount', 'type'],
+  },
+  handler: withErrorHandling(async (sdk, args) => {
+    const result = await sdk.calculateSellAmount({
+      tokenName: args.tokenName,
+      amount: args.amount,
+      type: args.type,
+    });
+    return formatSuccess(result);
+  }),
+};
+
+// 3. Buy Tokens
+export const buyTokensTool: MCPTool = {
+  name: 'gala_launchpad_buy_tokens',
+  description: `Execute token purchase with slippage protection.
+
+WORKFLOW:
+1. calculateBuyAmount() → Get expected output (result.amount AND result.reverseBondingCurveFee)
+2. buy() → Execute trade with BOTH expectedAmount AND maxAcceptableReverseBondingCurveFee
+3. fetchTrades() → Verify trade completed
+
+CRITICAL: Extract BOTH parameters from calculateBuyAmount:
+- result.amount → expectedAmount
+- result.reverseBondingCurveFee → maxAcceptableReverseBondingCurveFee
+Omitting reverseBondingCurveFee may cause transaction failures!
+
+RETURNS: Transaction details including input/output amounts and transaction ID`,
+  inputSchema: {
+    type: 'object',
+    properties: {
+      tokenName: TOKEN_NAME_SCHEMA,
+      amount: {
+        ...DECIMAL_AMOUNT_SCHEMA,
+        description: 'Amount to spend/buy',
+      },
+      type: {
+        type: 'string',
+        enum: Object.values(TRADING_TYPES),
+        description: `Trade type (must match what you used in calculateBuyAmount):
+
+- 'native': Spending GALA amount
+- 'exact': Buying exact token amount`,
+      },
+      expectedAmount: {
+        ...DECIMAL_AMOUNT_SCHEMA,
+        description: `Expected token output amount from calculateBuyAmount (REQUIRED).
+
+CRITICAL: This is the 'amount' field from calculateBuyAmount result, NOT your input amount.
+
+WORKFLOW:
+1. Call calculateBuyAmount({ tokenName, amount, type })
+2. Extract result.amount from the response
+3. Use result.amount as this expectedAmount parameter
+
+EXAMPLE:
+const calc = await calculateBuyAmount({ tokenName: 'woohoo', amount: '10', type: 'native' });
+// calc.amount = "16843.7579794843252"
+await buy({ tokenName: 'woohoo', amount: '10', type: 'native', expectedAmount: calc.amount, ... });
+// Use calc.amount ("16843.7579794843252"), NOT the input '10'`,
+      },
+      maxAcceptableReverseBondingCurveFee: {
+        ...DECIMAL_AMOUNT_SCHEMA,
+        description: 'RECOMMENDED: Base reverse bonding curve fee from calculateBuyAmount (GALA). Use result.reverseBondingCurveFee. Omitting this may cause transaction failures. Works with maxAcceptableReverseBondingCurveFeeSlippageFactor for automatic slippage adjustment.',
+      },
+      maxAcceptableReverseBondingCurveFeeSlippageFactor: RBC_FEE_SLIPPAGE_SCHEMA,
+      slippageToleranceFactor: SLIPPAGE_TOLERANCE_SCHEMA,
+      privateKey: PRIVATE_KEY_SCHEMA,
+    },
+    required: ['tokenName', 'amount', 'type', 'expectedAmount', 'slippageToleranceFactor'],
+  },
+  handler: withErrorHandling(async (sdk, args) => {
+    const result = await sdk.buy({
+      tokenName: args.tokenName,
+      amount: args.amount,
+      type: args.type,
+      expectedAmount: args.expectedAmount,
+      maxAcceptableReverseBondingCurveFee: args.maxAcceptableReverseBondingCurveFee,
+      maxAcceptableReverseBondingCurveFeeSlippageFactor: args.maxAcceptableReverseBondingCurveFeeSlippageFactor,
+      slippageToleranceFactor: args.slippageToleranceFactor,
+      privateKey: args.privateKey,
+    });
+    return formatSuccess(result);
+  }),
+};
+
+// 4. Sell Tokens
+export const sellTokensTool: MCPTool = {
+  name: 'gala_launchpad_sell_tokens',
+  description: `Execute token sale with slippage protection.
+
+WORKFLOW:
+1. calculateSellAmount() → Get expected output (result.amount AND result.reverseBondingCurveFee)
+2. sell() → Execute trade with BOTH expectedAmount AND maxAcceptableReverseBondingCurveFee
+3. fetchTrades() → Verify trade completed
+
+CRITICAL: Extract BOTH parameters from calculateSellAmount:
+- result.amount → expectedAmount
+- result.reverseBondingCurveFee → maxAcceptableReverseBondingCurveFee
+Omitting reverseBondingCurveFee may cause transaction failures!
+
+RETURNS: Transaction details including input/output amounts and transaction ID`,
+  inputSchema: {
+    type: 'object',
+    properties: {
+      tokenName: TOKEN_NAME_SCHEMA,
+      amount: {
+        ...DECIMAL_AMOUNT_SCHEMA,
+        description: 'Amount to sell/receive',
+      },
+      type: {
+        type: 'string',
+        enum: Object.values(TRADING_TYPES),
+        description: `Trade type (must match what you used in calculateSellAmount):
+
+- 'native': Receiving GALA amount
+- 'exact': Selling exact token amount`,
+      },
+      expectedAmount: {
+        ...DECIMAL_AMOUNT_SCHEMA,
+        description: `Expected GALA output amount from calculateSellAmount (REQUIRED).
+
+CRITICAL: This is the 'amount' field from calculateSellAmount result, NOT your input amount.
+
+WORKFLOW:
+1. Call calculateSellAmount({ tokenName, amount, type })
+2. Extract result.amount from the response
+3. Use result.amount as this expectedAmount parameter
+
+EXAMPLE:
+const calc = await calculateSellAmount({ tokenName: 'woohoo', amount: '10', type: 'native' });
+// calc.amount = "16843.7579794843252"
+await sell({ tokenName: 'woohoo', amount: '10', type: 'native', expectedAmount: calc.amount, ... });
+// Use calc.amount ("16843.7579794843252"), NOT the input '10'`,
+      },
+      maxAcceptableReverseBondingCurveFee: {
+        ...DECIMAL_AMOUNT_SCHEMA,
+        description: 'RECOMMENDED: Base reverse bonding curve fee from calculateSellAmount (GALA). Use result.reverseBondingCurveFee. Omitting this may cause transaction failures. Works with maxAcceptableReverseBondingCurveFeeSlippageFactor for automatic slippage adjustment.',
+      },
+      maxAcceptableReverseBondingCurveFeeSlippageFactor: RBC_FEE_SLIPPAGE_SCHEMA,
+      slippageToleranceFactor: SLIPPAGE_TOLERANCE_SCHEMA,
+      privateKey: PRIVATE_KEY_SCHEMA,
+    },
+    required: ['tokenName', 'amount', 'type', 'expectedAmount', 'slippageToleranceFactor'],
+  },
+  handler: withErrorHandling(async (sdk, args) => {
+    const result = await sdk.sell({
+      tokenName: args.tokenName,
+      amount: args.amount,
+      type: args.type,
+      expectedAmount: args.expectedAmount,
+      maxAcceptableReverseBondingCurveFee: args.maxAcceptableReverseBondingCurveFee,
+      maxAcceptableReverseBondingCurveFeeSlippageFactor: args.maxAcceptableReverseBondingCurveFeeSlippageFactor,
+      slippageToleranceFactor: args.slippageToleranceFactor,
+      privateKey: args.privateKey,
+    });
+    return formatSuccess(result);
+  }),
+};
+
+// 5. Fetch Trades
+export const fetchTradesTool: MCPTool = {
+  name: 'gala_launchpad_fetch_trades',
+  description: 'Get trade history with filtering',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      tokenName: TOKEN_NAME_SCHEMA,
+      tradeType: {
+        type: 'string',
+        enum: ['BUY', 'SELL'],
+        description: 'Filter by trade type',
+      },
+      userAddress: {
+        ...ADDRESS_SCHEMA,
+        description: 'Filter by user address',
+      },
+      page: PAGE_SCHEMA,
+      limit: createLimitSchema('trade', 20),
+      startDate: {
+        ...DATE_TIME_SCHEMA,
+        description: 'Filter by start date',
+      },
+      endDate: {
+        ...DATE_TIME_SCHEMA,
+        description: 'Filter by end date',
+      },
+      sortOrder: SORT_ORDER_SCHEMA,
+    },
+  },
+  handler: withErrorHandling(async (sdk, args) => {
+    const pagination = applyOperationPaginationDefaults(args, 'trade');
+    const result = await sdk.fetchTrades({
+      tokenName: args.tokenName,
+      tradeType: args.tradeType,
+      userAddress: args.userAddress,
+      ...pagination,
+      startDate: args.startDate,
+      endDate: args.endDate,
+      sortOrder: args.sortOrder || 'DESC',
+    });
+    return formatSuccess(result);
+  }),
+};
+
+// 6. Calculate Initial Buy
+export const calculateInitialBuyTool: MCPTool = {
+  name: 'gala_launchpad_calculate_initial_buy',
+  description: 'Calculate amounts for initial token purchase during creation (pre-mint phase)',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      amount: {
+        ...DECIMAL_AMOUNT_SCHEMA,
+        description: 'GALA amount to spend for initial buy (standard decimal format, e.g., "100" for 100 GALA)',
+      },
+    },
+    required: ['amount'],
+  },
+  handler: withErrorHandling(async (sdk, args) => {
+    const result = await sdk.calculateInitialBuyAmount(args.amount);
+    return formatSuccess(result);
+  }),
+};
+
+// 7. Get Bundler Transaction Result
+export const getBundlerTransactionResultTool: MCPTool = {
+  name: 'gala_launchpad_get_bundler_transaction_result',
+  description: `Get bundle transaction result by ID via HTTP (not WebSocket).
+
+Returns lightweight status: { id: string, method: string, status: string }
+
+Status values: "COMPLETED", "FAILED", "PENDING", "PROCESSING"
+
+Use cases:
+- Check transaction status when WebSocket times out
+- Get definitive transaction state
+- Verify trade/launch completion
+
+Note: This is a synchronous HTTP call, not WebSocket monitoring.`,
+  inputSchema: {
+    type: 'object',
+    properties: {
+      transactionId: TRANSACTION_ID_SCHEMA,
+    },
+    required: ['transactionId'],
+  },
+  handler: withErrorHandling(async (sdk, args) => {
+    const result = await sdk.getBundlerTransactionResult(args.transactionId);
+    return formatSuccess(result);
+  }),
+};
+
+// 8. Calculate Buy Amount for Graduation
+export const calculateBuyAmountForGraduationTool: MCPTool = {
+  name: 'gala_launchpad_calculate_buy_amount_for_graduation',
+  description: `Calculate amount needed to graduate a token pool.
+
+Convenience method that:
+1. Fetches pool details to get remaining tokens
+2. Calls calculateBuyAmount with exact remaining amount
+3. Returns standard AmountCalculationResult
+
+Performance optimization: Provide currentSupply to avoid fetching pool details twice.
+
+RETURNS: Same as calculateBuyAmount - complete cost breakdown including
+totalCost, amount, transactionFee, gasFee, reverseBondingCurveFee`,
+  inputSchema: {
+    type: 'object',
+    properties: {
+      tokenName: TOKEN_NAME_SCHEMA,
+      calculateAmountMode: CALCULATION_MODE_SCHEMA,
+      currentSupply: CURRENT_SUPPLY_SCHEMA,
+    },
+    required: ['tokenName'],
+  },
+  handler: withErrorHandling(async (sdk, args) => {
+    // Build options object only if mode or supply provided
+    const options = args.calculateAmountMode || args.currentSupply
+      ? {
+          tokenName: args.tokenName,
+          calculateAmountMode: args.calculateAmountMode,
+          currentSupply: args.currentSupply,
+        }
+      : args.tokenName;
+
+    const result = await sdk.calculateBuyAmountForGraduation(options);
+    return formatSuccess(result);
+  }),
+};
+
+// 9. Graduate Token
+export const graduateTokenTool: MCPTool = {
+  name: 'gala_launchpad_graduate_token',
+  description: `Graduate a token pool by buying all remaining tokens in one transaction.
+
+WORKFLOW (automatic):
+1. Calls calculateBuyAmountForGraduation() internally
+2. Executes buy() with exact remaining token amount
+3. Returns transaction result
+
+Performance optimization: Provide currentSupply to avoid fetching pool details twice.
+
+CRITICAL: This is a convenience method that combines multiple operations.
+Throws error if token is already graduated.
+slippageToleranceFactor is optional and uses SDK defaults if not provided.
+
+RETURNS: TradeResult with transaction details including amounts and transaction ID`,
+  inputSchema: {
+    type: 'object',
+    properties: {
+      tokenName: TOKEN_NAME_SCHEMA,
+      slippageToleranceFactor: SLIPPAGE_TOLERANCE_SCHEMA,
+      maxAcceptableReverseBondingCurveFeeSlippageFactor: RBC_FEE_SLIPPAGE_SCHEMA,
+      privateKey: PRIVATE_KEY_SCHEMA,
+      calculateAmountMode: CALCULATION_MODE_SCHEMA,
+      currentSupply: CURRENT_SUPPLY_SCHEMA,
+    },
+    required: ['tokenName'],  // Only tokenName is required
+  },
+  handler: withErrorHandling(async (sdk, args) => {
+    const result = await sdk.graduateToken({
+      tokenName: args.tokenName,
+      slippageToleranceFactor: args.slippageToleranceFactor,
+      maxAcceptableReverseBondingCurveFeeSlippageFactor: args.maxAcceptableReverseBondingCurveFeeSlippageFactor,
+      privateKey: args.privateKey,
+      calculateAmountMode: args.calculateAmountMode,
+      currentSupply: args.currentSupply,
+    });
+    return formatSuccess(result);
+  }),
+};
+
+// 10. Calculate Buy Amount (Local)
+export const calculateBuyAmountLocalTool: MCPTool = {
+  name: 'gala_launchpad_calculate_buy_amount_local',
+  description: `Calculate buy amounts using LOCAL bonding curve formulas (instant, no network call).
+
+Uses client-side exponential bonding curve calculations for instant quotes.
+Perfect for price discovery, UI updates, and offline scenarios.
+
+ACCURACY: Matches external calculations with <0.01% difference.
+
+RETURNS: { amount, reverseBondingCurveFee: "0", transactionFee, gasFee }`,
+  inputSchema: {
+    type: 'object',
+    properties: {
+      tokenName: TOKEN_NAME_SCHEMA,
+      amount: {
+        ...DECIMAL_AMOUNT_SCHEMA,
+        description: 'Amount in standard decimal format (e.g., "1" for 1 GALA)',
+      },
+      type: {
+        type: 'string',
+        enum: Object.values(TRADING_TYPES),
+        description: `Trade calculation type:
+- 'native': Spend GALA amount
+- 'exact': Buy exact token amount`,
+      },
+    },
+    required: ['tokenName', 'amount', 'type'],
+  },
+  handler: withErrorHandling(async (sdk, args) => {
+    const result = await sdk.calculateBuyAmountLocal({
+      tokenName: args.tokenName,
+      amount: args.amount,
+      type: args.type,
+    });
+    return formatSuccess(result);
+  }),
+};
+
+// 11. Calculate Buy Amount (External)
+export const calculateBuyAmountExternalTool: MCPTool = {
+  name: 'gala_launchpad_calculate_buy_amount_external',
+  description: `Calculate buy amounts using EXTERNAL GalaChain network call (real-time).
+
+Explicit external calculation - queries GalaChain network for real-time pricing.
+Identical to calculateBuyAmount but makes the network dependency explicit.
+
+RETURNS: { amount, reverseBondingCurveFee, transactionFee, gasFee }`,
+  inputSchema: {
+    type: 'object',
+    properties: {
+      tokenName: TOKEN_NAME_SCHEMA,
+      amount: {
+        ...DECIMAL_AMOUNT_SCHEMA,
+        description: 'Amount in standard decimal format',
+      },
+      type: {
+        type: 'string',
+        enum: Object.values(TRADING_TYPES),
+        description: `Trade calculation type:
+- 'native': Spend GALA amount
+- 'exact': Buy exact token amount`,
+      },
+    },
+    required: ['tokenName', 'amount', 'type'],
+  },
+  handler: withErrorHandling(async (sdk, args) => {
+    const result = await sdk.calculateBuyAmountExternal({
+      tokenName: args.tokenName,
+      amount: args.amount,
+      type: args.type,
+    });
+    return formatSuccess(result);
+  }),
+};
+
+// 12. Calculate Sell Amount (Local)
+export const calculateSellAmountLocalTool: MCPTool = {
+  name: 'gala_launchpad_calculate_sell_amount_local',
+  description: `Calculate sell amounts using LOCAL bonding curve formulas (instant, no network call).
+
+Uses client-side calculations with reverse bonding curve fee support.
+Requires pool details (maxSupply, fee parameters) to calculate accurately.
+
+ACCURACY: Matches external calculations with <0.01% difference.
+
+RETURNS: { amount, reverseBondingCurveFee, transactionFee, gasFee }`,
+  inputSchema: {
+    type: 'object',
+    properties: {
+      tokenName: TOKEN_NAME_SCHEMA,
+      amount: {
+        ...DECIMAL_AMOUNT_SCHEMA,
+        description: 'Amount to sell/receive',
+      },
+      type: {
+        type: 'string',
+        enum: Object.values(TRADING_TYPES),
+        description: `Trade calculation type:
+- 'native': Receive GALA amount
+- 'exact': Sell exact token amount`,
+      },
+      maxSupply: {
+        ...DECIMAL_AMOUNT_SCHEMA,
+        description: 'Token maximum supply (get from fetchPoolDetails)',
+      },
+      reverseBondingCurveMinFeeFactor: {
+        type: 'number',
+        minimum: 0,
+        maximum: 1,
+        description: 'Min reverse bonding curve fee factor (get from poolDetails.reverseBondingCurveMinFeeFactor)',
+      },
+      reverseBondingCurveMaxFeeFactor: {
+        type: 'number',
+        minimum: 0,
+        maximum: 1,
+        description: 'Max reverse bonding curve fee factor (get from poolDetails.reverseBondingCurveMaxFeeFactor)',
+      },
+    },
+    required: ['tokenName', 'amount', 'type', 'maxSupply', 'reverseBondingCurveMinFeeFactor', 'reverseBondingCurveMaxFeeFactor'],
+  },
+  handler: withErrorHandling(async (sdk, args) => {
+    const result = await sdk.calculateSellAmountLocal({
+      tokenName: args.tokenName,
+      amount: args.amount,
+      type: args.type,
+      maxSupply: args.maxSupply,
+      reverseBondingCurveMinFeeFactor: args.reverseBondingCurveMinFeeFactor,
+      reverseBondingCurveMaxFeeFactor: args.reverseBondingCurveMaxFeeFactor,
+    });
+    return formatSuccess(result);
+  }),
+};
+
+// 13. Calculate Sell Amount (External)
+export const calculateSellAmountExternalTool: MCPTool = {
+  name: 'gala_launchpad_calculate_sell_amount_external',
+  description: `Calculate sell amounts using EXTERNAL GalaChain network call (real-time).
+
+Explicit external calculation - queries GalaChain network for real-time pricing.
+Identical to calculateSellAmount but makes the network dependency explicit.
+
+RETURNS: { amount, reverseBondingCurveFee, transactionFee, gasFee }`,
+  inputSchema: {
+    type: 'object',
+    properties: {
+      tokenName: TOKEN_NAME_SCHEMA,
+      amount: {
+        ...DECIMAL_AMOUNT_SCHEMA,
+        description: 'Amount to sell/receive',
+      },
+      type: {
+        type: 'string',
+        enum: Object.values(TRADING_TYPES),
+        description: `Trade calculation type:
+- 'native': Receive GALA amount
+- 'exact': Sell exact token amount`,
+      },
+    },
+    required: ['tokenName', 'amount', 'type'],
+  },
+  handler: withErrorHandling(async (sdk, args) => {
+    const result = await sdk.calculateSellAmountExternal({
+      tokenName: args.tokenName,
+      amount: args.amount,
+      type: args.type,
+    });
+    return formatSuccess(result);
+  }),
+};
+
+export const tradingTools: MCPTool[] = [
+  calculateBuyAmountTool,
+  calculateSellAmountTool,
+  buyTokensTool,
+  sellTokensTool,
+  fetchTradesTool,
+  calculateInitialBuyTool,
+  getBundlerTransactionResultTool,
+  calculateBuyAmountForGraduationTool,
+  graduateTokenTool,
+  calculateBuyAmountLocalTool,
+  calculateBuyAmountExternalTool,
+  calculateSellAmountLocalTool,
+  calculateSellAmountExternalTool,
+];

package/src/tools/transfers/index.ts

@@ -0,0 +1,75 @@
+/**
+ * Token Transfer Tools
+ */
+
+import type { MCPTool } from '../../types/mcp.js';
+import { formatSuccess } from '../../utils/response-formatter.js';
+import { withErrorHandling } from '../../utils/error-handler.js';
+import {
+  ADDRESS_SCHEMA,
+  TOKEN_NAME_SCHEMA,
+  DECIMAL_AMOUNT_SCHEMA,
+  INTEGER_AMOUNT_SCHEMA,
+  UNIQUE_KEY_SCHEMA,
+  PRIVATE_KEY_SCHEMA,
+} from '../../schemas/common-schemas.js';
+
+// 1. Transfer GALA
+export const transferGalaTool: MCPTool = {
+  name: 'gala_launchpad_transfer_gala',
+  description: 'Transfer GALA tokens via GalaChain',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      recipientAddress: {
+        ...ADDRESS_SCHEMA,
+        description: 'Recipient wallet address',
+      },
+      amount: DECIMAL_AMOUNT_SCHEMA,
+      uniqueKey: UNIQUE_KEY_SCHEMA,
+      privateKey: PRIVATE_KEY_SCHEMA,
+    },
+    required: ['recipientAddress', 'amount'],
+  },
+  handler: withErrorHandling(async (sdk, args) => {
+    const result = await sdk.transferGala({
+      recipientAddress: args.recipientAddress,
+      amount: args.amount,
+      uniqueKey: args.uniqueKey,
+      privateKey: args.privateKey,
+    });
+    return formatSuccess(result);
+  }),
+};
+
+// 2. Transfer Token
+export const transferTokenTool: MCPTool = {
+  name: 'gala_launchpad_transfer_token',
+  description: 'Transfer launchpad tokens via GalaChain',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      to: {
+        ...ADDRESS_SCHEMA,
+        description: 'Recipient wallet address',
+      },
+      tokenName: TOKEN_NAME_SCHEMA,
+      amount: INTEGER_AMOUNT_SCHEMA,
+      uniqueKey: UNIQUE_KEY_SCHEMA,
+      privateKey: PRIVATE_KEY_SCHEMA,
+    },
+    required: ['to', 'tokenName', 'amount'],
+  },
+  handler: withErrorHandling(async (sdk, args) => {
+    const result = await sdk.transferToken({
+      to: args.to,
+      tokenName: args.tokenName,
+      amount: args.amount,
+      uniqueKey: args.uniqueKey,
+      privateKey: args.privateKey,
+    });
+    return formatSuccess(result);
+  }),
+};
+
+export const transferTools: MCPTool[] = [transferGalaTool, transferTokenTool];