Package Exports

@gala-chain/launchpad-mcp-server
@gala-chain/launchpad-mcp-server/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@gala-chain/launchpad-mcp-server) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@gala-chain/launchpad-mcp-server

MCP (Model Context Protocol) server for Gala Launchpad SDK - Enables AI agents to interact with Gala Launchpad.

🚀 Features

28 AI-accessible tools for complete Gala Launchpad integration
Type-safe - Full TypeScript support with validated inputs
Production-ready - Built on @gala-chain/launchpad-sdk v3.0.2
Easy setup - Works with Claude Desktop and other MCP clients
Comprehensive - Pool management, trading, balances, token creation, comments, transfers

📦 Installation

npm install -g @gala-chain/launchpad-mcp-server

🏁 Quick Start

Claude Desktop Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "gala-launchpad": {
      "command": "npx",
      "args": ["-y", "@gala-chain/launchpad-mcp-server"],
      "env": {
        "PRIVATE_KEY": "0x1234567890abcdef...",
        "ENVIRONMENT": "development"
      }
    }
  }
}

Environment Variables:

PRIVATE_KEY (required) - Your Ethereum wallet private key
ENVIRONMENT (optional) - development or production (default: development)
DEBUG (optional) - true to enable debug logging
TIMEOUT (optional) - Request timeout in milliseconds (default: 30000)

Using with Claude Desktop

Install: npm install -g @gala-chain/launchpad-mcp-server
Configure: Add server to claude_desktop_config.json (see above)
Restart Claude Desktop
Use tools: Ask Claude to interact with Gala Launchpad!

🛠️ Available Tools (28 Total)

Pool Management (8 tools)

gala_launchpad_fetch_pools - Fetch token pools with filtering
gala_launchpad_fetch_pool_details - Get detailed pool state
gala_launchpad_fetch_token_distribution - Get holder distribution
gala_launchpad_fetch_token_badges - Get achievement badges
gala_launchpad_fetch_volume_data - Get OHLCV charting data
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

Trading Operations (6 tools)

gala_launchpad_calculate_buy_amount - Calculate buy amounts
gala_launchpad_calculate_sell_amount - Calculate sell amounts
gala_launchpad_buy_tokens - Execute token purchase
gala_launchpad_sell_tokens - Execute token sale
gala_launchpad_fetch_trades - Get trade history
gala_launchpad_calculate_initial_buy - Calculate initial buy

Balance & Portfolio (6 tools)

gala_launchpad_fetch_gala_balance - Get GALA balance
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

Token Creation (3 tools)

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_post_comment - Post comment on token
gala_launchpad_fetch_comments - Get token comments

Token Transfers (2 tools)

gala_launchpad_transfer_gala - Transfer GALA tokens
gala_launchpad_transfer_token - Transfer launchpad tokens

Utility Tools (1 tool)

gala_launchpad_get_url_by_token_name - Generate frontend URL for a token

💡 Example Usage

Ask Claude (or your AI assistant):

"Fetch the 10 most recent token pools on Gala Launchpad"

"What's my GALA balance?"

"Calculate how many tokens I'd get if I buy with 100 GALA on dragnrkti"

"Buy 50 GALA worth of rocketri tokens with 5% slippage"

"Show me all tokens I'm holding"

🔧 Development

Local Development

# Clone repository
git clone https://gitlab.com/gala-games/defi/launchpad/sdk.git
cd launchpad-sdk/packages/mcp-server

# Install dependencies
npm install

# Build
npm run build

# Run in development mode
npm run dev

Testing

npm test

📚 Documentation

MCP Tool Specification - Complete tool reference
AI Agent Guide - Integration patterns
SDK Documentation - Underlying SDK reference

🔐 Security

Important Security Notes:

Private Keys - Never commit private keys to version control
Environment Variables - Store credentials in claude_desktop_config.json securely
Wallet Safety - Use separate wallets for development and production
Amount Limits - Consider setting up trading limits for automated agents

🐛 Troubleshooting

"SDK not initialized"

Ensure PRIVATE_KEY is set in environment variables
Check that private key format is valid (0x + 64 hex characters)

"Tool not found"

Restart Claude Desktop after configuration changes
Verify server is listed in Claude Desktop settings

"Connection failed"

Check DEBUG=true logs for detailed error messages
Verify network connectivity to Gala Launchpad backends

📄 License

MIT License - see LICENSE file for details.

🤝 Contributing

Contributions welcome! Please read CONTRIBUTING.md for guidelines.

📞 Support

Issues: GitLab Issues
Documentation: Full Documentation
SDK Package: @gala-chain/launchpad-sdk

Built with ❤️ for the Gala ecosystem