gswap toolset: tools and prompts
The gswap toolset of @gala-chain/gala-mcp-server 1.0.0 provides GSwap DEX quotes, swaps, pools, liquidity positions, fees, market prices and the leaderboard. It defines 32 tools and 34 prompts. A prompt is offered only when every tool it names is registered by the selection.
The same data, with every parameter's type and description, is at /mcp/gswap/tools.json. * marks a required parameter. Tools whose description says they need authentication need a wallet in full-access mode.
Tools
swap
| Tool | What it does | Auth | Parameters |
|---|---|---|---|
gala_get_swap_quote_exact_input | Get a v6 GSwap quote for an exact input amount through gswap-sdk (gSwap.quoting.quoteExactInput) | no | fromToken, toToken, amount*, fee |
gala_get_swap_quote_exact_output | Get a v6 GSwap quote for an exact output amount through gswap-sdk (gSwap.quoting.quoteExactOutput) | no | fromToken, toToken, amount*, fee |
gala_execute_swap | Execute a GSwap trade through gswap-sdk (gSwap.swaps.swap) and return its confirmation result | no | fromToken, toToken, inputAmount, estimatedOutput, feeTier*, slippageTolerance |
gala_get_swap_result | Resolve the outcome of a previously queued GSwap swap by its uniqueKey through gswap-sdk (gSwap.swaps.confirmSwap), without resubmitting | no | uniqueKey*, timeoutMs |
gala_get_swap_user_assets | Get one page of GSwap assets for a wallet through gswap-sdk (gSwap.assets.getUserAssets) | no | walletAddress* |
gala_get_swap_pool_info | Get current-contract GSwap pool information for a token pair | no | tokenA, tokenB |
gala_get_swap_pool_price | Get current-contract GSwap price state through gswap-sdk (gSwap.pools.getSlot0) | no | token0, token1, fee* |
gala_fetch_swap_position_direct | Fetch one current-contract GSwap position by its compound pair and tick key | no | token0, token1, fee, tickLower, tickUpper, ownerAddress |
gala get swap quote exact input from token to output execute amount estimated fee tier slippage tolerance result unique key timeout ms user assets wallet address pool info price fetch position direct tick lower upper owner
dex
| Tool | What it does | Auth | Parameters |
|---|---|---|---|
gala_calculate_dex_pool_quote_local | Calculate a DEX quote through the v6 GSwap quoting service | no | token0, token1, fee, fromToken, toToken, amount |
gala_calculate_dex_pool_quote_external | Calculate a server-backed DEX quote through the v6 GSwap quoting service | no | token0, token1, fee, fromToken, toToken, amount |
gala_fetch_dex_pools | Fetch current-contract GSwap pools through gswap-sdk (gSwap.pools.getPools) | no | search, sortBy, sortOrder, cursor, pageSize |
gala_fetch_dex_leaderboard_by_season_id | Fetch DEX leaderboard for a specific season - returns rankings with XP metrics and achievements | no | seasonId* |
gala_fetch_dex_aggregated_volume_summary | Fetch DEX aggregated volume summary with 1d/7d/30d volume (USD) and deltas (fraction of the previous period: -0.11 is 11% less) | no | - |
gala_on_dex_pool_creation | Watch for new DEX pool creation by polling, not a real-time push event | no | minTVL, tokens, intervalMs, durationSeconds |
gala calculate dex pool quote local from token to external fetch pools sort by order page size leaderboard season id aggregated volume summary on creation min tvl interval ms duration seconds
all
| Tool | What it does | Auth | Parameters |
|---|---|---|---|
gala_get_all_swap_user_assets | Fetch all GSwap assets for a wallet through gswap-sdk (gSwap.assets.getUserAssets) | no | walletAddress* |
gala_fetch_all_dex_pools | Fetch all current-contract GSwap pools through gswap-sdk (gSwap.pools.getPools) | no | search, sortBy, sortOrder, withPrices |
gala_fetch_all_available_dex_tokens | List all registered GSwap trading symbols through gswap-sdk (gSwap.symbols.list) | no | search |
gala_get_all_user_liquidity_positions | Get all current-contract GSwap liquidity positions owned by an address | no | ownerAddress* |
gala_fetch_all_dex_seasons | Fetch all DEX leaderboard seasons - returns complete list of seasons with dates and rules | no | - |
gala get all swap user assets wallet address fetch dex pools sort by order with prices available tokens liquidity positions owner seasons
composite
| Tool | What it does | Auth | Parameters |
|---|---|---|---|
gala_fetch_composite_pool_data | Fetch a current-contract GSwap composite pool snapshot through gswap-sdk (gSwap.pools.getCompositePool) | no | token0, token1, fee* |
gala fetch composite pool data
available
| Tool | What it does | Auth | Parameters |
|---|---|---|---|
gala_fetch_available_dex_tokens | List registered GSwap trading symbols through gswap-sdk (gSwap.symbols.list) | no | search, pageSize, cursor |
gala fetch available dex tokens page size
user
| Tool | What it does | Auth | Parameters |
|---|---|---|---|
gala_get_user_liquidity_positions | Get current-contract GSwap liquidity positions owned by an address | no | ownerAddress* |
gala get user liquidity positions owner address
liquidity
| Tool | What it does | Auth | Parameters |
|---|---|---|---|
gala_get_liquidity_position_by_id | Get one current-contract GSwap position by its pair, fee, owner, and tick range | no | token0, token1, fee, tickLower, tickUpper, ownerAddress |
gala_get_liquidity_position | Get one current-contract GSwap position by pair, owner, and tick range | no | token0, token1, fee, tickLower, tickUpper, ownerAddress |
gala_add_liquidity_by_price | Add liquidity through gswap-sdk (gSwap.positions.addLiquidityByPrice) and return confirm() output | no | token0, token1, fee, minPrice, maxPrice, amount0Desired, amount1Desired*, amount0Min, amount1Min, amountIsToken0 |
gala_add_liquidity_by_ticks | Add liquidity through gswap-sdk (gSwap.positions.addLiquidityByTicks) and return confirm() output | no | token0, token1, fee, tickLower, tickUpper, amount0Desired, amount1Desired*, amount0Min, amount1Min, amountIsToken0 |
gala_remove_liquidity | Remove current-contract GSwap liquidity and return confirm() output | no | token0, token1, fee, tickLower, tickUpper, ownerAddress, liquidity, amount0, amount1 |
gala get liquidity position by id tick lower upper owner address add price min max amount0 desired amount1 amount is token0 ticks remove
remove
| Tool | What it does | Auth | Parameters |
|---|---|---|---|
gala_estimate_remove_liquidity | Estimate token amounts released by a current-contract GSwap liquidity withdrawal | no | token0, token1, fee, tickLower, tickUpper, liquidity, ownerAddress* |
gala estimate remove liquidity tick lower upper owner address
position
| Tool | What it does | Auth | Parameters |
|---|---|---|---|
gala_collect_position_fees | Collect current-contract GSwap position fees and return confirm() output | no | token0, token1, fee, tickLower, tickUpper, ownerAddress |
gala collect position fees tick lower upper owner address
current
| Tool | What it does | Auth | Parameters |
|---|---|---|---|
gala_fetch_current_dex_season | Fetch current active DEX leaderboard season - returns null if no season is active | no | - |
gala_fetch_current_dex_leaderboard | Fetch current DEX leaderboard for active season - returns null if no active season | no | - |
gala fetch current dex season leaderboard
gala
| Tool | What it does | Auth | Parameters |
|---|---|---|---|
gala_fetch_gala_spot_price | Fetch current GALA USD spot price (convenience method) | no | - |
gala fetch spot price
Prompts
| Prompt | Tier | What it does | Arguments | Tools it names |
|---|---|---|---|---|
galachain-launchpad:discover-pools | legacy | Discover DEX liquidity pools with filtering and analysis - find hot pools, high TVL, or high volume trading opportunities | search, sortBy, sortOrder, minTvl, minVolume, page, limit | gala_fetch_dex_pools |
galachain-launchpad:fetch-all-pools | legacy | Fetch ALL DEX liquidity pools with auto-pagination for comprehensive analysis | sortBy, sortOrder | gala_fetch_all_dex_pools |
galachain-launchpad:check-leaderboard | legacy | View top DEX pools ranked by TVL, volume, or APR | metric, limit | gala_fetch_current_dex_leaderboard |
galachain-launchpad:manage-liquidity | legacy | Complete liquidity provider workflow - deposit liquidity, monitor positions, collect fees, and manage LP strategies | action*, token0, token1, feeTier, minPrice, maxPrice | gala_add_liquidity_by_price, gala_collect_position_fees, gala_estimate_remove_liquidity, gala_get_swap_pool_price, gala_get_swap_user_assets, gala_get_user_liquidity_positions, gala_remove_liquidity |
galachain-launchpad:add-liquidity-by-price | legacy | Create new LP position by specifying price range and token amounts | token0, token1, feeTier, minPrice, maxPrice, amount0, amount1* | gala_add_liquidity_by_price, gala_get_swap_pool_price |
galachain-launchpad:collect-fees | legacy | Collect accumulated swap fees from your LP positions | positionId* | gala_collect_position_fees, gala_get_user_liquidity_positions |
galachain-launchpad:remove-liquidity | legacy | Exit an LP position and retrieve your tokens | positionId* | gala_estimate_remove_liquidity, gala_get_user_liquidity_positions, gala_remove_liquidity |
galachain-launchpad:optimize-liquidity | legacy | Advanced liquidity optimization strategies - multi-tier positions, fee tier selection, range management | tokenPair*, strategy, targetYield | - |
galachain-launchpad:advanced-positions | legacy | Advanced liquidity position management - multi-leg strategies, fee collection, position monitoring | action*, positionId | - |
galachain-launchpad:liquidity-strategy | legacy | Plan and optimize liquidity provision strategy based on market conditions and risk tolerance | marketCondition, riskTolerance | - |
galachain-launchpad:fetch-available-dex-tokens | legacy | Discover all tokens available for trading on the DEX with rich metadata | search, all | gala_fetch_all_available_dex_tokens, gala_fetch_available_dex_tokens |
galachain-launchpad:dex-swap | legacy | Execute a token swap on GalaSwap DEX for graduated tokens | fromToken, toToken, amount*, slippage | gala_execute_swap, gala_get_swap_pool_info, gala_get_swap_quote_exact_input, gala_get_swap_quote_exact_output, gala_get_swap_result, gala_get_swap_user_assets |
galachain-launchpad:get-all-swap-user-assets | legacy | Get ALL token assets for a wallet with automatic pagination | walletAddress* | gala_get_all_swap_user_assets |
galachain-launchpad:fetch-composite-pool-data | legacy | Fetch complete pool state for offline DEX quote calculations | token0, token1, fee* | gala_fetch_composite_pool_data, gala_get_swap_quote_exact_input |
galachain-launchpad:calculate-dex-pool-quote | legacy | Calculate DEX swap quote using local or external calculation | token0, token1, fee, fromToken, toToken, amount, mode | gala_calculate_dex_pool_quote_local |
galachain-launchpad:fetch-dex-pools | legacy | Discover DEX liquidity pools with pagination, sorting, and search filtering | search, sortBy, sortOrder, page, limit | gala_fetch_dex_pools |
galachain-launchpad:fetch-all-dex-pools | legacy | Discover ALL DEX liquidity pools with automatic pagination | search, sortBy, sortOrder | gala_fetch_all_dex_pools |
galachain-launchpad:my-positions | legacy | View all your open liquidity positions on GalaSwap DEX with details about each position | - | gala_get_user_liquidity_positions |
galachain-launchpad:add-liquidity | legacy | Add liquidity to a GalaSwap DEX pool | token0, token1, amount0, amount1, minPrice, maxPrice, feeTier | gala_add_liquidity_by_price, gala_get_swap_pool_info, gala_get_swap_user_assets |
galachain-launchpad:get-all-liquidity-positions | legacy | Get ALL liquidity positions for a wallet with automatic pagination and optional pricing | ownerAddress*, withPrices | gala_get_all_user_liquidity_positions |
galachain-launchpad:estimate-remove-liquidity | legacy | Estimate tokens and fees received when removing liquidity from a position | token0, token1, fee, liquidity, tickLower, tickUpper, ownerAddress* | gala_estimate_remove_liquidity |
galachain-launchpad:fetch-position-direct | legacy | Fetch a single liquidity position using the compound key (most efficient when you have all position parameters) | token0, token1, fee, tickLower, tickUpper, owner | gala_fetch_swap_position_direct |
galachain-launchpad:fetch-gala-spot-price | legacy | Fetch current GALA USD spot price | - | gala_fetch_gala_spot_price |
galachain-launchpad:watch-dex-pools | legacy | Watch for new DEX pools by polling the swap backend pool list (not the realtime stream) | duration, minTVL, tokens | gala_on_dex_pool_creation |
galachain-launchpad:fetch-all-dex-seasons | legacy | Fetch all DEX leaderboard seasons - explore season dates and rules | - | gala_fetch_current_dex_season, gala_fetch_dex_leaderboard_by_season_id |
galachain-launchpad:fetch-current-dex-season | legacy | Fetch the currently active DEX leaderboard season | - | gala_fetch_all_dex_seasons, gala_fetch_current_dex_leaderboard, gala_fetch_dex_leaderboard_by_season_id |
galachain-launchpad:fetch-dex-leaderboard-by-season-id | legacy | Fetch DEX leaderboard rankings for a specific season | seasonId* | gala_fetch_all_dex_seasons, gala_fetch_current_dex_leaderboard, gala_fetch_current_dex_season |
galachain-launchpad:fetch-current-dex-leaderboard | legacy | Fetch DEX leaderboard rankings for the currently active season | - | gala_fetch_all_dex_seasons, gala_fetch_current_dex_season, gala_fetch_dex_leaderboard_by_season_id |
galachain-launchpad:fetch-dex-aggregated-volume-summary | legacy | Fetch DEX aggregated volume summary with 1d/7d/30d trend metrics | - | gala_fetch_all_dex_pools, gala_fetch_dex_pools, gala_get_swap_quote_exact_input |
galachain-launchpad:subscribe-dex-liquidity-added | legacy | Subscribe to real-time DEX liquidity addition events via WebSocket connection | duration, minLiquidity | gala_on_dex_pool_creation |
galachain-launchpad:subscribe-dex-liquidity-changed | legacy | Subscribe to real-time DEX liquidity modification events via WebSocket connection | duration | gala_on_dex_pool_creation |
galachain-launchpad:subscribe-dex-liquidity-removed | legacy | Subscribe to real-time DEX liquidity removal events via WebSocket connection | duration, minAmount | gala_on_dex_pool_creation |
galachain-launchpad:subscribe-dex-pool-added | legacy | Watch for new DEX pools by polling the swap backend pool list (not the realtime stream) | duration, feeTier | gala_on_dex_pool_creation |
galachain-launchpad:subscribe-dex-swap-executed | legacy | Subscribe to real-time DEX swap execution events via WebSocket connection | duration, minAmount | gala_on_dex_pool_creation |
sort by order min tvl volume gala fetch dex pools all current leaderboard fee tier price max add liquidity collect position fees estimate remove get swap pool user assets positions id token pair target yield market condition risk tolerance available tokens from to execute info quote exact input output result wallet address composite data calculate local owner with prices tick lower upper direct spot on creation season seasons amount