HyperEVM MCP
A Model Context Protocol server for interacting with HyperLend protocol and Kittenswap DEX on Hyperliquid EVM network. This MCP enables AI agents to perform DeFi operations including lending, borrowing, and token swapping.
Features
HyperEVM Protocol
- Supply/Lend: Deposit assets to earn lending yield and enable borrowing capacity
- Withdraw: Retrieve supplied assets and accrued interest
- Borrow: Borrow assets against supplied collateral with variable or stable rates
- Repay: Repay borrowed debt to reduce debt burden and improve health factor
- Portfolio Management: Comprehensive account state and position tracking
- Market Data: View all available lending markets and their parameters
Kittenswap DEX
- Token Swapping: Automated token swaps with slippage protection
- Multi-Pool Support: Support for different tick spacings and pool configurations
- Native Token Support: Seamless HYPE (native) and wrapped token handling
Supported Tokens
- HYPE - Native Hyperliquid token
- WHYPE - Wrapped HYPE
- wstHYPE - Wrapped Staked HYPE
- UBTC - Bitcoin on Hyperliquid
- UETH - Ethereum on Hyperliquid
- USDe - Ethena USDe stablecoin
- USDT0 - Tether USD
- sUSDe - Staked USDe
Installation & Setup
1. Install globally
npm install -g hyperlend-mcp
2. Set up environment variables
Using npx (recommended)
{
"mcpServers": {
"hyperlend": {
"command": "npx",
"args": ["hyperevm_mcp"],
"env": {
"PRIVATE_KEY": "your_private_key_here",
"RPC_URL": "https://rpc.hypurrscan.io" "[optional]"
}
}
}
}
Option C: Create .env file
Create a .env file in your working directory:
PRIVATE_KEY=your_private_key_here
RPC_URL=https://rpc.hypurrscan.io <optional>
⚠️ Security Note: Keep your private key secure and never share it publicly.
Available Tools
HyperLend Protocol Operations
hyperlendSupply
Supply/lend assets to HyperLend protocol
- Parameters: token, amount, onBehalfOf (optional)
- Example: Supply 100 USDT0 to earn lending yield
hyperlendWithdraw
Withdraw supplied assets and accrued interest
- Parameters: token, amount ('max' for full withdrawal), to (optional)
- Example: Withdraw all supplied WHYPE
hyperlendBorrow
Borrow assets against supplied collateral
- Parameters: token, amount, interestRateMode (variable/stable), onBehalfOf (optional)
- Example: Borrow 0.5 UETH against WHYPE collateral
hyperlendRepay
Repay borrowed debt
- Parameters: token, amount ('max' for full repayment), interestRateMode, onBehalfOf (optional)
- Example: Repay all UBTC debt
hyperlendAccountState
Get comprehensive account overview
- Parameters: userAddress (optional), detailed (boolean)
- Returns: Complete position data, health factor, borrowing capacity
hyperlendGetReserves
View all available lending markets
- Parameters: detailed (boolean)
- Returns: All supported tokens and their lending parameters
Kittenswap DEX Operations
kittenswapSwapTokens
Swap tokens on Kittenswap DEX
- Parameters: tokenIn, tokenOut, amountIn, amountOutMinimum (optional), tickSpacing, slippageTolerance, deadline (optional)
- Example: Swap 10 WHYPE for UBTC with 3% slippage tolerance
Usage Examples
Basic Lending Flow
# 1. Supply WHYPE as collateral
hyperlendSupply --token WHYPE --amount 100
# 2. Borrow USDT0 against collateral
hyperlendBorrow --token USDT0 --amount 50
# 3. Check account health
hyperlendAccountState --detailed true
# 4. Repay debt
hyperlendRepay --token USDT0 --amount max
# 5. Withdraw collateral
hyperlendWithdraw --token WHYPE --amount max
Token Swapping
# Swap HYPE for UBTC
kittenswapSwapTokens --tokenIn HYPE --tokenOut UBTC --amountIn 1.0 --slippageTolerance 3.0
Network Information
- Chain: Hyperliquid EVM (Chain ID: 998)
- RPC URL: https://rpc.hypurrscan.io
- Native Token: HYPE
- HyperLend Protocol: Aave V3 fork optimized for Hyperliquid
- Kittenswap: Uniswap V3 fork for Hyperliquid
Requirements
- Node.js 18+
- Hyperliquid EVM wallet with HYPE for gas fees
- Private key for transaction signing
Security
- Your private key stays local and is never shared
- All transactions happen on-chain via Hyperliquid EVM network
- Open source and auditable code
- Built on battle-tested Aave V3 and Uniswap V3 protocols
Support
For issues and questions:
- GitHub Issues: https://github.com/PlayAINetwork/hyperlend-mcp/issues
- Documentation: Check the inline tool descriptions for detailed parameter information
License
MIT License - see LICENSE file for details.
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.