# Frequently Asked Questions (FAQ)
Quick answers to common questions about Hyperion MCP Server.
## General Questions
### What is Hyperion MCP Server?
Hyperion MCP Server is a Model Context Protocol (MCP) server that enables AI assistants like Claude to interact with the Hyperion blockchain testnet. It provides tools for wallet management, transactions, and smart contract deployment.
### What is the Model Context Protocol (MCP)?
MCP is a standard protocol developed by Anthropic that allows AI assistants to interact with external tools and data sources. It enables Claude and other AI assistants to perform actions beyond text generation.
### Is Hyperion MCP Server free to use?
Yes, Hyperion MCP Server is open source and free to use. The Hyperion testnet is also free, though you'll need testnet tokens (tMETIS) which can be obtained from the faucet.
### What blockchain does it support?
Currently, Hyperion MCP Server supports the Hyperion testnet (Chain ID: 133717). It's an Ethereum-compatible blockchain, so tools and contracts work similarly to Ethereum.
## Installation & Setup
### What are the system requirements?
- Node.js v18 or higher
- npm or yarn package manager
- 100MB free disk space
- Internet connection for blockchain access
### How do I get testnet tokens?
Visit the Hyperion testnet faucet at https://hyperion-testnet.metisdevops.link/faucet, enter your wallet address, and request tokens. They typically arrive within 1-2 minutes.
### Can I use this on mainnet?
The current version is designed for the Hyperion testnet. Using it on mainnet would require configuration changes and is not recommended without thorough testing and security audits.
### Do I need to run a blockchain node?
No, the MCP server connects to public RPC endpoints. You don't need to run your own node.
## Wallet & Security
### Where are my wallets stored?
Wallets are stored locally on your machine in encrypted format at `~/.hyperion-mcp/wallets/`. They never leave your device.
### Is it safe to store private keys in the MCP server?
The server stores encrypted wallet data locally. However, for production use with real funds, consider using hardware wallets or more secure key management solutions.
### What if I lose my mnemonic phrase?
If you lose your mnemonic phrase, you cannot recover your wallet. Always back up mnemonics securely in multiple locations.
### Can I use my existing MetaMask wallet?
Yes! You can import your MetaMask wallet using either:
- The private key (export from MetaMask)
- The mnemonic phrase (seed phrase)
### How do I export a wallet?
Currently, wallets can be exported by accessing the encrypted storage directly. Future versions may include export functionality. Always keep your original mnemonic phrase backed up.
## Transactions & Gas
### Why did my transaction fail?
Common reasons:
- Insufficient balance for gas
- Gas limit too low
- Invalid recipient address
- Network congestion
- Contract execution error
See [Troubleshooting](./troubleshooting.md) for detailed solutions.
### How much gas do I need?
Typical gas requirements:
- Native transfer: 21,000 gas
- ERC20 transfer: 50,000-70,000 gas
- ERC20 deployment: 800,000-1,200,000 gas
- ERC721 deployment: 1,200,000-2,000,000 gas
Always estimate gas before important transactions.
### Can I cancel a pending transaction?
Once submitted, transactions cannot be cancelled directly. However, you can replace a pending transaction by sending a new one with the same nonce and higher gas price.
### What is gas price?
Gas price is the amount you pay per unit of gas, measured in gwei (1 gwei = 0.000000001 tMETIS). Higher gas prices result in faster transaction confirmation.
## Tokens & Smart Contracts
### What token standards are supported?
- ERC20 (fungible tokens)
- ERC721 (NFTs)
Future versions may support ERC1155 and other standards.
### Can I deploy my own smart contract code?
Currently, the server deploys pre-compiled, audited contracts for ERC20 and ERC721. Custom contract deployment may be added in future versions.
### What's the difference between mintable and non-mintable tokens?
- **Mintable**: Owner can create additional tokens after deployment
- **Non-mintable**: Total supply is fixed at deployment
Choose based on your use case (e.g., mintable for rewards, non-mintable for fixed supply currencies).
### Can I verify my contracts on the explorer?
Yes, deployed contracts appear on the Hyperion testnet explorer. Verification (source code upload) may require manual steps depending on explorer features.
### How do I add metadata to my NFTs?
When minting NFTs, provide a `tokenURI` parameter pointing to JSON metadata. Common options:
- IPFS: `ipfs://QmXxx...`
- HTTP: `https://example.com/metadata/1.json`
## Integration
### Which AI assistants work with this?
- Claude Desktop (Anthropic)
- Cline (VS Code extension)
- Any MCP-compatible client
- Custom applications using MCP SDK
### Can I use this with ChatGPT?
ChatGPT doesn't currently support MCP. You would need to build a custom integration or use a different AI assistant.
### How do I integrate with my own application?
Use the MCP SDK to create a client that connects to the Hyperion MCP Server. See [Integration Guide](./integration-guide.md) for examples.
### Can multiple users share one MCP server instance?
The current version is designed for single-user use. Multi-user support would require additional authentication and wallet isolation features.
## Development
### Can I contribute to the project?
Yes! Contributions are welcome. Check the GitHub repository for:
- Open issues
- Feature requests
- Pull request guidelines
- Development setup instructions
### How do I report bugs?
Report bugs on GitHub Issues: https://github.com/cuongpo/hyperion-mcp-server/issues
Include:
- Steps to reproduce
- Expected vs actual behavior
- Error messages
- System information
### Is there a roadmap?
Check the GitHub repository for the project roadmap and planned features.
### Can I fork this for another blockchain?
Yes! The code is open source (MIT License). You can fork and adapt it for other EVM-compatible blockchains by changing the RPC URL and chain ID.
## Troubleshooting
### The server won't start
1. Check Node.js version: `node --version` (need v18+)
2. Reinstall dependencies: `npm install`
3. Rebuild: `npm run build`
4. Check for error messages in console
### Tools don't appear in Claude
1. Verify configuration file path
2. Check JSON syntax is valid
3. Use absolute paths
4. Restart Claude Desktop completely
### Transactions are very slow
- Network may be congested
- Try increasing gas price
- Check network status
- Wait for off-peak hours
### I can't see my tokens in MetaMask
Add the token contract address to MetaMask:
1. Open MetaMask
2. Click "Import tokens"
3. Enter contract address
4. Token should appear
For more issues, see [Troubleshooting](./troubleshooting.md).
## Support
### Where can I get help?
- **Documentation**: Read the full docs
- **GitHub Issues**: Search or create issues
- **Community**: Join Discord/Telegram (if available)
- **Examples**: Check [Examples](./examples.md)
### Is there commercial support available?
Check the GitHub repository or contact the maintainers for information about commercial support options.
---
**Still have questions?** Check the [Troubleshooting Guide](./troubleshooting.md) or open an issue on GitHub.
