Hyperliquid MCP Server
About
MCP server to fetch data from hyperliquid APIs
Details
- Transport
- SSE
- License
- MIT license
Explore
- Queries Hyperliquid open positions via MCP protocol.
- Exposes a single tool: get-hyperliquid-positions.
- Requires Node.js and Claude Desktop app.
- Works with any Hyperliquid wallet address.
- Fetches unrealized PnL data.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Hyperliquid MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
- Node.js installed on your system
- Claude Desktop app
- npm (Node Package Manager)
1. Open Claude Desktop app
2. Go to Claude menu → Settings → Developer → Edit Config
3. This will open your config file in Finder (on macOS)
4. 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.
4. Save the config file
5. Restart the Claude Desktop app
1. Ask Claude about your positions
2. Claude identifies the tool needed
3. Approve the tool usage
4. 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.
After configuration:
1. You'll see a hammer icon in the bottom right section of the chat input box
2. The MCP tool will be listed as "get-hyperliquid-positions"
3. You can ask Claude questions like:
"Can you tell me unrealised pnl for my position on hyperliquid for 0x7f3B192Ab3220940D66236792F3EBDB0e4E74138"
4. Claude will identify the appropriate tool and ask for your confirmation
5. Click "Allow" to execute the query
6. Claude will display the results of your query
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"hyperliquid mcp server": {
"hyperliquid": {
"command": "node",
"args": [
"/path/to/your/hyperliquid-mcp/dist/index.js"
]
}
}
}
}McpServers
{
"hyperliquid": {
"command": "node",
"args": [
"/path/to/your/hyperliquid-mcp/dist/index.js"
]
}
}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
1. Clone this repository:
git clone https://github.com/tomarsachin2271/hyperliquid-mcp.git
cd hyperliquid-mcp
2. Install dependencies:
npm install
3. 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
1. Open Claude Desktop app
2. Go to Claude menu → Settings → Developer → Edit Config
3. This will open your config file in Finder (on macOS)
4. 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.
4. Save the config file
5. Restart the Claude Desktop app
Using the Tool
After configuration:
1. You'll see a hammer icon in the bottom right section of the chat input box
2. The MCP tool will be listed as "get-hyperliquid-positions"
3. You can ask Claude questions like:
"Can you tell me unrealised pnl for my position on hyperliquid for 0x7f3B192Ab3220940D66236792F3EBDB0e4E74138"
4. Claude will identify the appropriate tool and ask for your confirmation
5. Click "Allow" to execute the query
6. Claude will display the results of your query
Example Usage
1. Ask Claude about your positions
2. Claude identifies the tool needed
3. Approve the tool usage
4. 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.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
