hyperliquid-mcp
If you are the rightful owner of hyperliquid-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
The Hyperliquid MCP Server is a Node.js implementation that allows querying of Hyperliquid open positions via MCP clients like the Claude Desktop app.
Hyperliquid MCP Server
This project implements a Model Context Protocol (MCP) server in Node.js that allows you to query your Hyperliquid open positions. The server exposes a tool that can be accessed from MCP clients like the Claude Desktop app.
Overview
The MCP server provides a tool named get-hyperliquid-positions that allows Claude to fetch unrealized PnL and position information for any Hyperliquid wallet address. This integration enables seamless interaction between Claude and your Hyperliquid trading data.
Prerequisites
- Node.js installed on your system
- Claude Desktop app
- npm (Node Package Manager)
Building the Project
- Clone this repository:
git clone https://github.com/tomarsachin2271/hyperliquid-mcp.git
cd hyperliquid-mcp
- Install dependencies:
npm install
- Build the project:
npm run build
This will generate the dist/index.js file that will be used by the MCP server.
Configuring Claude Desktop
- Open Claude Desktop app
- Go to Claude menu → Settings → Developer → Edit Config
- This will open your config file in Finder (on macOS)
- Add the following configuration to the file:
{
"mcpServers": {
"hyperliquid": {
"command": "node",
"args": [
"/path/to/your/hyperliquid-mcp/dist/index.js"
]
}
}
}
Replace /path/to/your with the actual path to your project directory.
- Save the config file
- Restart the Claude Desktop app
Using the Tool
After configuration:
- You'll see a hammer icon in the bottom right section of the chat input box
- The MCP tool will be listed as "get-hyperliquid-positions"
- You can ask Claude questions like:
"Can you tell me unrealised pnl for my position on hyperliquid for 0x7f3B192Ab3220940D66236792F3EBDB0e4E74138" - Claude will identify the appropriate tool and ask for your confirmation
- Click "Allow" to execute the query
- Claude will display the results of your query
Example Usage
- Ask Claude about your positions
- Claude identifies the tool needed
- Approve the tool usage
- Get your position information directly in the chat
This seamless integration allows you to quickly access your Hyperliquid trading information through natural conversation with Claude.
