@gala-chain/gala-mcp-server 1.0.0-rc.8 → 1.0.0

package/README.md

@@ -1,6 +1,6 @@
 # @gala-chain/gala-mcp-server
 
-**Version: 1.0.0 release candidate (dist-tag `next`).** Supersedes `@gala-chain/launchpad-mcp-server`
+**Version: 1.0.0 (stable).** Supersedes `@gala-chain/launchpad-mcp-server`
 (last release 8.1.0): same tools, same names, same environment variables; the bin is now `gala-mcp`.
 
 MCP (Model Context Protocol) server for GalaChain: wallets, bridging and wrapping (gala-core-sdk), the
@@ -11,7 +11,7 @@ Setting this up for Claude Code, Claude Desktop or Cursor, or using the `omni-to
 
 ## 🚀 Features
 
-- **<!-- docs:var toolCount -->323<!-- /docs:var --> tools and <!-- docs:var promptCount -->286<!-- /docs:var --> prompts (slash commands)** in four toolsets you select: load only the part of the Gala stack you use, so the model's context does not carry tools it will never call
+- **<!-- docs:var toolCount -->324<!-- /docs:var --> tools and <!-- docs:var promptCount -->286<!-- /docs:var --> prompts (slash commands)** in four toolsets you select: load only the part of the Gala stack you use, so the model's context does not carry tools it will never call
 - **Type-safe** - TypeScript, with every input validated against the schema the tool publishes
 - **Built on the Gala SDKs** - [@gala-chain/gala-core-sdk](https://www.npmjs.com/package/@gala-chain/gala-core-sdk), [@gala-chain/launchpad-sdk](https://www.npmjs.com/package/@gala-chain/launchpad-sdk) and [@gala-chain/gswap-sdk](https://www.npmjs.com/package/@gala-chain/gswap-sdk)
 - **Read-only and full-access modes** - without `PRIVATE_KEY` every read works and writes say they need a wallet
@@ -26,12 +26,12 @@ its SDK is not even imported (a launchpad-only run never loads `gswap-sdk`).
 
 | Toolset | Tools | Prompts | SDKs | What is in it |
 | --- | --- | --- | --- | --- |
-| `core` | <!-- docs:var toolsOwned_core -->46<!-- /docs:var --> | <!-- docs:var promptsOwned_core -->30<!-- /docs:var --> | gala-core-sdk | Wallet and key tools (create wallet, addresses, key derivation), the session wallet and environment (`set_wallet`, `switch_environment`), versions, the GALA balance and GALA transfers (`fetch_gala_balance`, `transfer_gala`), cross-chain bridging (GalaChain, Ethereum, Solana), wrap/unwrap, external chain balances, `explain_sdk_usage` |
+| `core` | <!-- docs:var toolsOwned_core -->47<!-- /docs:var --> | <!-- docs:var promptsOwned_core -->30<!-- /docs:var --> | gala-core-sdk | Wallet and key tools (create wallet, addresses, key derivation), the session wallet and environment (`set_wallet`, `switch_environment`), versions, the GALA balance and GALA transfers (`fetch_gala_balance`, `transfer_gala`), cross-chain bridging (GalaChain, Ethereum, Solana), wrap/unwrap, external chain balances, `explain_sdk_usage` |
 | `launchpad` | <!-- docs:var toolsOwned_launchpad -->242<!-- /docs:var --> | <!-- docs:var promptsOwned_launchpad -->213<!-- /docs:var --> | gala-core-sdk + launchpad-sdk | The launchpad backend: pools and bonding-curve trading, token creation, launchpad token balances and transfers, locks and burns, NFTs, holders, streaming, chat, auth, moderation, overseers, API keys, content flags, WebSocket events |
 | `gswap` | <!-- docs:var toolsOwned_gswap -->32<!-- /docs:var --> | <!-- docs:var promptsOwned_gswap -->34<!-- /docs:var --> | gala-core-sdk + gswap-sdk | The GSwap DEX: swap quotes and swaps, pools, liquidity positions and fees, market prices, leaderboard and seasons, pool-creation watcher |
 | `composite` | <!-- docs:var toolsOwned_composite -->3<!-- /docs:var --> | <!-- docs:var promptsOwned_composite -->9<!-- /docs:var --> | launchpad-sdk + gswap-sdk | Launchpad token prices and price history from the DEX market. Not selectable: enabled exactly when `launchpad` and `gswap` both are |
 
-Tool names do not change with the toolset (they all keep the `gala_launchpad_` prefix, DEX tools included), so
+Tool names do not change with the toolset (they all keep the `gala_` prefix, DEX tools included), so
 prompts, docs and plugins refer to the same names whichever toolsets run. The full per-tool classification,
 with the reason each tool is in its group, is in [docs/TOOLSET-CLASSIFICATION.md](docs/TOOLSET-CLASSIFICATION.md).
 
@@ -44,12 +44,12 @@ gala-mcp --toolsets launchpad              # command line (wins over the variabl
 
 | Selection | Tools | Prompts |
 | --- | --- | --- |
-| `core,launchpad,gswap` (default) | <!-- docs:var tools_core_launchpad_gswap -->323<!-- /docs:var --> | <!-- docs:var prompts_core_launchpad_gswap -->286<!-- /docs:var --> |
+| `core,launchpad,gswap` (default) | <!-- docs:var tools_core_launchpad_gswap -->324<!-- /docs:var --> | <!-- docs:var prompts_core_launchpad_gswap -->286<!-- /docs:var --> |
 | `launchpad` | <!-- docs:var tools_launchpad -->242<!-- /docs:var --> | <!-- docs:var prompts_launchpad -->209<!-- /docs:var --> |
 | `gswap` | <!-- docs:var tools_gswap -->32<!-- /docs:var --> | <!-- docs:var prompts_gswap -->34<!-- /docs:var --> |
-| `core` | <!-- docs:var tools_core -->46<!-- /docs:var --> | <!-- docs:var prompts_core -->30<!-- /docs:var --> |
-| `core,launchpad` | <!-- docs:var tools_core_launchpad -->288<!-- /docs:var --> | <!-- docs:var prompts_core_launchpad -->243<!-- /docs:var --> |
-| `core,gswap` | <!-- docs:var tools_core_gswap -->78<!-- /docs:var --> | <!-- docs:var prompts_core_gswap -->64<!-- /docs:var --> |
+| `core` | <!-- docs:var tools_core -->47<!-- /docs:var --> | <!-- docs:var prompts_core -->30<!-- /docs:var --> |
+| `core,launchpad` | <!-- docs:var tools_core_launchpad -->289<!-- /docs:var --> | <!-- docs:var prompts_core_launchpad -->243<!-- /docs:var --> |
+| `core,gswap` | <!-- docs:var tools_core_gswap -->79<!-- /docs:var --> | <!-- docs:var prompts_core_gswap -->64<!-- /docs:var --> |
 | `launchpad,gswap` (+ composite) | <!-- docs:var tools_launchpad_gswap -->277<!-- /docs:var --> | <!-- docs:var prompts_launchpad_gswap -->250<!-- /docs:var --> |
 
 - Names are comma separated and case-insensitive; order does not matter. An unknown name, an empty entry
@@ -59,7 +59,7 @@ gala-mcp --toolsets launchpad              # command line (wins over the variabl
   topics whose tools are in the selection. That is why `launchpad` alone lists <!-- docs:var prompts_launchpad -->209<!-- /docs:var --> of its <!-- docs:var promptsOwned_launchpad -->213<!-- /docs:var --> prompts: the others also
   name a `core` tool (for example the bridge tools, or the GALA balance). `explain_sdk_usage` is a `core` tool; add
   `core` to get it.
-- The GALA balance and GALA transfers (`gala_launchpad_fetch_gala_balance`, `gala_launchpad_transfer_gala`) are
+- The GALA balance and GALA transfers (`gala_fetch_gala_balance`, `gala_transfer_gala`) are
   `core` tools (since 1.0.0-rc.1; they were `launchpad`'s in 1.0.0-rc.0): a launchpad user who needs them selects
   `core,launchpad`.
 - The wallet, environment and settings (`PRIVATE_KEY`, `ENVIRONMENT`, ...) are shared by every toolset and read the
@@ -71,24 +71,22 @@ gala-mcp --toolsets launchpad              # command line (wins over the variabl
 
 ```bash
 # everything (default)
-claude mcp add "gala" -- env PRIVATE_KEY=0x... ENVIRONMENT=prod npx -y @gala-chain/gala-mcp-server@next
+claude mcp add "gala" -- env PRIVATE_KEY=0x... ENVIRONMENT=prod npx -y @gala-chain/gala-mcp-server
 # launchpad only (plus the core tools: wallet, GALA balance and transfer, bridge)
-claude mcp add "gala-launchpad" -- env GALA_TOOLSETS=core,launchpad PRIVATE_KEY=0x... ENVIRONMENT=prod npx -y @gala-chain/gala-mcp-server@next
+claude mcp add "gala-launchpad" -- env GALA_TOOLSETS=core,launchpad PRIVATE_KEY=0x... ENVIRONMENT=prod npx -y @gala-chain/gala-mcp-server
 # DEX only (plus the core tools: wallet, GALA balance and transfer, bridge)
-claude mcp add "gala-swap" -- env GALA_TOOLSETS=core,gswap PRIVATE_KEY=0x... ENVIRONMENT=prod npx -y @gala-chain/gala-mcp-server@next
+claude mcp add "gala-swap" -- env GALA_TOOLSETS=core,gswap PRIVATE_KEY=0x... ENVIRONMENT=prod npx -y @gala-chain/gala-mcp-server
 ```
 
-`@next` (or the exact version, <!-- docs:var version -->1.0.0-rc.8<!-- /docs:var -->, as `@gala-chain/gala-mcp-server@<version>`) is required while 1.0.0 is a release candidate:
-`^1.0.0` matches no prerelease, and the `latest` dist-tag can still name an older release candidate.
+In production, pin the exact version (`@gala-chain/gala-mcp-server@<version>`, currently <!-- docs:var version -->1.0.0<!-- /docs:var -->) so a client restart never changes the tools it lists.
 
 ## 📦 Installation
 
 ```bash
-npm install -g @gala-chain/gala-mcp-server@next
+npm install -g @gala-chain/gala-mcp-server
 ```
 
-1.0.0 is published as a release candidate under the `next` dist-tag: install `@next` or the exact version
-(the exact version, <!-- docs:var version -->1.0.0-rc.8<!-- /docs:var -->, as `@gala-chain/gala-mcp-server@<version>`); a range such as `^1.0.0` matches no release candidate.
+Pin the exact version in production (`@gala-chain/gala-mcp-server@<version>`).
 
 ### Module Format
 
@@ -108,7 +106,7 @@ Add to your `claude_desktop_config.json`:
   "mcpServers": {
     "gala": {
       "command": "npx",
-      "args": ["-y", "@gala-chain/gala-mcp-server@next"],
+      "args": ["-y", "@gala-chain/gala-mcp-server"],
       "env": {
         "PRIVATE_KEY": "0x1234567890abcdef...",
         "ENVIRONMENT": "prod"
@@ -135,14 +133,14 @@ Add to your `claude_desktop_config.json`:
 - `GALA_DOCS_CACHE_TTL_SECONDS` (optional) - how long the cached docs index is fresh (default: 3600)
 - `GALA_DOCS_OFFLINE` (optional) - `1` never asks the docs site; the bundled index answers
 
-The documentation tools (`gala_launchpad_search_gala_docs`, and the `docs` field of
-`gala_launchpad_explain_sdk_usage`) search the docs site's index and work without it: a bundled copy
+The documentation tools (`gala_search_gala_docs`, and the `docs` field of
+`gala_explain_sdk_usage`) search the docs site's index and work without it: a bundled copy
 (at most 300 KB compressed) answers when the site cannot be reached. The site lists every package's
 agent guide in `/llms.txt`; the machine-readable tool reference is at `/mcp/tools.json`.
 
 ### Using with Claude Desktop
 
-1. **Install**: `npm install -g @gala-chain/gala-mcp-server@next`
+1. **Install**: `npm install -g @gala-chain/gala-mcp-server`
 2. **Configure**: Add server to `claude_desktop_config.json` (see above)
 3. **Restart Claude Desktop**
 4. **Use tools**: Ask Claude to interact with Gala Launchpad!
@@ -160,7 +158,7 @@ The MCP server supports two operational modes with dynamic wallet configuration:
 
 **Setup:**
 ```bash
-claude mcp add "gala" -- env PRIVATE_KEY=0x... ENVIRONMENT=prod npx -y @gala-chain/gala-mcp-server@next
+claude mcp add "gala" -- env PRIVATE_KEY=0x... ENVIRONMENT=prod npx -y @gala-chain/gala-mcp-server
 ```
 
 ### Read-Only Mode (without PRIVATE_KEY)
@@ -172,43 +170,43 @@ claude mcp add "gala" -- env PRIVATE_KEY=0x... ENVIRONMENT=prod npx -y @gala-cha
 
 **Setup:**
 ```bash
-claude mcp add "gala-readonly" -- env ENVIRONMENT=prod npx -y @gala-chain/gala-mcp-server@next
+claude mcp add "gala-readonly" -- env ENVIRONMENT=prod npx -y @gala-chain/gala-mcp-server
 ```
 
 ### Dynamic Wallet Configuration
 Use the wallet management tools to upgrade or switch wallets at runtime:
-- `gala_launchpad_has_wallet` - Check current wallet status
-- `gala_launchpad_set_wallet` - Upgrade from read-only to full-access mode
-- `gala_launchpad_get_wallet` - Retrieve wallet information
+- `gala_has_wallet` - Check current wallet status
+- `gala_set_wallet` - Upgrade from read-only to full-access mode
+- `gala_get_wallet` - Retrieve wallet information
 
 ## 🛠️ Available Tools
 
 ### Pool Management, Pricing & Event Watchers
-- `gala_launchpad_fetch_pools` - Fetch token pools with filtering
-- `gala_launchpad_fetch_all_pools` - Fetch all available pools with automatic pagination
-- `gala_launchpad_fetch_pool_details` - Get detailed pool state
-- `gala_launchpad_fetch_pool_details_for_calculation` - Get optimized pool details for local calculations
-- `gala_launchpad_fetch_composite_pool_data` - **NEW v2.0** - Fetch a raw GSwap pool snapshot
-- `gala_launchpad_fetch_token_distribution` - Get holder distribution
-- `gala_launchpad_fetch_volume_data` - Get OHLCV charting data
-- `gala_launchpad_fetch_token_spot_price` - Fetch USD spot price for DEX tokens
-- `gala_launchpad_fetch_gala_spot_price` - Fetch current GALA USD spot price
-- `gala_launchpad_fetch_launchpad_token_spot_price` - Fetch USD spot price for launchpad token
-- `gala_launchpad_fetch_price_history` - Fetch historical price snapshots from DEX Backend API
-- `gala_launchpad_fetch_all_price_history` - Fetch all historical price snapshots with auto-pagination
-- `gala_launchpad_fetch_token_details` - Fetch comprehensive token metadata
-- `gala_launchpad_check_token_name` - Check name availability
-- `gala_launchpad_check_token_symbol` - Check symbol availability
-- `gala_launchpad_resolve_vault_address` - Get GalaChain vault address
-- `gala_launchpad_resolve_token_class_key` - Get GalaChain TokenClassKey
-- `gala_launchpad_on_dex_pool_creation` - Watch for new DEX pool creation events
-- `gala_launchpad_on_launchpad_token_creation` - Watch for new launchpad token creation events
+- `gala_fetch_pools` - Fetch token pools with filtering
+- `gala_fetch_all_pools` - Fetch all available pools with automatic pagination
+- `gala_fetch_pool_details` - Get detailed pool state
+- `gala_fetch_pool_details_for_calculation` - Get optimized pool details for local calculations
+- `gala_fetch_composite_pool_data` - **NEW v2.0** - Fetch a raw GSwap pool snapshot
+- `gala_fetch_token_distribution` - Get holder distribution
+- `gala_fetch_volume_data` - Get OHLCV charting data
+- `gala_fetch_token_spot_price` - Fetch USD spot price for DEX tokens
+- `gala_fetch_gala_spot_price` - Fetch current GALA USD spot price
+- `gala_fetch_launchpad_token_spot_price` - Fetch USD spot price for launchpad token
+- `gala_fetch_price_history` - Fetch historical price snapshots from DEX Backend API
+- `gala_fetch_all_price_history` - Fetch all historical price snapshots with auto-pagination
+- `gala_fetch_token_details` - Fetch comprehensive token metadata
+- `gala_check_token_name` - Check name availability
+- `gala_check_token_symbol` - Check symbol availability
+- `gala_resolve_vault_address` - Get GalaChain vault address
+- `gala_resolve_token_class_key` - Get GalaChain TokenClassKey
+- `gala_on_dex_pool_creation` - Watch for new DEX pool creation events
+- `gala_on_launchpad_token_creation` - Watch for new launchpad token creation events
 
 #### 🔔 Event Watchers - Real-Time Monitoring
 
 **Real-time pool and token discovery with WebSocket-based watchers:**
 
-**`gala_launchpad_on_dex_pool_creation` - Watch for DEX Pool Creation**
+**`gala_on_dex_pool_creation` - Watch for DEX Pool Creation**
 
 Monitor new liquidity pool creation on GalaSwap DEX with optional filtering:
 
@@ -238,7 +236,7 @@ Monitor new liquidity pool creation on GalaSwap DEX with optional filtering:
 - **Example:**
 ```javascript
 // Watch for new high-TVL pools with GALA
-const result = await gala_launchpad_on_dex_pool_creation({
+const result = await gala_on_dex_pool_creation({
   minTVL: "500000",     // Only pools with 500k+ GALA TVL
   tokens: ["GALA"],     // Only GALA pairs
   intervalMs: 3000,     // Check every 3 seconds
@@ -251,7 +249,7 @@ result.pools.forEach(pool => {
 });
 ```
 
-**`gala_launchpad_on_launchpad_token_creation` - Watch for Launchpad Token Creation**
+**`gala_on_launchpad_token_creation` - Watch for Launchpad Token Creation**
 
 Monitor new token launches on Gala Launchpad with optional creator filtering:
 
@@ -280,7 +278,7 @@ Monitor new token launches on Gala Launchpad with optional creator filtering:
 - **Example:**
 ```javascript
 // Watch for tokens from a specific creator
-const result = await gala_launchpad_on_launchpad_token_creation({
+const result = await gala_on_launchpad_token_creation({
   creatorAddress: "eth|1234567890abcdef1234567890abcdef12345678",
   intervalMs: 2000,     // Check every 2 seconds
   durationSeconds: 300  // Poll for 5 minutes
@@ -303,23 +301,23 @@ result.tokens.forEach(token => {
 - **Return Values** - Both detect count and full objects for flexible usage
 
 ### Trading Operations
-- `gala_launchpad_calculate_buy_amount` - Calculate buy amounts (network call)
-- `gala_launchpad_calculate_sell_amount` - Calculate sell amounts (network call)
-- `gala_launchpad_calculate_buy_amount_local` - Calculate buy amounts (local, instant)
-- `gala_launchpad_calculate_buy_amount_external` - Calculate buy amounts (explicit network call)
-- `gala_launchpad_calculate_sell_amount_local` - Calculate sell amounts (local, instant)
-- `gala_launchpad_calculate_sell_amount_external` - Calculate sell amounts (explicit network call)
-- `gala_launchpad_buy` - Execute token purchase
-- `gala_launchpad_sell` - Execute token sale
-- `gala_launchpad_fetch_trades` - Get trade history
-- `gala_launchpad_calculate_initial_buy` - Calculate initial buy
-- `gala_launchpad_get_bundler_transaction_result` - Get transaction status by ID
-- `gala_launchpad_calculate_buy_amount_for_graduation` - Calculate cost to graduate pool
-- `gala_launchpad_graduate_token` - One-step pool graduation
+- `gala_calculate_buy_amount` - Calculate buy amounts (network call)
+- `gala_calculate_sell_amount` - Calculate sell amounts (network call)
+- `gala_calculate_buy_amount_local` - Calculate buy amounts (local, instant)
+- `gala_calculate_buy_amount_external` - Calculate buy amounts (explicit network call)
+- `gala_calculate_sell_amount_local` - Calculate sell amounts (local, instant)
+- `gala_calculate_sell_amount_external` - Calculate sell amounts (explicit network call)
+- `gala_buy` - Execute token purchase
+- `gala_sell` - Execute token sale
+- `gala_fetch_trades` - Get trade history
+- `gala_calculate_initial_buy` - Calculate initial buy
+- `gala_get_bundler_transaction_result` - Get transaction status by ID
+- `gala_calculate_buy_amount_for_graduation` - Calculate cost to graduate pool
+- `gala_graduate_token` - One-step pool graduation
 
 #### 🎓 Understanding Graduation Calculations
 
-**CRITICAL:** The `amount` field in `gala_launchpad_calculate_buy_amount_for_graduation` represents **GALA cost**, NOT token quantity!
+**CRITICAL:** The `amount` field in `gala_calculate_buy_amount_for_graduation` represents **GALA cost**, NOT token quantity!
 
 ```javascript
 // Example response
@@ -355,9 +353,9 @@ result.tokens.forEach(token => {
 
 The following tools now support optional performance parameters to reduce network calls by **66%** and speed up operations by **~70%**:
 
-- `gala_launchpad_fetch_launchpad_token_spot_price`
-- `gala_launchpad_calculate_buy_amount_for_graduation`
-- `gala_launchpad_graduate_token`
+- `gala_fetch_launchpad_token_spot_price`
+- `gala_calculate_buy_amount_for_graduation`
+- `gala_graduate_token`
 
 **New Optional Parameters:**
 - `calculateAmountMode` (enum: `'local'` | `'external'`) - Calculation strategy
@@ -367,36 +365,36 @@ The following tools now support optional performance parameters to reduce networ
 
 ```javascript
 // ❌ WITHOUT OPTIMIZATION (3 network calls)
-const spotPrice1 = await gala_launchpad_fetch_launchpad_token_spot_price({ tokenName: "tinyevil" });
+const spotPrice1 = await gala_fetch_launchpad_token_spot_price({ tokenName: "tinyevil" });
 // → Network call #1
 
-const graduation1 = await gala_launchpad_calculate_buy_amount_for_graduation({ tokenName: "tinyevil" });
+const graduation1 = await gala_calculate_buy_amount_for_graduation({ tokenName: "tinyevil" });
 // → Network call #2
 
-const result1 = await gala_launchpad_graduate_token({ tokenName: "tinyevil" });
+const result1 = await gala_graduate_token({ tokenName: "tinyevil" });
 // → Network call #3
 
 // ✅ WITH OPTIMIZATION (1 network call + instant local calculations)
 // Step 1: Fetch pool details once
-const poolDetails = await gala_launchpad_fetch_pool_details_for_calculation({ tokenName: "tinyevil" });
+const poolDetails = await gala_fetch_pool_details_for_calculation({ tokenName: "tinyevil" });
 const currentSupply = poolDetails.currentSupply;
 
 // Step 2: Reuse currentSupply for instant local calculations
-const spotPrice2 = await gala_launchpad_fetch_launchpad_token_spot_price({
+const spotPrice2 = await gala_fetch_launchpad_token_spot_price({
   tokenName: "tinyevil",
   calculateAmountMode: "local",
   currentSupply: currentSupply
 });
 // → Instant (no network call)
 
-const graduation2 = await gala_launchpad_calculate_buy_amount_for_graduation({
+const graduation2 = await gala_calculate_buy_amount_for_graduation({
   tokenName: "tinyevil",
   calculateAmountMode: "local",
   currentSupply: currentSupply
 });
 // → Instant (no network call)
 
-const result2 = await gala_launchpad_graduate_token({
+const result2 = await gala_graduate_token({
   tokenName: "tinyevil",
   calculateAmountMode: "local",
   currentSupply: currentSupply,
@@ -425,8 +423,8 @@ const result2 = await gala_launchpad_graduate_token({
 
 **Discover and explore GalaSwap DEX liquidity pools with filtering, sorting, and pagination:**
 
-- `gala_launchpad_fetch_dex_pools` - Discover DEX liquidity pools with pagination, sorting, and search filtering
-- `gala_launchpad_fetch_all_dex_pools` - Discover ALL DEX liquidity pools with automatic pagination
+- `gala_fetch_dex_pools` - Discover DEX liquidity pools with pagination, sorting, and search filtering
+- `gala_fetch_all_dex_pools` - Discover ALL DEX liquidity pools with automatic pagination
 
 **Features:**
 - 🔍 **Search filtering** - Find pools by token symbol (GALA, GUSDC, etc.)
@@ -443,17 +441,17 @@ The DEX tools run `@gala-chain/gswap-sdk`'s `GSwap` client (launchpad-sdk has no
 built from the same environment, swap backend and `PRIVATE_KEY` as the launchpad SDK and rebuilt
 when the wallet or the environment changes. Without `PRIVATE_KEY` it is read-only.
 
-- `gala_launchpad_get_swap_quote_exact_input` - Get swap quote for exact input amount
-- `gala_launchpad_get_swap_quote_exact_output` - Get swap quote for exact desired output
-- `gala_launchpad_execute_swap` - Execute token swap on GalaSwap DEX with slippage protection (queued on chain; waits for the applied result)
-- `gala_launchpad_get_swap_result` - Resolve a queued swap by its `uniqueKey` when the outcome was unknown, without resubmitting
-- `gala_launchpad_get_swap_user_assets` - Get user token balances across all DEX pools
-- `gala_launchpad_get_all_swap_user_assets` - **NEW v2.0** - Get all user assets with auto-pagination
-- `gala_launchpad_get_swap_pool_info` - Get liquidity and fee tier information for token pairs
-- `gala_launchpad_get_swap_pool_price` - **NEW v2.0** - Get current price for token pair in DEX pool
-- `gala_launchpad_fetch_composite_pool_data` - **NEW v2.0** - Fetch a raw pool snapshot (liquidity, ticks, price, positions) for pool inspection
-- `gala_launchpad_calculate_dex_pool_quote_local` - **NEW v2.0** - DEX quote via the live GSwap quoting service (legacy naming; not offline)
-- `gala_launchpad_calculate_dex_pool_quote_external` - **NEW v2.0** - DEX quote via the live GSwap quoting service (real-time)
+- `gala_get_swap_quote_exact_input` - Get swap quote for exact input amount
+- `gala_get_swap_quote_exact_output` - Get swap quote for exact desired output
+- `gala_execute_swap` - Execute token swap on GalaSwap DEX with slippage protection (queued on chain; waits for the applied result)
+- `gala_get_swap_result` - Resolve a queued swap by its `uniqueKey` when the outcome was unknown, without resubmitting
+- `gala_get_swap_user_assets` - Get user token balances across all DEX pools
+- `gala_get_all_swap_user_assets` - **NEW v2.0** - Get all user assets with auto-pagination
+- `gala_get_swap_pool_info` - Get liquidity and fee tier information for token pairs
+- `gala_get_swap_pool_price` - **NEW v2.0** - Get current price for token pair in DEX pool
+- `gala_fetch_composite_pool_data` - **NEW v2.0** - Fetch a raw pool snapshot (liquidity, ticks, price, positions) for pool inspection
+- `gala_calculate_dex_pool_quote_local` - **NEW v2.0** - DEX quote via the live GSwap quoting service (legacy naming; not offline)
+- `gala_calculate_dex_pool_quote_external` - **NEW v2.0** - DEX quote via the live GSwap quoting service (real-time)
 - **Liquidity position tools** - Add, remove, collect fees, query positions
 - **Leaderboard tools** - Top traders, tokens, volume rankings
 - **Volume tool** - DEX trading volume metrics
@@ -462,7 +460,7 @@ when the wallet or the environment changes. Without `PRIVATE_KEY` it is read-onl
 
 ```javascript
 // Step 1: Get a quote (how much output for 100 GALA input?)
-const quote = await gala_launchpad_get_swap_quote_exact_input({
+const quote = await gala_get_swap_quote_exact_input({
   fromToken: 'GALA',
   toToken: 'GUSDC',
   amount: '100'
@@ -470,14 +468,14 @@ const quote = await gala_launchpad_get_swap_quote_exact_input({
 // Returns: { estimatedOutput: "100.50", feeTier: 3000, priceImpact: "0.23", ... }
 
 // Step 2: Check pool liquidity before large trades
-const pool = await gala_launchpad_get_swap_pool_info({
+const pool = await gala_get_swap_pool_info({
   tokenA: 'GALA',
   tokenB: 'GUSDC'
 });
 // Returns: { liquidity: "5000000", feeTiers: [500, 3000, 10000], swapCount: 1234 }
 
 // Step 3: Execute the swap with slippage protection
-const result = await gala_launchpad_execute_swap({
+const result = await gala_execute_swap({
   fromToken: 'GALA',
   toToken: 'GUSDC',
   inputAmount: '100',
@@ -492,7 +490,7 @@ const result = await gala_launchpad_execute_swap({
 // A chain rejection (e.g. VALIDATION_FAILED slippage) is returned as a tool error.
 
 // Step 4: Check user portfolio after swap
-const assets = await gala_launchpad_get_swap_user_assets({
+const assets = await gala_get_swap_user_assets({
   walletAddress: 'eth|...'
 });
 // Returns: [{ symbol: 'GALA', balance: '900', decimals: 8 }, { symbol: 'GUSDC', balance: '100.45', decimals: 6 }]
@@ -508,7 +506,7 @@ const assets = await gala_launchpad_get_swap_user_assets({
 
 #### 📊 Historical Price Analysis
 
-**`gala_launchpad_fetch_price_history`** - Fetch historical price snapshots for DEX tokens
+**`gala_fetch_price_history`** - Fetch historical price snapshots for DEX tokens
 
 This tool queries the DEX Backend API for historical token price data, enabling trend analysis and volatility assessment.
 
@@ -543,7 +541,7 @@ Ask Claude:
 
 #### 📊 All Historical Price Data (Auto-Paginated)
 
-**`gala_launchpad_fetch_all_price_history`** - Fetch all historical price snapshots (auto-paginated)
+**`gala_fetch_all_price_history`** - Fetch all historical price snapshots (auto-paginated)
 
 Automatically fetches all pages of historical price data and returns complete dataset in single result.
 
@@ -560,69 +558,69 @@ Ask Claude:
 > "Get all price history for GUSDC token from January 2024 and calculate volatility"
 
 ### Balance & Portfolio
-- `gala_launchpad_fetch_gala_balance` - Get GALA balance (`core` toolset)
-- `gala_launchpad_fetch_token_balance` - Get token balance
-- `gala_launchpad_fetch_tokens_held` - Get portfolio holdings
-- `gala_launchpad_fetch_tokens_created` - Get created tokens
-- `gala_launchpad_fetch_profile` - Get user profile
-- `gala_launchpad_update_profile` - Update profile
-- `gala_launchpad_get_swap_user_assets` - Get user token balances from DEX
-- `gala_launchpad_get_all_swap_user_assets` - **NEW v2.0** - Get all user assets with auto-pagination
+- `gala_fetch_gala_balance` - Get GALA balance (`core` toolset)
+- `gala_fetch_token_balance` - Get token balance
+- `gala_fetch_tokens_held` - Get portfolio holdings
+- `gala_fetch_tokens_created` - Get created tokens
+- `gala_fetch_profile` - Get user profile
+- `gala_update_profile` - Update profile
+- `gala_get_swap_user_assets` - Get user token balances from DEX
+- `gala_get_all_swap_user_assets` - **NEW v2.0** - Get all user assets with auto-pagination
 
 ### Wallet Management
-- `gala_launchpad_has_wallet` - Check if wallet is configured
-- `gala_launchpad_get_wallet` - Get currently configured wallet instance
-- `gala_launchpad_set_wallet` - Configure wallet for signing operations (upgrade from read-only mode)
+- `gala_has_wallet` - Check if wallet is configured
+- `gala_get_wallet` - Get currently configured wallet instance
+- `gala_set_wallet` - Configure wallet for signing operations (upgrade from read-only mode)
 
 ### Token Creation
-- `gala_launchpad_launch_token` - Create new token pool
-- `gala_launchpad_upload_token_image` - Upload token image from filesystem
-- `gala_launchpad_upload_profile_image` - Upload profile image from filesystem
-- `gala_launchpad_fetch_launch_token_fee` - Get current GALA fee to launch a token
+- `gala_launch_token` - Create new token pool
+- `gala_upload_token_image` - Upload token image from filesystem
+- `gala_upload_profile_image` - Upload profile image from filesystem
+- `gala_fetch_launch_token_fee` - Get current GALA fee to launch a token
 
 ### Token Transfers
-- `gala_launchpad_transfer_gala` - Transfer GALA tokens (`core` toolset)
-- `gala_launchpad_transfer_token` - Transfer launchpad tokens
+- `gala_transfer_gala` - Transfer GALA tokens (`core` toolset)
+- `gala_transfer_token` - Transfer launchpad tokens
 
 ### Utility Tools
-- `gala_launchpad_create_wallet` - Create new GalaChain wallet
-- `gala_launchpad_get_address` - Get user's GalaChain address
-- `gala_launchpad_get_ethereum_address` - Get user's Ethereum address
-- `gala_launchpad_get_public_key_from_private_key` - **NEW v4.0.15** - Derive public key from private key (secp256k1)
-- `gala_launchpad_get_ethereum_address_from_private_key` - **NEW v4.0.15** - Derive Ethereum address from private key
-- `gala_launchpad_get_config` - Get current SDK configuration
-- `gala_launchpad_get_url_by_token_name` - Generate frontend URL for a token
-- `gala_launchpad_explain_sdk_usage` - Get SDK code examples for specific topics
-- `gala_launchpad_get_cache_info` - Get token metadata cache statistics
-- `gala_launchpad_clear_cache` - Clear token metadata cache
-- `gala_launchpad_has_wallet` - Check if wallet is configured
-- `gala_launchpad_get_wallet` - Get currently configured wallet instance
-- `gala_launchpad_set_wallet` - Configure wallet for signing operations
-- `gala_launchpad_get_environment` - Get current MCP server environment
-- `gala_launchpad_switch_environment` - Switch MCP server environment
-- `gala_launchpad_get_version` - Get SDK and MCP server version information
-- `gala_launchpad_is_token_graduated` - Check if token has completed bonding curve
-- `gala_launchpad_cleanup` - SDK lifecycle cleanup utility
+- `gala_create_wallet` - Create new GalaChain wallet
+- `gala_get_address` - Get user's GalaChain address
+- `gala_get_ethereum_address` - Get user's Ethereum address
+- `gala_get_public_key_from_private_key` - **NEW v4.0.15** - Derive public key from private key (secp256k1)
+- `gala_get_ethereum_address_from_private_key` - **NEW v4.0.15** - Derive Ethereum address from private key
+- `gala_get_config` - Get current SDK configuration
+- `gala_get_url_by_token_name` - Generate frontend URL for a token
+- `gala_explain_sdk_usage` - Get SDK code examples for specific topics
+- `gala_get_cache_info` - Get token metadata cache statistics
+- `gala_clear_cache` - Clear token metadata cache
+- `gala_has_wallet` - Check if wallet is configured
+- `gala_get_wallet` - Get currently configured wallet instance
+- `gala_set_wallet` - Configure wallet for signing operations
+- `gala_get_environment` - Get current MCP server environment
+- `gala_switch_environment` - Switch MCP server environment
+- `gala_get_version` - Get SDK and MCP server version information
+- `gala_is_token_graduated` - Check if token has completed bonding curve
+- `gala_cleanup` - SDK lifecycle cleanup utility
 
 ### Overseer Tools
-- `gala_launchpad_create_overseer_invite` - Create an overseer invite (Admin OR Overseer)
-- `gala_launchpad_list_overseer_invites` - List all overseer invites with pagination
-- `gala_launchpad_get_overseer_invite` - Get invite details by code (public endpoint)
-- `gala_launchpad_claim_overseer_invite` - Claim an overseer invite (JWT)
-- `gala_launchpad_revoke_overseer_invite` - Revoke an overseer invite
-- `gala_launchpad_list_overseers` - List all overseers with pagination
-- `gala_launchpad_revoke_overseer` - Revoke an overseer's access
-- `gala_launchpad_get_my_overseer_status` - Check own overseer status (JWT)
-- `gala_launchpad_get_overseer_summary` - Get platform summary for CCTV dashboard (active streams, viewers, pending flags, total pools)
-- `gala_launchpad_flush_cache_by_address` - Flush cache for a wallet address (Admin OR Overseer)
-- `gala_launchpad_flush_cache_by_token` - Flush cache for a token (Admin OR Overseer)
-- `gala_launchpad_flush_all_cache` - Flush ALL cache (Admin OR Overseer, requires confirmation)
+- `gala_create_overseer_invite` - Create an overseer invite (Admin OR Overseer)
+- `gala_list_overseer_invites` - List all overseer invites with pagination
+- `gala_get_overseer_invite` - Get invite details by code (public endpoint)
+- `gala_claim_overseer_invite` - Claim an overseer invite (JWT)
+- `gala_revoke_overseer_invite` - Revoke an overseer invite
+- `gala_list_overseers` - List all overseers with pagination
+- `gala_revoke_overseer` - Revoke an overseer's access
+- `gala_get_my_overseer_status` - Check own overseer status (JWT)
+- `gala_get_overseer_summary` - Get platform summary for CCTV dashboard (active streams, viewers, pending flags, total pools)
+- `gala_flush_cache_by_address` - Flush cache for a wallet address (Admin OR Overseer)
+- `gala_flush_cache_by_token` - Flush cache for a token (Admin OR Overseer)
+- `gala_flush_all_cache` - Flush ALL cache (Admin OR Overseer, requires confirmation)
 
 ### Content Flag Tools
-- `gala_launchpad_create_flag` - Flag content (chat message, stream, etc.)
-- `gala_launchpad_list_flags` - List flags for a token with pagination
-- `gala_launchpad_dismiss_flag` - Dismiss a flag as not actionable
-- `gala_launchpad_action_flag` - Take action on flagged content
+- `gala_create_flag` - Flag content (chat message, stream, etc.)
+- `gala_list_flags` - List flags for a token with pagination
+- `gala_dismiss_flag` - Dismiss a flag as not actionable
+- `gala_action_flag` - Take action on flagged content
 
 ## 💡 Example Usage
 
@@ -931,20 +929,20 @@ All signing operations support an optional `privateKey` parameter for per-operat
 ### Tools Supporting privateKey Override
 
 **Trading Operations:**
-- `gala_launchpad_buy` - Buy tokens from different wallet
-- `gala_launchpad_sell` - Sell tokens from different wallet
+- `gala_buy` - Buy tokens from different wallet
+- `gala_sell` - Sell tokens from different wallet
 
 **Token Creation:**
-- `gala_launchpad_launch_token` - Create token from different wallet
-- `gala_launchpad_upload_token_image` - Upload image for token
-- `gala_launchpad_upload_profile_image` - Upload profile image
+- `gala_launch_token` - Create token from different wallet
+- `gala_upload_token_image` - Upload image for token
+- `gala_upload_profile_image` - Upload profile image
 
 **Transfer Operations:**
-- `gala_launchpad_transfer_gala` - Transfer GALA from different wallet (the key signs that one transfer and is never stored)
-- `gala_launchpad_transfer_token` takes no override: a `privateKey` is refused (configure the session wallet, `set_wallet`)
+- `gala_transfer_gala` - Transfer GALA from different wallet (the key signs that one transfer and is never stored)
+- `gala_transfer_token` takes no override: a `privateKey` is refused (configure the session wallet, `set_wallet`)
 
 **Profile:**
-- `gala_launchpad_update_profile` - Update profile for different wallet
+- `gala_update_profile` - Update profile for different wallet
 
 ### Example: Multi-Wallet Trading Scenario
 
@@ -959,14 +957,14 @@ Ask Claude:
 Claude will use:
 ```javascript
 // 1. Main wallet sends GALA to Buster
-gala_launchpad_transfer_gala({
+gala_transfer_gala({
   recipientAddress: "0xBusterAddress...",
   amount: "1000"
   // No privateKey - uses main wallet
 });
 
 // 2. Buster buys tokens with his wallet
-gala_launchpad_buy({
+gala_buy({
   tokenName: "tinyevil",
   amount: "100",
   type: "native",
@@ -976,7 +974,7 @@ gala_launchpad_buy({
 });
 
 // 3. Buster sells tokens
-gala_launchpad_sell({
+gala_sell({
   tokenName: "tinyevil",
   amount: "50",
   type: "native",