🔗 Seamless Blockchain Integration for Claude AI
Execute gasless transactions, swaps, and transfers directly from your Claude conversations
🚀 Quick Start • 📖 Documentation • 🛠️ Development • 🤝 Contributing
The 0xGasless MCP Server is a powerful Model Context Protocol server that bridges Claude AI with blockchain networks. Built on ERC-4337 Account Abstraction, it enables gasless blockchain operations through natural language conversations.
- 🆓 Zero Gas Fees - Execute transactions without holding native tokens
- 🌐 Multi-Chain Support - 8+ blockchain networks supported
- 🤖 AI-Native - Natural language blockchain interactions
- 🔒 Secure - Smart account abstraction with enhanced security
- ⚡ Instant Setup - One-command Claude integration
| Tool | Description | Example Usage |
|---|---|---|
🏠 get-address |
Retrieve your smart account address | "What's my wallet address?" |
💰 get-balance |
Check token balances (ERC20 support) | "Show my USDC balance" |
📤 transfer-token |
Send tokens gaslessly | "Send 10 USDT to alice.eth" |
🔄 swap-tokens |
Exchange tokens without gas | "Swap 100 USDT for USDC" |
🎯 buy-openrouter-credits |
Purchase AI credits with USDC | "Buy $25 OpenRouter credits" |
🌉 bridge-tokens |
Bridge tokens across chains using deBridge | "Bridge 100 USDC from Avalanche to Ethereum" |
📊 sxt-query-data |
Query blockchain data using Space and Time | "Show my transaction history" |
Preferred installation method:
# Global installation (recommended)
npm install -g 0xgasless/mcp0xgasless-mcp configureThis interactive command will:
- ✅ Collect your API keys and configuration
- ✅ Detect your operating system
- ✅ Configure Claude Desktop automatically
- ✅ Validate all inputs
Create a .env file with your configuration:
# 🔑 Required Configuration
PRIVATE_KEY=0x... # Your wallet private key
RPC_URL=https://... # Blockchain RPC endpoint
API_KEY=your_0xgasless_api_key # From dashboard.0xgasless.com
CHAIN_ID=43114 # Target blockchain (see table below)
SXT_API_KEY= # Space & Time Api Key
# 🎯 Optional Configuration
OPENROUTER_API_KEY=your_key # For AI credit purchases| 🌍 Network | 🆔 Chain ID | 💎 Native Token | 🔗 RPC Endpoint |
|---|---|---|---|
| 🔴 Avalanche | 43114 |
AVAX | https://api.avax.network/ext/bc/C/rpc |
| 🟡 BSC | 56 |
BNB | https://bsc-dataseed.binance.org/ |
| 🔵 Base | 8453 |
ETH | https://mainnet.base.org |
| ⚫ Ethereum | 1 |
ETH | https://eth.llamarpc.com |
| 🟣 Polygon | 137 |
MATIC | https://polygon-rpc.com |
| 🔵 Sonic | 156 |
S | https://sonic.drpc.org |
| 🌙 Moonbeam | 1284 |
GLMR | https://rpc.api.moonbeam.network |
The easiest way to integrate with Claude Desktop:
0xgasless-mcp configureAdd to your Claude Desktop configuration file:
📍 Configuration Locations:
- 🍎 macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - 🪟 Windows:
%APPDATA%\Claude\claude_desktop_config.json - 🐧 Linux:
~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"0xgasless": {
"command": "npx",
"args": ["0xgasless-mcp-server"],
"env": {
"PRIVATE_KEY": "0x...",
"RPC_URL": "https://...",
"API_KEY": "your_0xgasless_api_key",
"CHAIN_ID": "43114",
"SXT_API_KEY": "your_space_&_time_api_key",
"OPENROUTER_API_KEY": "your_openrouter_key"
}
}
}
}Once configured, interact with blockchain using natural language:
💬 "What's my wallet balance?"
💬 "Check my USDC balance on BSC"
💬 "Show all my token balances"
💬 "Send 10 USDT to 0x742d35Cc6634C0532925a3b8D4C9db96590b5c8e"
💬 "Transfer 0.1 BNB to alice.eth"
💬 "Send 50 USDC to my friend's wallet"
💬 "Swap 100 USDT for USDC"
💬 "Exchange 0.5 BNB to WETH"
💬 "Convert 1000 BUSD to BNB"
💬 "Find top 10 whale wallets who is doing millions of transactions yearly on Avalanche"
💬 "Buy $10 worth of OpenRouter credits"
💬 "Purchase $25 OpenRouter credits with USDC"
- 🌐 Visit 0xGasless Dashboard
- 📝 Create an account and new project
- 🔑 Copy your API key
- 💳 Add credits to your account
- 🌐 Visit OpenRouter.ai
- 📝 Sign up and navigate to API Keys
- 🔑 Generate a new API key
- 💰 Add credits for AI model access
# Clone the repository
git clone https://github.com/0xgasless/mcp
cd mcp
# Install dependencies
npm install
# Build the project
npm run build
# Development mode with hot reload
npm run dev
# Start the server
npm startsrc/
├── 🎯 main.ts # Core MCP server implementation
├── 🚀 index.ts # CLI entry point & configuration
├── 📋 version.ts # Version management
└── 📝 types/ # TypeScript definitions
- 🔒 Private Keys: Store securely in environment variables, never in code
- 🔑 API Keys: Keep 0xGasless and OpenRouter keys confidential
- 🏦 Smart Accounts: Enhanced security through account abstraction
- ⛽ Gasless Operations: No native tokens required for transactions
- 🚫 Never share your private key with anyone
- 💾 Use environment variables for sensitive data
- 🔄 Regularly rotate your API keys
- 📊 Monitor your account usage and credits
🔴 "Chain ID not supported"
Solution:
- ✅ Verify you're using a supported chain ID from the table above
- ✅ Check the supported networks section
🔴 "API Key invalid"
Solution:
- ✅ Verify your 0xGasless API key is correct
- ✅ Ensure sufficient credits in your 0xGasless account
- ✅ Check API key permissions and expiration
🔴 "Insufficient balance"
Solution:
- ✅ Check token balance before operations
- ✅ Ensure you have enough tokens for the transaction
- ✅ Verify token contract address is correct
🔴 "Private key format error"
Solution:
- ✅ Ensure private key starts with "0x"
- ✅ Verify it's exactly 66 characters (64 + "0x")
- ✅ Check for any extra spaces or characters
Enable detailed logging for troubleshooting:
DEBUG=1 mcpWe welcome contributions! Here's how to get started:
- 🍴 Fork the repository
- 🌿 Create a feature branch:
git checkout -b feature/amazing-feature - 💾 Commit your changes:
git commit -m 'Add amazing feature' - 📤 Push to branch:
git push origin feature/amazing-feature - 🔄 Open a Pull Request
- ✅ Follow TypeScript best practices
- ✅ Add tests for new features
- ✅ Update documentation as needed
- ✅ Ensure all tests pass before submitting
This project is licensed under the MIT License - see the LICENSE file for details.
Special thanks to the amazing teams and projects that make this possible:
- 🎯 0xGasless - Smart account infrastructure
- 🤖 Model Context Protocol - MCP specification
- 🧠 Claude - AI integration capabilities
- 🌐 OpenRouter - AI API access platform
🚀 Made with ❤️ for the blockchain community
Empowering AI-driven blockchain interactions