
Hyperlend
from PlayAINetwork
Enables AI agents to interact with the Hyperlend protocol.
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
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
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
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
npm install -g hyperlend-mcpBefore it works, you'll need: PRIVATE_KEYRPC_URL
Installation & Setup
1. Install globally
npm install -g hyperlend-mcp2. 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.
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 maxToken Swapping
# Swap HYPE for UBTC
kittenswapSwapTokens --tokenIn HYPE --tokenOut UBTC --amountIn 1.0 --slippageTolerance 3.0Requirements
- Node.js 18+
- Hyperliquid EVM wallet with HYPE for gas fees
- Private key for transaction signing
No common issues documented yet. If you hit a problem, the repository's GitHub Issues page is the best place to look.
Licensed under MITโ you can use, modify, and redistribute it under that license's terms.
License
MIT License - see LICENSE file for details.