HyperEVM

Provides on-chain DeFi operations (lending, borrowing, and token swapping) via an MCP server on Hyperliquid EVM.

typescript

0

GitHub Stars

typescript

Language

6 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "playainetwork-hyperevm-mcp": {
      "command": "npx",
      "args": [
        "hyperevm_mcp"
      ],
      "env": {
        "RPC_URL": "https://rpc.hypurrscan.io",
        "PRIVATE_KEY": "your_private_key_here"
      }
    }
  }
}

You can run the HyperEVM MCP server to interact with HyperLend protocol and Kittenswap DEX on the Hyperliquid EVM network. This MCP enables AI agents to perform DeFi operations such as lending, borrowing, and token swapping through a standardized server interface, with secure key handling and on-chain execution.

How to use

Set up your MCP client to connect to the HyperEVM MCP server described here. You will run a local MCP process or connect to a remote MCP endpoint, then issue high-level operations through the available endpoints or CLI tools. Use the provided tools to supply assets, borrow against collateral, repay debt, and swap tokens on Kittenswap DEX. Monitor your account state and view lending markets to plan your strategy. All actions happen on-chain through the Hyperliquid EVM network, using your configured private key and RPC URL.

How to install

Prerequisites: Node.js 18+ and a wallet with HYPE for gas fees.

Step 1: Install the MCP server package globally.

npm install -g hyperlend-mcp

Internal MCP configuration and run setup

Configure the MCP environment to run the HyperEVM MCP server using the recommended approach via npx.

{
  "mcpServers": {
    "hyperlend": {
      "command": "npx",
      "args": ["hyperevm_mcp"],
      "env": {
        "PRIVATE_KEY": "your_private_key_here",
        "RPC_URL": "https://rpc.hypurrscan.io" "[optional]"
      }
    }
  }
}

Environment setup options

Option A: Use npx (recommended) to run the MCP with a temporary environment configuration.

Option B: Create a .env file in your working directory with the following keys.

PRIVATE_KEY=your_private_key_here
RPC_URL=https://rpc.hypurrscan.io <optional>

Security and best practices

Keep your private key secure and never share it publicly. All transactions are executed on the Hyperliquid EVM network, and the MCP server runs locally or remotely as configured. The codebase is open and auditable.

Practical notes

You can operate HyperLend protocol actions (supply, withdraw, borrow, repay, account state, reserves) and Kittenswap DEX swaps through the MCP. Ensure your environment variables are correctly set before initiating any transactions to avoid failed calls or misrouted funds.

Network information

Network: Hyperliquid EVM Chain ID: 998 Native token: HYPE RPC URL: https://rpc.hypurrscan.io

Available tools

hyperlendSupply

Supply or lend assets to the HyperLend protocol to earn yield and enable borrowing.

hyperlendWithdraw

Withdraw supplied assets and accrued interest from HyperLend.

hyperlendBorrow

Borrow assets against supplied collateral with variable or stable rates.

hyperlendRepay

Repay borrowed debt to reduce debt burden.

hyperlendAccountState

Get a comprehensive overview of your account state, health factor, and borrowing capacity.

hyperlendGetReserves

View all available lending markets and their parameters.

kittenswapSwapTokens

Swap tokens on Kittenswap DEX with slippage protection and multi-pool support.