{"_id":"0xgasless-mcp","_rev":"7-780611bda9f6d3d889a1f4fe3ae571cf","name":"0xgasless-mcp","dist-tags":{"latest":"1.0.5"},"versions":{"1.0.3":{"name":"0xgasless-mcp","version":"1.0.3","keywords":["mcp","model-context-protocol","claude","blockchain","0xgasless","gasless","smart-account","web3","ethereum","bsc","swap","defi","account-abstraction"],"author":{"url":"https://github.com/achiit","name":"21Coder's","email":"achihsingh@gmail.com"},"license":"MIT","_id":"0xgasless-mcp@1.0.3","maintainers":[{"name":"achiit","email":"achihsingh@gmail.com"}],"homepage":"https://github.com/achiit/0xgasless-mcp-server#readme","bugs":{"url":"https://github.com/achiit/0xgasless-mcp-server/issues"},"bin":{"0xgasless-mcp":"dist/index.js"},"dist":{"shasum":"4621501d79bf96761a956d90fd21f079f17ef0ac","tarball":"https://registry.npmjs.org/0xgasless-mcp/-/0xgasless-mcp-1.0.3.tgz","fileCount":14,"integrity":"sha512-ocRzx+3bRdd+pCNfNkNNb/g+2KIXh89caYszEdZDp8EcZgbO4QtO0+2QZy2nh2oiUzXNPFLZZsCykE8pIv526g==","signatures":[{"sig":"MEUCIGUl20FiD0CmrOchnZvr740NZ9+6yI1huAnJOnTdfI7tAiEA+JV7N0BcFWyNxy5Jf/+7MemTt9a4JApNjhDM4CTMMTA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":43341},"main":"dist/index.js","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"059eb9edbecbd860af5d9f6d5f8f254dd5ddba1e","scripts":{"dev":"tsc --watch","lint":"eslint src/**/*.ts","test":"echo \"No tests specified\" && exit 0","build":"tsc","start":"node dist/index.js","format":"prettier --write src/**/*.ts","prepublishOnly":"npm run build"},"_npmUser":{"name":"achiit","email":"achihsingh@gmail.com"},"repository":{"url":"git+https://github.com/achiit/0xgasless-mcp-server.git","type":"git"},"_npmVersion":"10.9.2","description":"MCP server for 0xGasless smart accounts with gasless blockchain operations. Directly connects to Claude Desktop","directories":{},"_nodeVersion":"23.4.0","dependencies":{"zod":"^3.23.8","viem":"^2.22.17","tslib":"^2.8.1","dotenv":"^16.4.5","@0xgasless/agentkit":"^0.0.9","@0xgasless/smart-account":"^0.0.13","@modelcontextprotocol/sdk":"^0.6.0"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^8.0.0","prettier":"^3.0.0","typescript":"^5.0.0","@types/node":"^20.0.0","@typescript-eslint/parser":"^6.0.0","@typescript-eslint/eslint-plugin":"^6.0.0"},"peerDependencies":{"node":">=18.0.0"},"_npmOperationalInternal":{"tmp":"tmp/0xgasless-mcp_1.0.3_1748781260012_0.8136361347028114","host":"s3://npm-registry-packages-npm-production"}},"1.0.4":{"name":"0xgasless-mcp","version":"1.0.4","keywords":["mcp","model-context-protocol","claude","blockchain","0xgasless","gasless","smart-account","web3","ethereum","bsc","swap","defi","account-abstraction"],"author":{"url":"https://github.com/achiit","name":"21Coder's","email":"achihsingh@gmail.com"},"license":"MIT","_id":"0xgasless-mcp@1.0.4","maintainers":[{"name":"achiit","email":"achihsingh@gmail.com"}],"homepage":"https://github.com/achiit/0xgasless-mcp-server#readme","bugs":{"url":"https://github.com/achiit/0xgasless-mcp-server/issues"},"bin":{"0xgasless-mcp":"dist/index.js"},"dist":{"shasum":"5a61c01e423b4fa3b3ef616d1667c32291b422cd","tarball":"https://registry.npmjs.org/0xgasless-mcp/-/0xgasless-mcp-1.0.4.tgz","fileCount":14,"integrity":"sha512-NyyElE9TXdx81FM1lvS1LR4oE/+MSJLqECXtlRtdl3qBqs6fDHzOqX5rMxUeXvtxQGZXMwcCAoojTg/lbqvCTw==","signatures":[{"sig":"MEQCIAFg+tbf6Ds7fvcHRCDCAtEf+bYuqBQVPcxvKoXQW+INAiA9wg+0IHLcyH7aZjGIjVS6L9iwZAff5mVvdnbiGHBwpw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":46448},"main":"dist/index.js","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"9b9c1b4560dccd36f082afd817888e9397f5a4e8","scripts":{"dev":"tsc --watch","lint":"eslint src/**/*.ts","test":"echo \"No tests specified\" && exit 0","build":"tsc","start":"node dist/index.js","format":"prettier --write src/**/*.ts","prepublishOnly":"npm run build"},"_npmUser":{"name":"achiit","email":"achihsingh@gmail.com"},"repository":{"url":"git+https://github.com/achiit/0xgasless-mcp-server.git","type":"git"},"_npmVersion":"10.9.2","description":"MCP server for 0xGasless smart accounts with gasless blockchain operations. Directly connects to Claude Desktop","directories":{},"_nodeVersion":"23.4.0","dependencies":{"zod":"^3.23.8","viem":"^2.22.17","tslib":"^2.8.1","dotenv":"^16.4.5","@0xgasless/agentkit":"^0.0.9","@0xgasless/smart-account":"^0.0.13","@modelcontextprotocol/sdk":"^0.6.0"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^8.0.0","prettier":"^3.0.0","typescript":"^5.0.0","@types/node":"^20.0.0","@typescript-eslint/parser":"^6.0.0","@typescript-eslint/eslint-plugin":"^6.0.0"},"peerDependencies":{"node":">=18.0.0"},"_npmOperationalInternal":{"tmp":"tmp/0xgasless-mcp_1.0.4_1749076961557_0.7750191138056259","host":"s3://npm-registry-packages-npm-production"}},"1.0.5":{"name":"0xgasless-mcp","version":"1.0.5","description":"MCP server for 0xGasless smart accounts with gasless blockchain operations. Directly connects to Claude Desktop","main":"dist/index.js","bin":{"0xgasless-mcp":"dist/index.js"},"scripts":{"build":"tsc","dev":"tsc --watch","start":"node dist/index.js","prepublishOnly":"npm run build","test":"echo \"No tests specified\" && exit 0","lint":"eslint src/**/*.ts","format":"prettier --write src/**/*.ts"},"keywords":["mcp","model-context-protocol","claude","blockchain","0xgasless","gasless","smart-account","web3","ethereum","bsc","swap","defi","account-abstraction"],"author":{"name":"21Coder's","email":"achihsingh@gmail.com","url":"https://github.com/achiit"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/achiit/0xgasless-mcp-server.git"},"bugs":{"url":"https://github.com/achiit/0xgasless-mcp-server/issues"},"homepage":"https://github.com/achiit/0xgasless-mcp-server#readme","engines":{"node":">=18.0.0"},"dependencies":{"@0xgasless/agentkit":"^0.0.9","@0xgasless/smart-account":"^0.0.13","@modelcontextprotocol/sdk":"^0.6.0","dotenv":"^16.4.5","viem":"^2.22.17","tslib":"^2.8.1","zod":"^3.23.8"},"devDependencies":{"@types/node":"^20.0.0","typescript":"^5.0.0","eslint":"^8.0.0","@typescript-eslint/eslint-plugin":"^6.0.0","@typescript-eslint/parser":"^6.0.0","prettier":"^3.0.0"},"peerDependencies":{"node":">=18.0.0"},"_id":"0xgasless-mcp@1.0.5","gitHead":"897e09f3831ba673d62699c6bdcbb44ed0787fb7","types":"./dist/index.d.ts","_nodeVersion":"23.4.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-HuxxLJAMkg6Rim/14PMmB6oCPDqHVb01ICHW8NJhFyylTU0sNwbo7g2UPu+Kcf6kXxVNLjTcRjBFZjF+aHgXzw==","shasum":"30e998119f9371a6b4215b917e521b0906769199","tarball":"https://registry.npmjs.org/0xgasless-mcp/-/0xgasless-mcp-1.0.5.tgz","fileCount":15,"unpackedSize":47511,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCTV2chjzsGaf7jf1E+MnIIFgh9KxQ0DfXBxvszQz/sNgIgQXwxp/sMMTI1NYRdAbnOt+IoDmPvZ8A91lJ3ZtX+eFo="}]},"_npmUser":{"name":"achiit","email":"achihsingh@gmail.com"},"directories":{},"maintainers":[{"name":"achiit","email":"achihsingh@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/0xgasless-mcp_1.0.5_1749077642783_0.6259904543582389"},"_hasShrinkwrap":false}},"time":{"created":"2025-06-01T12:34:20.011Z","modified":"2025-06-04T22:54:03.247Z","1.0.0":"2025-05-24T08:12:02.628Z","1.0.1":"2025-05-24T08:47:19.913Z","1.0.2":"2025-05-24T08:52:08.843Z","1.0.3":"2025-06-01T12:34:20.222Z","1.0.4":"2025-06-04T22:42:41.770Z","1.0.5":"2025-06-04T22:54:03.048Z"},"bugs":{"url":"https://github.com/achiit/0xgasless-mcp-server/issues"},"author":{"name":"21Coder's","email":"achihsingh@gmail.com","url":"https://github.com/achiit"},"license":"MIT","homepage":"https://github.com/achiit/0xgasless-mcp-server#readme","keywords":["mcp","model-context-protocol","claude","blockchain","0xgasless","gasless","smart-account","web3","ethereum","bsc","swap","defi","account-abstraction"],"repository":{"type":"git","url":"git+https://github.com/achiit/0xgasless-mcp-server.git"},"description":"MCP server for 0xGasless smart accounts with gasless blockchain operations. Directly connects to Claude Desktop","maintainers":[{"name":"achiit","email":"achihsingh@gmail.com"}],"readme":"\n# 🚀 0xGasless MCP Server\n\n\n**🔗 Seamless Blockchain Integration for Claude AI**\n\n*Execute gasless transactions, swaps, and transfers directly from your Claude conversations*\n\n[🚀 Quick Start](#-quick-start) • [📖 Documentation](#-documentation) • [🛠️ Development](#️-development) • [🤝 Contributing](#-contributing)\n\n</div>\n\n---\n\n## 🌟 What is 0xGasless MCP Server?\n\nThe **0xGasless MCP Server** is a powerful [Model Context Protocol](https://modelcontextprotocol.io) server that bridges Claude AI with blockchain networks. Built on **ERC-4337 Account Abstraction**, it enables gasless blockchain operations through natural language conversations.\n\n### ✨ Key Highlights\n\n- 🆓 **Zero Gas Fees** - Execute transactions without holding native tokens\n- 🌐 **Multi-Chain Support** - 8+ blockchain networks supported\n- 🤖 **AI-Native** - Natural language blockchain interactions\n- 🔒 **Secure** - Smart account abstraction with enhanced security\n- ⚡ **Instant Setup** - One-command Claude integration\n\n---\n\n## 🛠️ Available Tools\n\n| Tool | Description | Example Usage |\n|------|-------------|---------------|\n| 🏠 `get-address` | Retrieve your smart account address | *\"What's my wallet address?\"* |\n| 💰 `get-balance` | Check token balances (ERC20 support) | *\"Show my USDC balance\"* |\n| 📤 `transfer-token` | Send tokens gaslessly | *\"Send 10 USDT to alice.eth\"* |\n| 🔄 `swap-tokens` | Exchange tokens without gas | *\"Swap 100 USDT for USDC\"* |\n| 🎯 `buy-openrouter-credits` | Purchase AI credits with USDC | *\"Buy $25 OpenRouter credits\"* |\n\n---\n\n## 🚀 Quick Start\n\n### 📦 Installation\n\nChoose your preferred installation method:\n\n```bash\n# Global installation (recommended)\nnpm install -g 0xgasless-mcp\n\n# Or use directly with npx\nnpx 0xgasless-mcp\n```\n\n### ⚙️ Configuration\n\n#### 1️⃣ Automatic Setup (Easiest)\n\n```bash\n0xgasless-mcp configure\n```\n\nThis interactive command will:\n- ✅ Collect your API keys and configuration\n- ✅ Detect your operating system\n- ✅ Configure Claude Desktop automatically\n- ✅ Validate all inputs\n\n#### 2️⃣ Manual Environment Setup\n\nCreate a `.env` file with your configuration:\n\n```bash\n# 🔑 Required Configuration\nPRIVATE_KEY=0x...                    # Your wallet private key\nRPC_URL=https://...                  # Blockchain RPC endpoint\nAPI_KEY=your_0xgasless_api_key      # From dashboard.0xgasless.com\nCHAIN_ID=56                         # Target blockchain (see table below)\n\n# 🎯 Optional Configuration  \nOPENROUTER_API_KEY=your_key         # For AI credit purchases\n```\n\n---\n\n## 🌐 Supported Networks\n\n| 🌍 Network | 🆔 Chain ID | 💎 Native Token | 🔗 RPC Endpoint |\n|------------|-------------|-----------------|------------------|\n| 🟡 **BSC** | `56` | BNB | `https://bsc-dataseed.binance.org/` |\n| 🔵 **Base** | `8453` | ETH | `https://mainnet.base.org` |\n| ⚫ **Ethereum** | `1` | ETH | `https://eth.llamarpc.com` |\n| 🟣 **Polygon** | `137` | MATIC | `https://polygon-rpc.com` |\n| 🔴 **Avalanche** | `43114` | AVAX | `https://api.avax.network/ext/bc/C/rpc` |\n| 🔵 **Fantom** | `250` | FTM | `https://rpc.ftm.tools` |\n| 🌙 **Moonbeam** | `1284` | GLMR | `https://rpc.api.moonbeam.network` |\n| 🟢 **Metis** | `1088` | METIS | `https://andromeda.metis.io/?owner=1088` |\n\n---\n\n## 🔗 Claude Desktop Integration\n\n### 🎯 Automatic Configuration\n\nThe easiest way to integrate with Claude Desktop:\n\n```bash\n0xgasless-mcp configure\n```\n\n### 📝 Manual Configuration\n\nAdd to your Claude Desktop configuration file:\n\n**📍 Configuration Locations:**\n- 🍎 **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- 🪟 **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n- 🐧 **Linux**: `~/.config/Claude/claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"0xgasless\": {\n      \"command\": \"npx\",\n      \"args\": [\"0xgasless-mcp-server\"],\n      \"env\": {\n        \"PRIVATE_KEY\": \"0x...\",\n        \"RPC_URL\": \"https://...\",\n        \"API_KEY\": \"your_0xgasless_api_key\",\n        \"CHAIN_ID\": \"56\",\n        \"OPENROUTER_API_KEY\": \"your_openrouter_key\"\n      }\n    }\n  }\n}\n```\n\n---\n\n## 💬 Usage Examples\n\nOnce configured, interact with blockchain using natural language:\n\n### 💰 Balance Inquiries\n```\n💬 \"What's my wallet balance?\"\n💬 \"Check my USDC balance on BSC\"\n💬 \"Show all my token balances\"\n```\n\n### 📤 Token Transfers\n```\n💬 \"Send 10 USDT to 0x742d35Cc6634C0532925a3b8D4C9db96590b5c8e\"\n💬 \"Transfer 0.1 BNB to alice.eth\"\n💬 \"Send 50 USDC to my friend's wallet\"\n```\n\n### 🔄 Token Swaps\n```\n💬 \"Swap 100 USDT for USDC\"\n💬 \"Exchange 0.5 BNB to WETH\"\n💬 \"Convert 1000 BUSD to BNB\"\n```\n\n### 🎯 AI Credit Purchases\n```\n💬 \"Buy $10 worth of OpenRouter credits\"\n💬 \"Purchase $25 OpenRouter credits with USDC\"\n```\n\n---\n\n## 🔑 API Keys Setup\n\n### 🎯 0xGasless API Key\n1. 🌐 Visit [0xGasless Dashboard](https://dashboard.0xgasless.com)\n2. 📝 Create an account and new project\n3. 🔑 Copy your API key\n4. 💳 Add credits to your account\n\n### 🤖 OpenRouter API Key (Optional)\n1. 🌐 Visit [OpenRouter.ai](https://openrouter.ai)\n2. 📝 Sign up and navigate to API Keys\n3. 🔑 Generate a new API key\n4. 💰 Add credits for AI model access\n\n---\n\n## 🛠️ Development\n\n### 🏗️ Local Development Setup\n\n```bash\n# Clone the repository\ngit clone https://github.com/achiit/0xgasless-mcp-server.git\ncd 0xgasless-mcp-server\n\n# Install dependencies\nnpm install\n\n# Build the project\nnpm run build\n\n# Development mode with hot reload\nnpm run dev\n\n# Start the server\nnpm start\n```\n\n### 📁 Project Structure\n\n```\nsrc/\n├── 🎯 main.ts          # Core MCP server implementation\n├── 🚀 index.ts         # CLI entry point & configuration\n├── 📋 version.ts       # Version management\n└── 📝 types/           # TypeScript definitions\n```\n\n---\n\n## 🔐 Security & Best Practices\n\n### 🛡️ Security Guidelines\n\n- 🔒 **Private Keys**: Store securely in environment variables, never in code\n- 🔑 **API Keys**: Keep 0xGasless and OpenRouter keys confidential\n- 🏦 **Smart Accounts**: Enhanced security through account abstraction\n- ⛽ **Gasless Operations**: No native tokens required for transactions\n\n### ⚠️ Important Notes\n\n- 🚫 Never share your private key with anyone\n- 💾 Use environment variables for sensitive data\n- 🔄 Regularly rotate your API keys\n- 📊 Monitor your account usage and credits\n\n---\n\n## 🆘 Troubleshooting\n\n### 🐛 Common Issues & Solutions\n\n<details>\n<summary>🔴 \"Chain ID not supported\"</summary>\n\n**Solution:**\n- ✅ Verify you're using a supported chain ID from the table above\n- ✅ Check the [supported networks](#-supported-networks) section\n</details>\n\n<details>\n<summary>🔴 \"API Key invalid\"</summary>\n\n**Solution:**\n- ✅ Verify your 0xGasless API key is correct\n- ✅ Ensure sufficient credits in your 0xGasless account\n- ✅ Check API key permissions and expiration\n</details>\n\n<details>\n<summary>🔴 \"Insufficient balance\"</summary>\n\n**Solution:**\n- ✅ Check token balance before operations\n- ✅ Ensure you have enough tokens for the transaction\n- ✅ Verify token contract address is correct\n</details>\n\n<details>\n<summary>🔴 \"Private key format error\"</summary>\n\n**Solution:**\n- ✅ Ensure private key starts with \"0x\"\n- ✅ Verify it's exactly 66 characters (64 + \"0x\")\n- ✅ Check for any extra spaces or characters\n</details>\n\n### 🔍 Debug Mode\n\nEnable detailed logging for troubleshooting:\n\n```bash\nDEBUG=1 0xgasless-mcp-server\n```\n\n---\n\n## 🤝 Contributing\n\nWe welcome contributions! Here's how to get started:\n\n### 🚀 Quick Contribution Guide\n\n1. 🍴 **Fork** the repository\n2. 🌿 **Create** a feature branch: `git checkout -b feature/amazing-feature`\n3. 💾 **Commit** your changes: `git commit -m 'Add amazing feature'`\n4. 📤 **Push** to branch: `git push origin feature/amazing-feature`\n5. 🔄 **Open** a Pull Request\n\n### 📋 Development Guidelines\n\n- ✅ Follow TypeScript best practices\n- ✅ Add tests for new features\n- ✅ Update documentation as needed\n- ✅ Ensure all tests pass before submitting\n\n---\n\n## 📄 License\n\nThis project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.\n\n---\n\n## 🙏 Acknowledgments\n\nSpecial thanks to the amazing teams and projects that make this possible:\n\n- 🎯 **[0xGasless](https://0xgasless.com)** - Smart account infrastructure\n- 🤖 **[Model Context Protocol](https://modelcontextprotocol.io)** - MCP specification\n- 🧠 **[Claude](https://claude.ai)** - AI integration capabilities  \n- 🌐 **[OpenRouter](https://openrouter.ai)** - AI API access platform\n\n---\n\n## 📚 Resources & Links\n\n### 📖 Documentation\n- 📘 [0xGasless Documentation](https://docs.0xgasless.com)\n- 📗 [MCP Documentation](https://modelcontextprotocol.io/docs)\n- 📙 [Claude MCP Guide](https://docs.anthropic.com/claude/docs/mcp)\n\n### 🔗 Project Links\n- 🏠 [GitHub Repository](https://github.com/achiit/0xgasless-mcp-server)\n- 📦 [npm Package](https://www.npmjs.com/package/0xgasless-mcp)\n- 🐛 [Report Issues](https://github.com/achiit/0xgasless-mcp-server/issues)\n- 💬 [Discussions](https://github.com/achiit/0xgasless-mcp-server/discussions)\n\n---\n\n<div align=\"center\">\n\n**🚀 Made with ❤️ for the blockchain community**\n\n*Empowering AI-driven blockchain interactions*\n\n[![Follow on GitHub](https://img.shields.io/github/followers/achiit?style=social)](https://github.com/achiit)\n[![Star this repo](https://img.shields.io/github/stars/achiit/0xgasless-mcp-server?style=social)](https://github.com/achiit/0xgasless-mcp-server)\n\n</div>\n","readmeFilename":"README.md"}