@gala-chain/launchpad-mcp-server 4.0.22-beta.5 → 4.0.23

package/MCP_COVERAGE_REPORT.md

@@ -0,0 +1,164 @@
+# MCP Coverage Audit Report
+
+**Audit Date:** 2025-12-09
+**SDK Version:** 4.0.22-beta.5
+**MCP Tools:** 132
+**Prompts:** 103
+**explainSdkUsage Topics:** 36
+
+## Summary
+
+| Category | Total | Covered | Excluded | Missing | Coverage |
+|----------|-------|---------|----------|---------|----------|
+| SDK → MCP Tools | 116 | 114 | 2 | 0 | 98% |
+| MCP Tools → Prompts | 132 | 103+ | 0 | ~29 | 78% |
+| explainSdkUsage | 116 | 100+ | 12 | ~4 | 95% |
+
+## SDK Methods → MCP Tools Coverage
+
+**116 SDK public async methods, 132 MCP tools**
+
+The MCP server provides MORE tools than SDK methods because it includes:
+- Utility tools (getConfig, getVersion, getEnvironment, switchEnvironment)
+- Wallet management (hasWallet, getWallet, setWallet, createWallet, createSolanaWallet)
+- Key derivation (getPublicKeyFromPrivateKey, getEthereumAddressFromPrivateKey)
+- Cache management (getCacheInfo, clearCache)
+- explainSdkUsage (documentation tool)
+- Event watchers (onDexPoolCreation, onLaunchpadTokenCreation)
+
+### Excluded Methods (Intentional - Not Appropriate for MCP)
+
+| Method | Reason |
+|--------|--------|
+| `fetchAvailableBalance` | Duplicate of fetchGalaBalance |
+| `fetchTokenClassesWithSupply` | Internal GalaChain method |
+
+### Name Mapping Differences
+
+| SDK Method | MCP Tool |
+|------------|----------|
+| `buy()` | `gala_launchpad_buy_tokens` |
+| `sell()` | `gala_launchpad_sell_tokens` |
+| `isTokenNameAvailable()` | `gala_launchpad_check_token_name` |
+| `isTokenSymbolAvailable()` | `gala_launchpad_check_token_symbol` |
+| `fetchGalaPrice()` | `gala_launchpad_fetch_gala_spot_price` |
+| `fetchTokenPrice()` | `gala_launchpad_fetch_token_spot_price` |
+| `fetchLockedBalance()` | `gala_launchpad_fetch_locked_tokens` |
+| `getSwapLiquidityPosition()` | `gala_launchpad_get_liquidity_position` |
+| `getSwapLiquidityPositionById()` | `gala_launchpad_get_liquidity_position_by_id` |
+| `getSwapUserLiquidityPositions()` | `gala_launchpad_get_user_liquidity_positions` |
+| `getAllSwapUserLiquidityPositions()` | `gala_launchpad_get_all_user_liquidity_positions` |
+| `getSwapEstimateRemoveLiquidity()` | `gala_launchpad_estimate_remove_liquidity` |
+| `collectSwapPositionFees()` | `gala_launchpad_collect_position_fees` |
+| `removeSwapLiquidity()` | `gala_launchpad_remove_liquidity` |
+| `addSwapLiquidityByPrice()` | `gala_launchpad_add_liquidity_by_price` |
+| `addSwapLiquidityByTicks()` | `gala_launchpad_add_liquidity_by_ticks` |
+
+## MCP Tools → Prompt Coverage
+
+**103 prompts covering workflow scenarios**
+
+Prompts are workflow-based, not 1:1 with tools. Each prompt covers a use case that may involve multiple tools.
+
+### Tools Without Direct Prompt (Expected)
+
+Utility tools don't need workflow prompts - they're self-documenting:
+- `gala_launchpad_get_config`
+- `gala_launchpad_get_version`
+- `gala_launchpad_get_cache_info`
+- `gala_launchpad_clear_cache`
+- `gala_launchpad_cleanup`
+- `gala_launchpad_explain_sdk_usage`
+
+Bridge/wrap detail tools covered by main workflow prompts:
+- Individual balance query tools (covered by portfolio/bridge prompts)
+- Individual bridgeable token checks (covered by bridge-tokens prompt)
+- Individual wrappable token checks (covered by wrap-related prompts)
+
+## explainSdkUsage Topic Coverage
+
+**36 topics covering SDK method documentation**
+
+### Topics
+
+1. buy-tokens
+2. sell-tokens
+3. pool-graduation
+4. fetch-pools
+5. balances
+6. token-creation
+7. token-details
+8. token-distribution
+9. token-status
+10. multi-wallet
+11. transfers
+12. locks
+13. dex-trading
+14. error-handling
+15. installation
+16. local-calculations
+17. price-history
+18. spot-prices-smart-routing
+19. profile-management
+20. liquidity-positions
+21. advanced-dex-analysis
+22. trading-analytics
+23. utilities-and-helpers
+24. utilities-system
+25. fetch-all-dex-seasons
+26. fetch-current-dex-season
+27. fetch-dex-leaderboard-by-season-id
+28. fetch-dex-aggregated-volume-summary
+29. fetch-dex-pools
+30. event-subscriptions
+31. mcp-to-sdk-mapping
+32. bridge-operations
+33. dex-token-discovery
+34. wrap-unwrap-operations
+35. referral-system
+36. account-management
+
+## Slash Command Sync Results
+
+| File | Field | Old | New | Status |
+|------|-------|-----|-----|--------|
+| test-mcp-tools.md | Total tools | 128 | 132 | UPDATED |
+| test-mcp-tools.md | balance | 7 | 12 | UPDATED |
+| test-mcp-tools.md | locks | 4 | 3 | UPDATED |
+| test-mcp-tools.md | bridge | 11 | 31 | UPDATED |
+| scour-docs.md | Tool count | 128 | 132 | UPDATED |
+| scour-docs.md | Topics | 33 | 36 | UPDATED |
+
+## Tool Categories Summary
+
+| Category | Count | Description |
+|----------|-------|-------------|
+| utilities | 19 | config, version, wallet, cache, environment, key derivation |
+| pools | 19 | fetch pools, details, prices, watchers |
+| balance | 12 | GALA balance, token balance, profile, locked tokens, referrals, registerAccount |
+| trading | 13 | buy/sell, calculations, graduation |
+| dex | 29 | swaps, quotes, liquidity, leaderboard, token discovery |
+| creation | 4 | launch token, upload images |
+| transfers | 2 | GALA/token transfers |
+| locks | 3 | lock/unlock/burn tokens |
+| bridge | 31 | cross-chain bridging, wrap/unwrap, bridgeable tokens |
+| **Total** | **132** | |
+
+## Recommendations
+
+### No Action Required
+- SDK → MCP coverage is excellent (98%+)
+- All critical SDK methods have MCP tool equivalents
+- explainSdkUsage has comprehensive topic coverage
+
+### Future Improvements (Low Priority)
+1. Add prompts for new referral tools:
+   - `galachain-launchpad:referrals` - View referral stats
+   - `galachain-launchpad:register` - Register account for trading
+
+2. Consider consolidating similar balance prompts into comprehensive portfolio workflows
+
+---
+
+**Generated:** 2025-12-09T$(date +%H:%M:%S)
+**Tool:** /scour-mcp audit

package/MCP_TEST_ANALYSIS.md

@@ -1,10 +1,10 @@
 # MCP Tool Test Analysis
 
-**Last Updated:** 2025-12-09 (v4.0.22-beta.2)
-**Total Tools:** 128
+**Last Updated:** 2025-12-09 (v4.0.22-beta.5)
+**Total Tools:** 132
 **Environment:** STAGE
-**SDK Version:** 4.0.22-beta.2
-**MCP Version:** 4.0.22-beta.2
+**SDK Version:** 4.0.22-beta.5
+**MCP Version:** 4.0.22-beta.5
 
 ## Summary
 
@@ -12,17 +12,17 @@
 |----------|-------|------|------|------|-----------------|
 | utilities | 19 | 19 | 0 | 0 | 0 |
 | pools | 19 | 19 | 0 | 0 | 0 |
-| balance | 8 | 8 | 0 | 0 | 0 |
+| balance | 12 | 12 | 0 | 0 | 0 |
 | trading | 13 | 12 | 0 | 1 | 0 |
 | dex | 29 | 29 | 0 | 0 | 0 |
 | creation | 4 | 4 | 0 | 0 | 0 |
 | transfers | 2 | 2 | 0 | 0 | 0 |
 | locks | 3 | 3 | 0 | 0 | 0 |
 | bridge | 31 | 30 | 0 | 0 | 1 |
-| **TOTAL** | **128** | **126** | **0** | **1** | **1** |
+| **TOTAL** | **132** | **130** | **0** | **1** | **1** |
 
-**Coverage: 100%** (128/128 tools accounted for)
-**Pass Rate: 100%** (126/126 testable tools passed)
+**Coverage: 100%** (132/132 tools accounted for)
+**Pass Rate: 100%** (130/130 testable tools passed)
 
 ---
 
@@ -77,7 +77,7 @@
 
 ---
 
-## BALANCE (8 tools) - 8 PASS
+## BALANCE (12 tools) - 12 PASS
 
 | Tool | Status | Notes |
 |------|--------|-------|
@@ -88,7 +88,11 @@
 | `gala_launchpad_fetch_tokens_created` | PASS | Returns tokens created by address |
 | `gala_launchpad_fetch_profile` | PASS | Returns user profile data |
 | `gala_launchpad_update_profile` | PASS | Write operation - updates profile data |
-| `gala_launchpad_fetch_referral_url` | PASS | Returns user's referral URL |
+| `gala_launchpad_fetch_referral_url` | PASS | Returns user's unique referral URL |
+| `gala_launchpad_fetch_referrals` | PASS | Returns paginated list of referred users |
+| `gala_launchpad_fetch_all_referrals` | PASS | Returns all referrals with auto-pagination |
+| `gala_launchpad_fetch_referrals_summary` | PASS | Returns referral count and reward totals (day/month/total) |
+| `gala_launchpad_register_account` | PASS | Registers wallet for trading, returns { exists, walletAlias } |
 
 ---
 
@@ -249,6 +253,7 @@ DEX pool operations require full token class key format: `GALA|Unit|none|none` (
 
 | Version | Date | Changes |
 |---------|------|---------|
+| v4.0.22-beta.5 | 2025-12-09 | Added 4 tools: `register_account`, `fetch_referrals`, `fetch_all_referrals`, `fetch_referrals_summary` (132 tools) |
 | v4.0.22-beta.2 | 2025-12-09 | `get_config` returns `gasFee: "1"` |
 | v4.0.22-beta.1 | 2025-12-09 | Batch lock/unlock + burn_tokens (128 tools) |
 | v4.0.20-beta.2 | 2025-12-09 | `bridge_in` from Solana fixed with retry logic |
@@ -264,6 +269,13 @@ DEX pool operations require full token class key format: `GALA|Unit|none|none` (
 
 ## Recent Test Highlights
 
+### v4.0.22-beta.5 (2025-12-09)
+- ✅ `register_account` - registers wallet, returns `{ exists: true, walletAlias: "eth|..." }`
+- ✅ `fetch_referral_url` - returns unique referral URL for sharing
+- ✅ `fetch_referrals` - paginated list of referred users (empty for test wallet)
+- ✅ `fetch_all_referrals` - auto-paginated version
+- ✅ `fetch_referrals_summary` - returns `{ referralCount, rewardTotals: { pastDay, pastMonth, total } }`
+
 ### v4.0.22-beta.2 (2025-12-09)
 - ✅ `get_config` now returns `gasFee: "1"` (fixed 1 GALA gas fee)
 

package/dist/generated/version.d.ts

@@ -3,5 +3,5 @@
  * This file is generated by scripts/inject-version.ts during build
  * DO NOT EDIT MANUALLY
  */
-export declare const MCP_SERVER_VERSION = "4.0.22-beta.5";
+export declare const MCP_SERVER_VERSION = "4.0.23";
 //# sourceMappingURL=version.d.ts.map

package/dist/generated/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/generated/version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,kBAAkB,kBAAkB,CAAC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/generated/version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,kBAAkB,WAAW,CAAC"}

package/dist/generated/version.js

@@ -6,5 +6,5 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MCP_SERVER_VERSION = void 0;
-exports.MCP_SERVER_VERSION = '4.0.22-beta.5';
+exports.MCP_SERVER_VERSION = '4.0.23';
 //# sourceMappingURL=version.js.map

package/dist/generated/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/generated/version.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEU,QAAA,kBAAkB,GAAG,eAAe,CAAC"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/generated/version.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEU,QAAA,kBAAkB,GAAG,QAAQ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gala-chain/launchpad-mcp-server",
-  "version": "4.0.22-beta.5",
+  "version": "4.0.23",
   "description": "MCP server for Gala Launchpad - 128 tools (pool management, event watchers, GSwap DEX trading, price history, token creation, wallet management, DEX pool discovery, liquidity positions, token locks/burns, locked token queries, composite pool data, cross-chain bridging, wrap/unwrap, key derivation) supporting optional wallet (read-only and full-access modes). Production-grade AI agent integration for Claude Desktop with comprehensive validation and 80%+ test coverage",
   "main": "dist/index.js",
   "bin": {
@@ -73,7 +73,7 @@
   "dependencies": {
     "@gala-chain/api": "^2.4.3",
     "@gala-chain/connect": "^2.4.3",
-    "@gala-chain/launchpad-sdk": "4.0.22-beta.5",
+    "@gala-chain/launchpad-sdk": "^4.0.23",
     "@humanwhocodes/config-array": "^0.13.0",
     "@modelcontextprotocol/sdk": "^0.5.0",
     "axios": "^1.12.2",