# Hyperion MCP Server Documentation
Welcome to the **Hyperion MCP Server** documentation! This Model Context Protocol (MCP) server enables seamless interaction with the Hyperion blockchain testnet, providing AI assistants and developers with powerful blockchain capabilities.
## 🌟 Overview
Hyperion MCP Server is a comprehensive blockchain integration tool that allows you to:
- **Manage Wallets**: Create, import, and manage multiple Ethereum-compatible wallets
- **Execute Transactions**: Send native tokens (tMETIS) and ERC20 tokens
- **Deploy Smart Contracts**: Deploy and interact with ERC20 and ERC721 (NFT) contracts
- **Query Blockchain Data**: Get balances, transaction details, block information, and network status
- **Token Operations**: Mint tokens, query token information, and manage token contracts
## 🎯 Key Features
### Wallet Management
- Create new wallets with secure mnemonic phrases
- Import existing wallets via private key or mnemonic
- Multi-wallet support with easy switching
- Secure local storage
### Blockchain Operations
- Send native tMETIS tokens
- Transfer ERC20 tokens
- Estimate gas costs
- Query transaction and block data
- Real-time network information
### Smart Contract Deployment
- Deploy ERC20 tokens with customizable parameters
- Deploy ERC721 (NFT) collections
- Mintable and non-mintable contract options
- Gas-optimized contract variants
### Token Management
- Comprehensive token information queries
- Mint additional tokens (for mintable contracts)
- NFT minting and metadata management
- Balance checking for any token
## 🚀 Quick Start
```bash
# Install dependencies
npm install
# Build the server
npm run build
# Run locally
npm run dev:local
```
## 📚 Documentation Structure
- **[Getting Started](./getting-started.md)** - Installation, setup, and first steps
- **[Configuration](./configuration.md)** - Environment variables and configuration options
- **[Wallet Management](./wallet-management.md)** - Creating and managing wallets
- **[Blockchain Operations](./blockchain-operations.md)** - Sending transactions and querying data
- **[Token Operations](./token-operations.md)** - ERC20 and ERC721 token management
- **[API Reference](./api-reference.md)** - Complete tool reference
- **[Integration Guide](./integration-guide.md)** - Integrate with Claude Desktop, Cline, and more
- **[Examples](./examples.md)** - Real-world usage examples
- **[Troubleshooting](./troubleshooting.md)** - Common issues and solutions
- **[FAQ](./faq.md)** - Frequently asked questions
## 🔗 Network Information
**Hyperion Testnet**
- **Chain ID**: 133717
- **RPC URL**: https://rpc.hyperion-testnet.metisdevops.link
- **Explorer**: https://hyperion-testnet.metisdevops.link
- **Native Token**: tMETIS (testnet METIS)
## 🛠️ Technology Stack
- **TypeScript** - Type-safe development
- **Ethers.js v6** - Ethereum library for blockchain interactions
- **Model Context Protocol (MCP)** - AI assistant integration standard
- **Smithery** - MCP server deployment platform
## 📦 Installation Methods
### Via NPM (Recommended)
```bash
npm install -g hyperion-mcp-server
```
### Via Smithery
```bash
npx @smithery/cli install hyperion-mcp-server
```
### From Source
```bash
git clone https://github.com/cuongpo/hyperion-mcp-server.git
cd hyperion-mcp-server
npm install
npm run build
```
## 🤝 Support & Community
- **GitHub Issues**: [Report bugs or request features](https://github.com/cuongpo/hyperion-mcp-server/issues)
- **Documentation**: [Full documentation](https://docs.hyperion-mcp.dev)
- **Examples**: Check the [examples directory](./examples.md)
## 📄 License
MIT License - see [LICENSE](../LICENSE) for details
## 🔐 Security
- Never commit private keys or mnemonics to version control
- Use environment variables for sensitive data
- Always verify transaction details before signing
- Keep your wallet backups secure
## 🎓 Next Steps
1. Follow the [Getting Started Guide](./getting-started.md) to set up your first wallet
2. Explore [Examples](./examples.md) to see common use cases
3. Check the [API Reference](./api-reference.md) for detailed tool documentation
4. Join our community and contribute!
---
**Ready to build on Hyperion?** Start with the [Getting Started Guide](./getting-started.md) →
